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>
2.0 KiB
2.0 KiB
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.mdwritten with the agreed working conventionsdocs/prd/chunk-3-skills-library.mdupdated 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)