Skip to content

Commit 7a3fae9

Browse files
Mayur PiseMayur Pise
authored andcommitted
docs: consolidate command orchestrators in getdraft.dev, book, and LLMs context
- Updated website home page pipeline, Track Impact Memory, and interactive terminal to use '/draft:plan' and consolidated commands - Updated book chapters (Context-Driven Development, Getting Started, Specs & Plans, ADRs, and Command Reference) to align with '/draft:plan' and new command structures - Refreshed 'web/llms.txt' and 'web/llms-full.txt' to document all 32 consolidated slash commands and the correct Cursor/IDE onboarding flows
1 parent 9dafa7d commit 7a3fae9

14 files changed

Lines changed: 97 additions & 65 deletions

File tree

web/book/adrs/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,7 @@ <h2>ADR Evaluation</h2>
381381
</div>
382382

383383
<h2>ADRs and Tracks</h2>
384-
<p>A track (a feature, fix, or refactor managed by Draft) may generate one or more ADRs during its lifecycle. When <code>/draft:new-track</code> surfaces a technology choice or <code>/draft:decompose</code> reveals an architectural trade-off, those decisions are ADR candidates.</p>
384+
<p>A track (a feature, fix, or refactor managed by Draft) may generate one or more ADRs during its lifecycle. When <code>/draft:plan</code> surfaces a technology choice or <code>/draft:decompose</code> reveals an architectural trade-off, those decisions are ADR candidates.</p>
385385

386386
<p>ADRs created during a track reference the track in their context section. This creates bidirectional traceability: the ADR explains why a decision was made, and the track's spec or plan references the ADR number for any reader who wants the full context.</p>
387387

web/book/chapters/02-context-driven-development.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ <h3>Track Lifecycle</h3>
192192
<p>Every track follows the same lifecycle:</p>
193193

194194
<ol>
195-
<li><strong>Create</strong> &mdash; <code>/draft:new-track "Add drag-and-drop reordering"</code> initiates collaborative spec creation</li>
195+
<li><strong>Create</strong> &mdash; <code>/draft:plan "Add drag-and-drop reordering"</code> initiates collaborative spec creation</li>
196196
<li><strong>Plan</strong> &mdash; After spec approval, Draft generates a phased plan with task-level granularity</li>
197197
<li><strong>Review</strong> &mdash; The developer reviews spec and plan, edits them, commits them for peer review</li>
198198
<li><strong>Implement</strong> &mdash; <code>/draft:implement</code> executes tasks one at a time, following TDD cycles when enabled</li>

web/book/chapters/03-getting-started.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -270,7 +270,7 @@ <h3>State Files</h3>
270270
<h2>Your First Track</h2>
271271
<p>With initialization complete, you're ready to create your first feature track:</p>
272272

273-
<pre class="terminal"><code>$ /draft:new-track "Add user authentication"</code></pre>
273+
<pre class="terminal"><code>$ /draft:plan "Add user authentication"</code></pre>
274274

275275
<p>Draft loads your full project context &mdash; product vision, tech stack, architecture, workflow preferences, guardrails &mdash; and begins a collaborative dialogue to understand exactly what you need. It asks probing questions about scope, requirements, and constraints before generating anything.</p>
276276

@@ -290,7 +290,7 @@ <h2>Your First Track</h2>
290290
<h2>The Quick Workflow</h2>
291291
<p>Not everything needs a full specification. For hotfixes, small changes, and well-understood tasks, Draft supports a streamlined workflow:</p>
292292

293-
<pre class="terminal"><code>$ /draft:new-track --quick "Fix login button not responding on mobile"</code></pre>
293+
<pre class="terminal"><code>$ /draft:plan --quick "Fix login button not responding on mobile"</code></pre>
294294

295295
<p>The <code>--quick</code> flag creates a lightweight track with a condensed spec and minimal plan. It still loads project context and creates trackable artifacts, but skips the extended dialogue and detailed phase breakdown. The fix is still constrained by your architecture and conventions &mdash; it's just faster to get started.</p>
296296

web/book/chapters/04-specs-and-plans.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -50,9 +50,9 @@ <h1>Specs &amp; Plans</h1>
5050
</div>
5151

5252
<h2>Starting a Track</h2>
53-
<p>Every unit of work in Draft &mdash; a feature, a bug fix, a refactor &mdash; begins with <code>/draft:new-track</code>. This command does not generate code. It starts a <strong>collaborative intake process</strong> between you and the AI, producing two artifacts that govern everything that follows: a specification and a plan.</p>
53+
<p>Every unit of work in Draft &mdash; a feature, a bug fix, a refactor &mdash; begins with <code>/draft:plan</code> (which orchestrates planning and routes to the specialist <code>/draft:new-track</code> workflow). This command does not generate code. It starts a <strong>collaborative intake process</strong> between you and the AI, producing two artifacts that govern everything that follows: a specification and a plan.</p>
5454

55-
<pre class="terminal"><code>$ /draft:new-track Add OAuth2 support for third-party login</code></pre>
55+
<pre class="terminal"><code>$ /draft:plan Add OAuth2 support for third-party login</code></pre>
5656

5757
<p>The AI reads your project's <code>product.md</code>, <code>tech-stack.md</code>, <code>.ai-context.md</code>, and <code>workflow.md</code> before asking a single question. It arrives at the conversation already understanding your architecture, your constraints, and your conventions. Then the intake begins.</p>
5858

@@ -321,7 +321,7 @@ <h2>Status Markers</h2>
321321
<h2>Quick Mode</h2>
322322
<p>Not every change needs a full intake ceremony. For hotfixes and small, isolated changes scoped to 1&ndash;3 hours, the <code>--quick</code> flag skips the collaborative conversation entirely.</p>
323323

324-
<pre class="terminal"><code>$ /draft:new-track --quick Fix null pointer in email validation</code></pre>
324+
<pre class="terminal"><code>$ /draft:plan --quick Fix null pointer in email validation</code></pre>
325325

326326
<p>Quick mode asks exactly two questions: "What exactly needs to change?" and "How will you know it's done?" It then generates a minimal <code>spec.md</code> and a flat <code>plan.md</code> with a single phase. The metadata records <code>"type": "quick"</code> so the status display adjusts accordingly &mdash; no phase progress, just a flat task list.</p>
327327

web/book/chapters/09-adrs.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,7 @@ <h2>ADR Evaluation</h2>
175175
</div>
176176

177177
<h2>ADRs and Tracks</h2>
178-
<p>A track (a feature, fix, or refactor managed by Draft) may generate one or more ADRs during its lifecycle. When <code>/draft:new-track</code> surfaces a technology choice or <code>/draft:decompose</code> reveals an architectural trade-off, those decisions are ADR candidates.</p>
178+
<p>A track (a feature, fix, or refactor managed by Draft) may generate one or more ADRs during its lifecycle. When <code>/draft:plan</code> surfaces a technology choice or <code>/draft:decompose</code> reveals an architectural trade-off, those decisions are ADR candidates.</p>
179179

180180
<p>ADRs created during a track reference the track in their context section. This creates bidirectional traceability: the ADR explains why a decision was made, and the track's spec or plan references the ADR number for any reader who wants the full context.</p>
181181

web/book/chapters/appendix-a-command-reference.html

Lines changed: 31 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<h1>Appendix A: Command Reference</h1>
33
<p class="chapter-meta"><span class="part-name">Appendix</span></p>
44

5-
<p class="chapter-intro">Quick-reference for all 28 Draft commands. Syntax shown is for Claude Code; Copilot uses <code>draft command</code> (no slash), Cursor uses <code>@draft command</code>.</p>
5+
<p class="chapter-intro">Quick-reference for all 32 Draft commands. Syntax shown is for Claude Code; Copilot uses <code>draft command</code> (no slash), Cursor uses <code>@draft command</code>.</p>
66

77
<div class="figure">
88
<div class="figure-content">
@@ -102,18 +102,25 @@ <h1>Appendix A: Command Reference</h1>
102102
<td><code>/draft:init</code> at root and at least one service</td>
103103
<td>18</td>
104104
</tr>
105+
<tr>
106+
<td><code>/draft:plan</code></td>
107+
<td>Canonical parent planning command. Routes planning intent to specialist commands based on context</td>
108+
<td><code>new-track</code>, <code>decompose</code>, <code>change</code>, <code>adr</code> &mdash; route directly; <code>&lt;description&gt;</code> &mdash; initial feature description</td>
109+
<td><code>/draft:init</code></td>
110+
<td>4, 7, 8, 9</td>
111+
</tr>
105112
<tr>
106113
<td><code>/draft:new-track</code></td>
107114
<td>Create a feature/fix track with spec and phased plan through collaborative dialogue</td>
108115
<td><code>--quick</code> &mdash; streamlined mode with fewer questions; <code>&lt;description&gt;</code> &mdash; initial feature description</td>
109-
<td><code>/draft:init</code></td>
116+
<td><code>/draft:init</code> (or routed from <code>/draft:plan</code>)</td>
110117
<td>4</td>
111118
</tr>
112119
<tr>
113120
<td><code>/draft:implement</code></td>
114121
<td>Execute tasks from plan with TDD workflow and architecture checkpoints</td>
115122
<td>Resumes in-progress tasks automatically</td>
116-
<td><code>/draft:new-track</code> (requires plan.md)</td>
123+
<td><code>/draft:plan</code> (requires plan.md)</td>
117124
<td>5</td>
118125
</tr>
119126
<tr>
@@ -186,6 +193,13 @@ <h1>Appendix A: Command Reference</h1>
186193
<td>Active track with commits</td>
187194
<td>7</td>
188195
</tr>
196+
<tr>
197+
<td><code>/draft:ops</code></td>
198+
<td>Canonical parent operations command. Routes intent to specialist commands based on context</td>
199+
<td><code>debug</code>, <code>deploy-checklist</code>, <code>incident-response</code>, <code>standup</code> &mdash; route directly</td>
200+
<td><code>/draft:init</code></td>
201+
<td>7, 15</td>
202+
</tr>
189203
<tr>
190204
<td><code>/draft:debug</code></td>
191205
<td>Structured debugging: reproduce, isolate, diagnose, fix</td>
@@ -235,13 +249,27 @@ <h1>Appendix A: Command Reference</h1>
235249
<td>None</td>
236250
<td>&mdash;</td>
237251
</tr>
252+
<tr>
253+
<td><code>/draft:docs</code></td>
254+
<td>Canonical parent documentation command. Routes intent to specialist commands based on context</td>
255+
<td><code>documentation</code>, <code>testing-strategy</code>, <code>tech-debt</code>, <code>tour</code> &mdash; route directly</td>
256+
<td><code>/draft:init</code></td>
257+
<td>0, 14, 17</td>
258+
</tr>
238259
<tr>
239260
<td><code>/draft:documentation</code></td>
240261
<td>Technical documentation: readme, runbook, api, onboarding</td>
241262
<td><code>readme</code>, <code>runbook &lt;service&gt;</code>, <code>api &lt;module&gt;</code>, <code>onboarding</code></td>
242263
<td>init (optional)</td>
243264
<td>&mdash;</td>
244265
</tr>
266+
<tr>
267+
<td><code>/draft:integrations</code></td>
268+
<td>Canonical parent integrations command. Routes intent to specialist commands based on context</td>
269+
<td><code>jira-preview</code>, <code>jira-create</code> &mdash; route directly</td>
270+
<td><code>/draft:init</code></td>
271+
<td>19</td>
272+
</tr>
245273
<tr>
246274
<td><code>/draft:jira-preview</code></td>
247275
<td>Generate Jira export file from track plan for review before creating issues</td>

web/book/command-reference/index.html

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -310,23 +310,23 @@ <h1>Appendix A: Command Reference</h1>
310310
</tr>
311311
<tr>
312312
<td><code>/draft:plan</code></td>
313-
<td>Canonical planning parent command. Routes to new-track, decompose, change, or adr based on context.</td>
314-
<td>&mdash;</td>
313+
<td>Canonical parent planning command. Routes planning intent to specialist commands based on context</td>
314+
<td><code>new-track</code>, <code>decompose</code>, <code>change</code>, <code>adr</code> &mdash; route directly; <code>&lt;description&gt;</code> &mdash; initial feature description</td>
315315
<td><code>/draft:init</code></td>
316-
<td>4</td>
316+
<td>4, 7, 8, 9</td>
317317
</tr>
318318
<tr>
319319
<td><code>/draft:new-track</code></td>
320320
<td>Create a feature/fix track with spec and phased plan through collaborative dialogue</td>
321321
<td><code>--quick</code> &mdash; streamlined mode with fewer questions; <code>&lt;description&gt;</code> &mdash; initial feature description</td>
322-
<td><code>/draft:init</code></td>
322+
<td><code>/draft:init</code> (or routed from <code>/draft:plan</code>)</td>
323323
<td>4</td>
324324
</tr>
325325
<tr>
326326
<td><code>/draft:implement</code></td>
327327
<td>Execute tasks from plan with TDD workflow and architecture checkpoints</td>
328328
<td>Resumes in-progress tasks automatically</td>
329-
<td><code>/draft:new-track</code> (requires plan.md)</td>
329+
<td><code>/draft:plan</code> (requires plan.md)</td>
330330
<td>5</td>
331331
</tr>
332332
<tr>
@@ -401,10 +401,10 @@ <h1>Appendix A: Command Reference</h1>
401401
</tr>
402402
<tr>
403403
<td><code>/draft:ops</code></td>
404-
<td>Canonical operations parent command. Routes to debug, deploy-checklist, incident-response, or standup.</td>
405-
<td>&mdash;</td>
406-
<td>None</td>
407-
<td>&mdash;</td>
404+
<td>Canonical parent operations command. Routes intent to specialist commands based on context</td>
405+
<td><code>debug</code>, <code>deploy-checklist</code>, <code>incident-response</code>, <code>standup</code> &mdash; route directly</td>
406+
<td><code>/draft:init</code></td>
407+
<td>7, 15</td>
408408
</tr>
409409
<tr>
410410
<td><code>/draft:debug</code></td>
@@ -457,10 +457,10 @@ <h1>Appendix A: Command Reference</h1>
457457
</tr>
458458
<tr>
459459
<td><code>/draft:docs</code></td>
460-
<td>Canonical documentation parent command. Routes to readme, runbook, api, or onboarding generation.</td>
461-
<td>&mdash;</td>
462-
<td>init (optional)</td>
463-
<td>&mdash;</td>
460+
<td>Canonical parent documentation command. Routes intent to specialist commands based on context</td>
461+
<td><code>documentation</code>, <code>testing-strategy</code>, <code>tech-debt</code>, <code>tour</code> &mdash; route directly</td>
462+
<td><code>/draft:init</code></td>
463+
<td>0, 14, 17</td>
464464
</tr>
465465
<tr>
466466
<td><code>/draft:documentation</code></td>
@@ -471,9 +471,9 @@ <h1>Appendix A: Command Reference</h1>
471471
</tr>
472472
<tr>
473473
<td><code>/draft:integrations</code></td>
474-
<td>Canonical integrations parent command. Routes to Jira interactions.</td>
475-
<td>&mdash;</td>
476-
<td>None</td>
474+
<td>Canonical parent integrations command. Routes intent to specialist commands based on context</td>
475+
<td><code>jira-preview</code>, <code>jira-create</code> &mdash; route directly</td>
476+
<td><code>/draft:init</code></td>
477477
<td>19</td>
478478
</tr>
479479
<tr>

web/book/context-driven-development/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -398,7 +398,7 @@ <h3>Track Lifecycle</h3>
398398
<p>Every track follows the same lifecycle:</p>
399399

400400
<ol>
401-
<li><strong>Create</strong> &mdash; <code>/draft:new-track "Add drag-and-drop reordering"</code> initiates collaborative spec creation</li>
401+
<li><strong>Create</strong> &mdash; <code>/draft:plan "Add drag-and-drop reordering"</code> initiates collaborative spec creation</li>
402402
<li><strong>Plan</strong> &mdash; After spec approval, Draft generates a phased plan with task-level granularity</li>
403403
<li><strong>Review</strong> &mdash; The developer reviews spec and plan, edits them, commits them for peer review</li>
404404
<li><strong>Implement</strong> &mdash; <code>/draft:implement</code> executes tasks one at a time, following TDD cycles when enabled</li>

web/book/getting-started/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -476,7 +476,7 @@ <h3>State Files</h3>
476476
<h2>Your First Track</h2>
477477
<p>With initialization complete, you're ready to create your first feature track:</p>
478478

479-
<pre class="terminal"><code>$ /draft:new-track "Add user authentication"</code></pre>
479+
<pre class="terminal"><code>$ /draft:plan "Add user authentication"</code></pre>
480480

481481
<p>Draft loads your full project context &mdash; product vision, tech stack, architecture, workflow preferences, guardrails &mdash; and begins a collaborative dialogue to understand exactly what you need. It asks probing questions about scope, requirements, and constraints before generating anything.</p>
482482

@@ -496,7 +496,7 @@ <h2>Your First Track</h2>
496496
<h2>The Quick Workflow</h2>
497497
<p>Not everything needs a full specification. For hotfixes, small changes, and well-understood tasks, Draft supports a streamlined workflow:</p>
498498

499-
<pre class="terminal"><code>$ /draft:new-track --quick "Fix login button not responding on mobile"</code></pre>
499+
<pre class="terminal"><code>$ /draft:plan --quick "Fix login button not responding on mobile"</code></pre>
500500

501501
<p>The <code>--quick</code> flag creates a lightweight track with a condensed spec and minimal plan. It still loads project context and creates trackable artifacts, but skips the extended dialogue and detailed phase breakdown. The fix is still constrained by your architecture and conventions &mdash; it's just faster to get started.</p>
502502

web/book/specs-and-plans/index.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -256,9 +256,9 @@ <h1>Specs &amp; Plans</h1>
256256
</div>
257257

258258
<h2>Starting a Track</h2>
259-
<p>Every unit of work in Draft &mdash; a feature, a bug fix, a refactor &mdash; begins with <code>/draft:new-track</code>. This command does not generate code. It starts a <strong>collaborative intake process</strong> between you and the AI, producing two artifacts that govern everything that follows: a specification and a plan.</p>
259+
<p>Every unit of work in Draft &mdash; a feature, a bug fix, a refactor &mdash; begins with <code>/draft:plan</code> (which orchestrates planning and routes to the specialist <code>/draft:new-track</code> workflow). This command does not generate code. It starts a <strong>collaborative intake process</strong> between you and the AI, producing two artifacts that govern everything that follows: a specification and a plan.</p>
260260

261-
<pre class="terminal"><code>$ /draft:new-track Add OAuth2 support for third-party login</code></pre>
261+
<pre class="terminal"><code>$ /draft:plan Add OAuth2 support for third-party login</code></pre>
262262

263263
<p>The AI reads your project's <code>product.md</code>, <code>tech-stack.md</code>, <code>.ai-context.md</code>, and <code>workflow.md</code> before asking a single question. It arrives at the conversation already understanding your architecture, your constraints, and your conventions. Then the intake begins.</p>
264264

@@ -527,7 +527,7 @@ <h2>Status Markers</h2>
527527
<h2>Quick Mode</h2>
528528
<p>Not every change needs a full intake ceremony. For hotfixes and small, isolated changes scoped to 1&ndash;3 hours, the <code>--quick</code> flag skips the collaborative conversation entirely.</p>
529529

530-
<pre class="terminal"><code>$ /draft:new-track --quick Fix null pointer in email validation</code></pre>
530+
<pre class="terminal"><code>$ /draft:plan --quick Fix null pointer in email validation</code></pre>
531531

532532
<p>Quick mode asks exactly two questions: "What exactly needs to change?" and "How will you know it's done?" It then generates a minimal <code>spec.md</code> and a flat <code>plan.md</code> with a single phase. The metadata records <code>"type": "quick"</code> so the status display adjusts accordingly &mdash; no phase progress, just a flat task list.</p>
533533

0 commit comments

Comments
 (0)