Defame1297
9457efff36
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>
33 lines
2.0 KiB
Markdown
33 lines
2.0 KiB
Markdown
# 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)
|