LLM-Assisted Dev — Claude Code

Tool: Claude Code CLI — filesystem read/write, shell execution, git branch + PR creation.

Features Built

Month-grouped nav sidebar

Before: flat post list.
After: Medium-style month headers, posts nested below, newest first.

Implementation:

• Added date frontmatter field to all posts (rather than parsing from titles — more robust)
• Added postsByDate Eleventy collection sorted descending by date
• Added monthYear filter (date.getUTCMonth() + year — UTC to avoid timezone shifts)
• Nav template loops collection, emits <div class="nav-month"> on month change

Files changed: base.njk, .eleventy.js, style.css, all post frontmatters.

Post footer with publication date

Change: subtle footer on each post — partial-width horizontal rule, date centered below.

Timezone bug: getDate() interpreted UTC date in local time, rendering Sep 21 post as Sep 20. Fixed with getUTCDate() — consistent with the monthYear filter.

Gitignore trap: agent placed post-scaffold helper script in ai_gen/ (gitignored, labeled "throwaway"). Caught before merge; moved to scripts/ since a fresh clone would be missing it. The instructions said "throwaway scripts" — ambiguous enough that the agent followed the letter but missed the intent.

CLAUDE.md Observations

Instructions cover: stack, directory layout, git workflow (no direct pushes, always PRs), build commands, post format convention, backlog via GitHub Issues.

Working consistently:

• PR workflow — every change on a branch, no direct pushes to main
• npm run build + commit docs/ without reminders
• gh issue list checked when backlog mentioned; Closes #N in PR descriptions
• Branch naming: feature/, post/, fix/

Needed reinforcement:

• ai_gen/ section said "throwaway scripts" but didn't say "nothing important goes here" — agent placed useful tooling there
• "Commit build output" didn't explicitly include "run git status after build" — occasional missed untracked files

Candidates to add: explicit .gitignore check before creating new directories; local test step before commit; concrete commit message examples.