Skip to content

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

Open
jirispilka wants to merge 1 commit into
mainfrom
restructure-skill-templates-27
Open

Extract subagent-facing prose from SKILL.md into bundled templates#30
jirispilka wants to merge 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

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