Defame1297
c705a38809
Produces docs/notes/skill-implementation-workflow.md with agreed conventions for all Chunk 3 skill issues (0017–0028). Key decisions: - Per-skill process: source discovery (sub-agent) → source review with licence/security check (sub-agent) → conflict check vs constitution + factory principles (sub-agent) → synthesis grill → co-write iteratively - Bootstrap: write-eval (hand-written) → write-skill (hand-written) → write-docs (first factory-authored, phase 2 of 0018) → everything else - Upstream review changed from per-chunk-start to per-skill - `when:` and `references:` frontmatter fields added to authoring standard - Sub-agent usage prescribed as named steps in the workflow - HITL: human reviewed and approved conventions Updates: PRD implementation decisions; issues 0016–0028 with specific acceptance criteria; docs/spec/overview.md; ROADMAP Chunk 3 housekeeping note (bootstrap order, cadence, acceptance criteria status); CONTEXT.md Source field (per-skill cadence, references: companion field); LESSONS.md with three patterns from the grill session. Post-grill additions (same session): Step 6 (session handoff) added to the workflow; handoff section appended to issue 0016; handoff checklist item added to Chunk 3 closure issue (0028). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
0028 — Chunk 3 closure: update skills-index, update spec, behavioral tests
Type: HITL
Parent PRD: docs/prd/chunk-3-skills-library.md
What to build
Close out Chunk 3 once all 42 skills are complete: update the skills index to reflect the implemented state, update the living spec, and run the full behavioral acceptance test suite.
Tasks:
- Update
docs/research/ai-coding-factory/ai-coding-factory-skills-index.md— replace the pre-implementation build reference with the as-implemented state: actual flat skill names, categories, trigger descriptions as deployed, any deviations from the original index noted - Update
docs/spec/overview.md— reflect the full 42-skill library as the current deployed state; remove "Chunk 3 target" language; mark Chunk 3 ✅ complete - Update
docs/spec/architecture.md— reflect the.agents/evals/directory structure added in Chunk 3; any other structural changes from implementation - Update
docs/ROADMAP.md— mark Chunk 3 ✅ complete in the chunk table - Run behavioral acceptance tests — for each skill, invoke with its trigger phrase in a fresh Claude session and verify the output meets the authoring standard; document results
Behavioral test scope: All 42 skills (including write-eval, write-skill, and the 4 preserved skills). The caveman skill is exempt — it has no content-generating behavior to verify.
LESSONS.md: Extract any cross-session learnings from Chunk 3 implementation and add entries per the LESSONS.md format. Three or more observations on the same pattern graduate to the relevant standing file.
6. Review docs/notes/skill-implementation-workflow.md — verify the conventions are still accurate; update any entries that changed during implementation.
Acceptance criteria
docs/research/ai-coding-factory/ai-coding-factory-skills-index.mdupdated to reflect as-implemented state; deviations from original plan noteddocs/spec/overview.mdupdated; Chunk 3 marked ✅ complete; all 42 skills listed as deployeddocs/spec/architecture.mdupdated with.agents/evals/structuredocs/ROADMAP.mdChunk 3 row updated to ✅- Behavioral test run completed; all skills pass their trigger test; failures documented as issues for resolution
LESSONS.mdupdated with Chunk 3 observationsdocs/notes/skill-implementation-workflow.mdreviewed and updated to reflect any workflow changes discovered during Chunk 3- All skill issues (0017–0027) have a
## Handoffsection with statuscomplete - HITL: human verifies the complete skills library in a fresh session before marking Chunk 3 done
Blocked by
- 0020 (design skills)
- 0021 (implement skills)
- 0022 (test skills)
- 0023 (review skills)
- 0024 (deploy skills)
- 0025 (operate skills)
- 0026 (IaC skills)
- 0027 (cross-cutting skills)