Claude Code Instructions for bbum.github.io

Claude Code Instructions for bbum.github.io

Commit Messages

Keep commit messages simple - just bullet points of what changed:

- Added new post about topic
- Fixed typo in about page
- Updated stylesheet

No “Generated by Claude” footers, no co-author lines, no emoji, no fluff.

Dates

ALWAYS check the current date before creating posts. Do NOT assume the year is 2024. Use:

date +%Y-%m-%d

File Search

Prefer mdfind over find or grep for file discovery:

mdfind -onlyin . 'kMDItemFSName == "*.md"'
mdfind -onlyin . 'kMDItemTextContent == "*search term*"'

Site Structure

_layouts/       # default.html, post.html
_includes/      # header.html, footer.html
_posts/         # YYYY-MM-DD-title.md
assets/css/     # style.scss

Posts

• All posts go in _posts/ as YYYY-MM-DD-title.md
• Use layout: post
• Flickr embeds: just the <a data-flickr-embed> tag, script is in footer
• No need to include the Flickr script in posts

Adding Links

When asked to add a link to the site (e.g., to Laser Resources), visit the URL first to determine:

• What section it belongs in
• An appropriate description

Don’t ask the user for this info if it can be determined from the site itself.

Constraints

• GitHub Pages compatible only (no custom plugins)
• No Node.js, no Ruby gems beyond GitHub’s defaults
• Keep HTML/CSS minimal and readable