Skip to content

Extract subagent-facing prose from SKILL.md into bundled templates - #30

Merged
jirispilka merged 1 commit into
mainfrom
restructure-skill-templates-27
Aug 20, 2026
Merged

Extract subagent-facing prose from SKILL.md into bundled templates#30
jirispilka merged 1 commit into
mainfrom
restructure-skill-templates-27

Conversation

@jirispilka

Copy link
Copy Markdown
Collaborator
  • What: Split SKILL.md by audience per Restructure SKILL.md: extract subagent-facing prose into bundled template files #27: relay-only prose moved to templates/{standing-checks,design,formats}.md (pasted into dispatch prompts by path, same convention as ../_vendored/ engines); the role table is routing-only; the three wayfinder borrowings (fog test, "an index, not a store", HITL hard-rule sentence) folded in. SKILL.md: 480 → 442 lines; the 500-line cap is unchanged by explicit decision.
  • Why: Editing a reviewer check or output format churned the orchestrator spec against its line cap; contract tests couldn't tell "moved" from "gone". Tests now load each template as its own constant and pin content where it lives, plus new pins (paths named in SKILL.md, no template-to-template references, no ## architect section in formats.md).
  • Notes: Full suite: 112 tests, all green on a clean tree; a local tree with an active shepherd run trips test_repo_does_not_duplicate_shipped_config_files via the run's own .shepherd/config.json (accepted exception, follow-up below). Fulfillment 19/20 MET + accepted exception; reviewed by staff-review, thermonuclear, ponytail-review to zero findings. {role.format} pastes a role's formats.md section; whether the ## heading line rides along is deliberately unpinned — either reading works.

Follow-ups:

Closes #27

🤖 Generated with Claude Code

@jirispilka
jirispilka merged commit 9c0bbe1 into main Aug 20, 2026
2 checks passed
@jirispilka
jirispilka deleted the restructure-skill-templates-27 branch August 20, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Restructure SKILL.md: extract subagent-facing prose into bundled template files

2 participants