Skip to content

Move blueprint writing rules into their own skill - #201

Merged
thrawn01 merged 1 commit into
mainfrom
thrawn01/eng-591-move-blueprint-writing-rules-into-their-own-skill
Oct 30, 2026
Merged

thrawn01 merged 1 commit into
mainfrom
thrawn01/eng-591-move-blueprint-writing-rules-into-their-own-skill

Conversation

@thrawn01

Copy link
Copy Markdown
Contributor

Purpose

An agent that only needs to write or update a blueprint had to load dispatch:design (a whole design conversation) or dispatch:design-review (a whole review), and neither held all the rules. They now live in one skill:

Load `dispatch:blueprint` with the Skill tool.

Design and design-review load it where they used to state the rules. This is an extraction. No rule or outline section was added, dropped or changed in meaning.

Implementation

  • New skills/blueprint/SKILL.md with the outline, saving rules, PII, TODO: and [NEEDS CLARIFICATION: ...] markers, run records, the domain-boundary statement, the OpenAPI second document and spec check, Glossary changes, the unnumbered ADR: <title> section, and the read-and-patch rules with the Decision Log entry for review answers.
  • skills/design/SKILL.md loads dispatch:blueprint at Start; its "Write the blueprint" section now points to it and keeps the draft-save cadence.
  • skills/design-review/SKILL.md loads it at the top; its reading, glossary, ADR and contract steps point to it.
  • CONTEXT-FORMAT.md stays in skills/design/; the new skill links ../design/CONTEXT-FORMAT.md, so the three existing links are unchanged.

Calls on the borderline text:

  • Kept in design: the three-flag stop on [NEEDS CLARIFICATION: ...], draft saving after each phase, the domain-boundary checks.
  • Kept in design-review: the scratchpad blueprint.md copy for sub-agents, offering an ADR, duh lint, "add nothing for dismissed findings". Soft-flag consumers (Pre-work, Phase 4) still spell out the marker.
  • Added lines (the only new prose): the one-line summary of what a blueprint is, "Drafts ... can be saved whole. A blueprint saved before your session is changed only by patch" (resolves design's draft saves against review's never-push-whole rule), "When reviewing a saved blueprint" before the Decision Log entry, short glosses for "contract sketch" and "working tree", and a longer description.
  • Not changed, per the ticket: skills/design-adr-audit/SKILL.md and skills/design-fit-review/SKILL.md also restate the scratchpad-copy rule.

Verification

make test passes. No evals were run, as asked. A fresh sub-agent loaded anthropic-skills:skill-creator and reviewed the skill without test prompts. I fixed what it found: design-review lacked a load line, the patch-only rule reached design's draft saves, the Decision Log entry was not scoped to review, "soft flags" was undefined, and the description under-triggered. Perspectives not used: a second independent lens on rule-meaning drift.

Suggestions from the review that change a rule, left for you: say which section a run's record goes in; place "We considered X but chose Y because Z" in the Decision Log; Pieces (added by breakdown) is not in the outline.

Fixes ENG-591

@thrawn01
thrawn01 merged commit 493a086 into main Oct 30, 2026
2 checks passed
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.

1 participant