Problem
Every project started with AI assistance needs a local .claude/CLAUDE.md but there's no standard starting point. Engineers copy-paste from memory or skip it entirely, losing stack/convention context for agents.
Solution
Add config/claude/project-CLAUDE.md.template with sections:
# Project: <name>
## Stack
- Language/runtime:
- Package manager: (bun | pnpm | npm | uv | cargo)
- Test runner:
- Lint/format:
## Conventions
- (e.g. "component files in src/components/, one component per file")
- (e.g. "all DB queries go through lib/db.ts, never raw SQL in routes")
## Off-limits
- (files/dirs agents should never modify without explicit ask)
## Key commands
- Test:
- Lint:
- Build:
- Dev server:
install.sh addition
Print a reminder after install: "Run cp ~/.shell-config/config/claude/project-CLAUDE.md.template .claude/CLAUDE.md to scaffold agent context for this project."
Also consider
knip should be added as a local dev dep per project (bun add --dev knip) — add to the template's setup notes
Problem
Every project started with AI assistance needs a local
.claude/CLAUDE.mdbut there's no standard starting point. Engineers copy-paste from memory or skip it entirely, losing stack/convention context for agents.Solution
Add
config/claude/project-CLAUDE.md.templatewith sections:install.sh addition
Print a reminder after install: "Run
cp ~/.shell-config/config/claude/project-CLAUDE.md.template .claude/CLAUDE.mdto scaffold agent context for this project."Also consider
knipshould be added as a local dev dep per project (bun add --dev knip) — add to the template's setup notes