Claude Commands

Custom Claude Code slash commands live in .claude/commands/ (one .md file per command) and are shared through git. They are prompts run by Claude Code, not build scripts.

/question <text>

Logs an open client question into doc/questions-client.md (created on first use) as an unchecked checklist item, so it isn't lost during the session.

/question Should the logo sit on a transparent background?

/snapshot <page|partial>

Freezes the current state of a page or partial as a numbered variant in src/_variants/. Pages are also linked in the index.html hub; partials are kept as a preserved source copy under src/_variants/partials/. Element/component targets are planned for v2.

/snapshot accueil     // freezes src/accueil.html → src/_variants/accueil-02.html + hub link
/snapshot navbar      // freezes the partial → src/_variants/partials/navbar-01.html

/clean [path]

Reports dead code (unused partials, JS, likely-unused CSS), commented-out blocks, verbose comments and duplicate attributes on a tag, then cleans up after approval. It never deletes SCSS on suspicion alone.

/clean                // scans src/
/clean src/partials   // scopes the scan

/session start | note <text> | end

The session workflow (see below). start resumes context, note jots a durable note, end writes the session log.

/session start
/session note Homepage hero redesigned; open question on the CTA color
/session end

Session workflow

/clear wipes Claude's memory — only what is on disk (git and files) survives. Because tasks between clears are often not committed (commits group larger chunks of work), the durable per-task record is /session note, not git history.

start · note · end

/session start

On a session start or a handoff: reads the session index, the latest session file, open client questions and any in-progress draft, then summarizes where things stand.

/session note <text>

Records what was done / decided / left open for the sub-task you just finished, before you /clear. Accumulates in doc/sessions/_draft.md (committed, so it survives a clear and travels on handoff).

/session end

Closes the session: gathers the draft and git changes, writes the detailed doc/sessions/AAMMJJ-…md plus the index line, and clears the draft.

// typical flow
/session start                       // resume where you left off
… work on a task …
/session note What was done + decisions   // before /clear
/clear                               // wipes memory; the note persists
… next task, repeat …
/session end                         // close and write the session log