upfront-design
When the user wants a design agreed before coding, a draft resumed, or an approved milestone checked.
- License 许可
- MIT
- 最近更新
- 2026-11-10
- Stars
- ★ 6
- Forks
- 0
01 前言 Front Matter
- name
- upfront-design
- description
- When the user wants a design agreed before coding, a draft resumed, or an approved milestone checked.
02 资源文件 3
- 参考文档references/check.md1003 B
- 参考文档references/decisions.md700 B
- 参考文档references/design.md1.4 KB
03 SKILL.md 正文
Upfront design
Route and persistence
A design has request/status frontmatter and a # Design: title.
New request → design; draft → first missing section; approved → check next
open milestone; another status → BLOCKED. A named revision phase removes
later sections only after the user authorizes that revision.
Resolve this skill's absolute anchor. Store new designs at
<anchor>/designs/<basename>-<slug>-<YYYY-MM-DD-HHmmss>.md, outside repos.
<basename> is the first repo's root directory name.
After a path exists, persist approved phases and the ledger through sibling
temporary files and atomic rename before advancing. Record
request | size | design | phase | approvals | ADR offers | terminal.
Keep the ledger at <design>.ledger on AWAITING_USER; remove on other terminals.
Small means one module, no contract/data/public-signature change, and a
one-sentence outcome. Return DIRECT plus that sentence without a file/ledger.
Otherwise find ADR trees (docs/adr/, adr/, doc/adr/, docs/decisions/);
absence is silent. Create the document using references/design.md.
Done when route, size, path/frontmatter, and relevant ADRs are fixed.
Design phases
Each phase pauses with AWAITING_USER; write its approved content before
the next starts. Resume at the first missing or explicitly revised phase.
- Product: concrete pain, measurable Success, bold one-line solution, supplied mockup or draft text wireframe/state table for user-facing work, delivery paragraph. Ask the entire question frontier in one numbered round, recommending an answer per question. Done when approved content is persisted.
- System: bold shape + cited pattern, NEW/CHANGED layer roles, sources and constraints with cost reasons, phase-banded sequence. Name ADR conflicts, not overrides. Done when approved content is persisted.
- Program: changed boundary contracts, constraints, real signatures,
usage, and roles, not bodies. Cite patterns or assumptions; compare two
uncertain layouts, choose one, and record why the other lost.
For multiple boundaries, changed dispatch, or unclear async order,
apply Wiring views in
references/design.md. Done when each Success maps to symbols/results and approval is persisted. - Slices: after prefactoring, start with a thin end-to-end contract/check. One reviewable vertical PR per milestone; name symbols, expected success and relevant failures, assertions/manual proof, repo order, and one open checkbox. Only the user defers/skips; wide refactors expand then contract. Done when every symbol is assigned and approved milestones are persisted.
- Finalize: set approved. Offer ADRs only for decisions hard to reverse,
surprising without context, and chosen over a real alternative. On approval
use
references/decisions.md. Done withDESIGNEDwhen all five document sections exist and each ADR offer is written or declined. Report design/ADR paths, peer-review, and milestone check route.
Check
For an approved design, follow references/check.md for the first open,
non-deferred/non-skipped milestone. Show exact commands and obtain approval
before running them. Tick only with outcome proof and matching symbols,
not a successful exit. Open manual boxes or ambiguous legacy outcomes pause.
Never edit product files to make a check pass. Done with CHECKED if ticked
or all complete, otherwise AWAITING_USER.
Terminals: DIRECT (router no-op success), AWAITING_USER, DESIGNED,
CHECKED, BLOCKED. Revise via draft status and a named phase.
04 同仓库更多 Skills
use-skill
When the user gives a GitHub link to a skill and wants it run without installing it.
todoist-task
When the user wants a Todoist task created, or shown before it is created.
restate
When the user wants the last reply said again in plain words, wants a catch-up since their last message, or wants the decision they need to make.
recon
When the user wants this repository's saved map read, created, or refreshed.
prath-mode
When the user wants a goal sent to one skill or one delivery chain.
peer-review
When the user asks whether a plan, a design, or a proposed change is ready to build.