claude-md-starter

Claude.md Starter — Project Context Generator

Scans the repo, infers the tech stack and conventions, asks at most 3 targeted questions, and writes a populated CLAUDE.md that gives Claude full project context from session one.

Invocation Triggers

Explicit:

• "create a CLAUDE.md"
• "my CLAUDE.md is blank"
• "generate project context"
• "initialize CLAUDE.md"
• "set up Claude context for this repo"
• "fill in my CLAUDE.md"
• "run the claude-md-starter skill"

Implicit:

• User pastes a near-empty CLAUDE.md and asks Claude to populate it
• User keeps re-explaining the same project context at the start of sessions

Run immediately when triggered — no upfront questions before scanning.

Workflow (6 Nodes)

Node	Role
1 — Detect	Check if CLAUDE.md exists and measure content length
2 — Scan	Read signal files from the project root (see references/scan-signals.md)
3 — Infer	Draft all sections that can be derived from scanned signals
4 — Grill-me	Ask at most 3 questions for what cannot be inferred
5 — Generate	Write the full CLAUDE.md using the template in references/claude-md-template.md
6 — Validate	Confirm required sections are present and non-placeholder

Node 1 — Detect

Check for CLAUDE.md at the project root.

If not found: Proceed directly to Node 2.

If found and has ≤ 200 characters: Treat as blank — proceed to Node 2.

If found and has > 200 characters: Run the diff-and-merge flow before writing:

1. Read the existing file

2. Complete Nodes 2–4 to produce the generated version

3. Compare section by section — for each of the 8 required sections, classify as:

   • NEW — exists in generated, absent or empty in existing
   • ENHANCED — both versions have content; generated version adds more
   • SAME — both versions have equivalent content
   • CONFLICT — both versions have different non-empty content

4. Present a diff summary table:

Section              | Existing | Generated | Action
---------------------|----------|-----------|-------
Project Overview     | present  | enhanced  | +additions available
Tech Stack           | absent   | new       | will add
Commands             | present  | enhanced  | +2 commands found
Architecture         | absent   | new       | will add
Code Conventions     | present  | same      | no change
Testing              | absent   | new       | will add
What NOT To Do       | absent   | new       | will add
Environment Setup    | absent   | new       | will add