Files
holocron/docs/issues/0016-skill-workflow-grill.md
Defame1297 9457efff36 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>
2026-05-17 15:18:36 +00:00

2.0 KiB
Raw Blame History

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)