29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
# Lead Programmer — Agent Memory
|
|
|
|
## Skill Authoring Conventions
|
|
|
|
### Frontmatter
|
|
- Fields: `name`, `description`, `argument-hint`, `user-invocable`, `allowed-tools`
|
|
- Read-only analysis skills that run in isolation also carry `context: fork` and `agent:`
|
|
- Interactive skills (write files, ask questions) do NOT use `context: fork`
|
|
- `AskUserQuestion` is a usage pattern described in skill body text — it is NOT listed
|
|
in `allowed-tools` frontmatter (no existing skill does this)
|
|
|
|
### File Layout
|
|
- Skills live in `.claude/skills/<name>/SKILL.md` (subdirectory per skill, never flat .md)
|
|
- Section headers use `##` for phases, `###` for sub-sections
|
|
- Phase names follow "Phase N: Verb Noun" pattern (e.g., "Phase 1: Find the Story")
|
|
- Output format templates go in fenced code blocks
|
|
|
|
### Known Canonical Paths (verify before referencing in new skills)
|
|
- Tech debt register: `docs/tech-debt-register.md` (NOT `production/tech-debt.md`)
|
|
- Sprint files: `production/sprints/`
|
|
- Epic story files: `production/epics/[epic-slug]/story-[NNN]-[slug].md`
|
|
- Control manifest: `docs/architecture/control-manifest.md`
|
|
- Session state: `production/session-state/active.md`
|
|
- Systems index: `design/gdd/systems-index.md`
|
|
- Engine reference: `docs/engine-reference/[engine]/VERSION.md`
|
|
|
|
### Skills Completed
|
|
- `story-done` — end-of-story completion handshake (Phase 1-8, writes story file)
|