Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity

docs: issue 0016 — skill implementation workflow grill

Browse Source 
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>
This commit is contained in:
Defame1297
2026-05-17 16:21:38 +00:00
parent a1f1f9ded8
commit c705a38809
19 changed files with 393 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/issues/0016-skill-workflow-grill.md
View File

@@ -21,11 +21,30 @@ 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
- [x] Grill session completed covering all topics above
- [x] `docs/notes/skill-implementation-workflow.md` written with the agreed working conventions
- [x] `docs/prd/chunk-3-skills-library.md` updated with any decisions that change or extend the Implementation Decisions section
- [x] Issues 0017–0028 updated with specific acceptance criteria derived from the grill output
- [x] **HITL:** human participates in grill, reviews conventions, and approves before implementation of any skill begins
## Handoff
**Status:** complete
**Files produced:**
- `docs/notes/skill-implementation-workflow.md`
**Key decisions:**
- Step 6 (session handoff) added post-grill: each skill session closes by appending a `## Handoff` section to the skill's issue file. Cross-cutting observations go to `LESSONS.md` immediately, not batched to chunk end.
- Handoff artifact is the issue file, not a separate `docs/notes/` file — avoids proliferating per-skill note files.
**Open threads:**
- `when:` full bidirectional reference convention — deferred to Chunk 4
- PRD/issue template scope — refined during 0019/0020 implementation
- Merging `zoom-out` into architect role — revisit at Chunk 5 grill
**Next session start:**
- Load: `CONTEXT.md`, `docs/notes/skill-implementation-workflow.md`, issue 0017 or 0018
- First action: Step 1 (source discovery) for `write-eval`
## Blocked by