plan
Open a dossier and write its plan with the operator, then get it checked by a fresh agent before any build. Invoke when the user says "ds:plan", "start a dossier", "plan this", "grill me" in a repo with `.scratchpad/dossier/`, or when work needs more than one commit.
- License 许可
- ISC
- 最近更新
- 2026-11-15
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- plan
- description
- Open a dossier and write its plan with the operator, then get it checked by a fresh agent before any build. Invoke when the user says "ds:plan", "start a dossier", "plan this", "grill me" in a repo with `.scratchpad/dossier/`, or when work needs more than one commit.
- argument-hint
- <slug> [goal sentence]
03 SKILL.md 正文
ds:plan
You are the Chief of Staff. You ask the questions and write the plan text. The ds commands do every step that gives the same result each time. Do not copy lines, count, rename or move rows by hand.
Steps
ds new <slug>prints the plan file. Fill it in this order.FORMAT.mdin this plugin has the exact shape.- Goal: the operator's words, quoted.
- Scope: one
- in:line and one- out:line. - Decisions: grill the operator with the
whetstone:grillmethod: decision blocks, the recommendation first, a later round for an answer that adds or removes questions, and a fresh ask when an answer changes a premise. Look up each fact with agathereragent. Write one numbered line per decision,<question> — <answer> · <date>.- "Discuss more" on a decision: answer it
split into <n>, <m>and ask the parts as new numbered decisions. - A decision only someone outside the room can answer: write the
whetstone:grillquestionnaire toquestionnaire-<n>.mdin the dossier folder (ds path), answer the decisionwaits on <who>: <questionnaire path>, and add a row for it withds add "<title>" --who H --state wait. - Then add
confirmed: "<the operator's words>".
- "Discuss more" on a decision: answer it
- Rows: add each with
ds add "<title>", never by hand, before any section names it. Put row detail under## Notesas### O<N>. - Checks: each check is a command that fails today and passes when the work is done. A guard check passes today and must stay green.
- Edge cases:
- <case> → <row or check>. - Commits: the planned commits, with subject, rows and paths. Plan few commits, and keep each one whole.
- Run
ds lintuntil it printsLINT: OK. - Run
ds check --baselineuntil it printsBASELINE: OK. - Run
ds pack plan. In one message, spawn oneplan-checkeragent with the pack path, and, on the first check only, the subtraction pass:whetstone:whetstone-doubterwith the subtraction mission ofwhetstone:doubt-pass, the pack as the artifact, Goal and Scope as the contract, andmodelset to this session's model family. The plan checker writes a findings file that endsVERDICT: PASSorVERDICT: CHANGES. - Run
ds record plan <findings>.- Exit 0: the plan check passed.
- Exit 1: change the plan for each finding, then repeat steps 2 to 5.
- Exit 3: this was the second CHANGES. Show the findings to the operator and stop.
- The subtraction pass: show its cuts to the operator in one decision block, and take only the cuts the operator picks. Then
ds log "subtract: <its first line>; took <cut numbers or none>"; without Whetstone,ds log "subtract: skipped, no Whetstone". Until that line is in the worklog,ds handoffasks for the cuts. A taken cut changes the plan, so repeat steps 2 to 5 without the subtraction pass.
End the turn with the lines ds handoff prints.
Discovery is the long part of the work. Leave no guess in the plan: a surprise that a review finds later is a gap in this step.
04 同仓库更多 Skills
ship
Review the dossier branch once, fold the fixup commits into the planned commits, hand the push and PR to the operator, then watch CI. Invoke when the user says "ds:ship", "ship the dossier", or when ds next exits 4.
suite-review
Run the monthly evidence review of this repo's plugin skills. Count each skill's opportunities and uses with the census, read what happened where a skill was not used, put each skill in one bucket, act, and write the actions as predictions with a check date. Use when the operator says "suite review" or "monthly review", or when the suite-review line on LATER.md is due.
research-report
Research a technical question with probes on the local system, a web fan-out through deep-research, a grounding pass on every load-bearing claim, and a report rendered as one HTML page. Use when the user asks for a research report, a design study or an evidence-backed recommendation about their own system.
html-report
Render a markdown report as one self-contained HTML page for a human reader, in plain English, with the answer first, a table of contents and Mermaid diagrams drawn as images. Use when the user asks for an HTML report, or for a readable page made from a markdown document.
domain-modeling
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.