docs: Chunk 3 issues 0015-0028 and doc updates
14 issues created covering AGENTS.md refactor prerequisite, skill implementation workflow grill, bootstrap skills (write-eval, write-skill), remaining factory skills, and one issue per skill category group through to chunk closure. All HITL; acceptance criteria for 0017-0028 to be refined after 0016 grill session. Doc updates: CONTEXT.md PRD/issue scope clarified (HOW distribution across architecture-review and issue design notes); ROADMAP.md housekeeping updated with bootstrap order and issue range; spec/overview.md recent changes entry added; PRD updated (skills-index: delete → update). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
32
docs/issues/0016-skill-workflow-grill.md
Normal file
32
docs/issues/0016-skill-workflow-grill.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# 0016 — Second grill: skill implementation workflow
|
||||
|
||||
**Type:** HITL
|
||||
**Parent PRD:** `docs/prd/chunk-3-skills-library.md`
|
||||
|
||||
## What to build
|
||||
|
||||
Run a dedicated grill session on the general skill implementation workflow before any skill is written. The PRD identifies this as the first issue after the AGENTS.md prerequisite — the grill produces the working conventions applied to all subsequent skill issues (0017–0028).
|
||||
|
||||
The grill covers:
|
||||
- Per-skill process steps: trigger-first, eval-first, upstream review, source: field population
|
||||
- How the `factory/write-eval`-first bootstrap works in practice (hand-written eval for write-eval itself; write-eval used for all subsequent skills)
|
||||
- Working conventions for refactors (existing Pocock skills) vs new skills
|
||||
- How to handle a skill that combines patterns from multiple upstream sources
|
||||
- The upstream review process at chunk start: what to check, what to record, how to decide whether to pull changes in
|
||||
- Any open questions from the PRD flagged as "refine during implementation" (PRD/issue template scope, bidirectional reference convention in skill frontmatter)
|
||||
|
||||
Output is documented in `docs/notes/skill-implementation-workflow.md`, used to update `docs/prd/chunk-3-skills-library.md` with any decisions made, and used to refine issues 0017–0028 with specific acceptance criteria.
|
||||
|
||||
HITL: requires human participation in the grill session.
|
||||
|
||||
## Acceptance criteria
|
||||
|
||||
- [ ] Grill session completed covering all topics above
|
||||
- [ ] `docs/notes/skill-implementation-workflow.md` written with the agreed working conventions
|
||||
- [ ] `docs/prd/chunk-3-skills-library.md` updated with any decisions that change or extend the Implementation Decisions section
|
||||
- [ ] Issues 0017–0028 updated with specific acceptance criteria derived from the grill output
|
||||
- [ ] **HITL:** human participates in grill, reviews conventions, and approves before implementation of any skill begins
|
||||
|
||||
## Blocked by
|
||||
|
||||
- 0015 (AGENTS.md refactor must be complete so grill references stable file structure)
|
||||
Reference in New Issue
Block a user