Skip to content

Commit ca031df

Browse files
mayurpiseclaude
andcommitted
docs(web): fix doc accuracy, add graph-engine benchmark post, repair RSS feed
Version/accuracy: - index release strip → 3.2.1 (June 15); add v3.2.1 changelog entry - book: Cursor uses /draft:command (not @draft); 22→62 core reference files; add /draft:jira review mode; add Codex + opencode to platform lists - blog: fix nonexistent graph/src ref; add missing engine-attribution footer New post: - "Speed Is the Wrong Axis" — graph-engine-vs-grep benchmark (anonymized corpora), wired into blog index, sitemap, and feed RSS: - correct 32 RFC-822 weekday names (validator-clean dates) - add feed.xsl so the feed renders as a readable page in browsers Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 526070d commit ca031df

15 files changed

Lines changed: 429 additions & 48 deletions

File tree

web/blog/blast-radius-walkthrough/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -310,7 +310,7 @@ <h2>Try It</h2>
310310
</aside>
311311

312312
<footer class="post-footer">
313-
<p>Draft is open source: <a href="https://github.com/drafthq/draft">github.com/drafthq/draft</a>. The impact-mode query lives in <code>graph/src/</code> and is documented in <code>core/shared/graph-query.md</code>; the implement-side guardrail is in <code>skills/implement/SKILL.md</code>; the new-track overlap scan is in <code>skills/new-track/SKILL.md</code>.</p>
313+
<p>Draft is open source: <a href="https://github.com/drafthq/draft">github.com/drafthq/draft</a>. The impact-mode query lives in <code>scripts/tools/graph-impact.sh</code> (Cypher centralized in <code>scripts/tools/_graph_queries.sh</code>) and is documented in <code>core/shared/graph-query.md</code>; the implement-side guardrail is in <code>skills/implement/SKILL.md</code>; the new-track overlap scan is in <code>skills/new-track/SKILL.md</code>.</p>
314314
<p>Graph engine: <a href="https://github.com/DeusData/codebase-memory-mcp" target="_blank" rel="noopener noreferrer">codebase-memory-mcp</a> by <a href="https://github.com/DeusData" target="_blank" rel="noopener noreferrer">DeusData</a>.</p>
315315
<p><a href="../">&larr; Back to all posts</a></p>
316316
</footer>

web/blog/graph-engine-vs-grep/index.html

Lines changed: 243 additions & 0 deletions
Large diffs are not rendered by default.

web/blog/index.html

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,15 @@ <h1>The <span class="gradient-text">Draft Blog</span></h1>
8686
</section>
8787

8888
<section class="post-list">
89+
<article class="post-card">
90+
<a href="graph-engine-vs-grep/" class="post-card-link">
91+
<p class="post-card-meta"><time datetime="2026-06-16">June 16, 2026</time> &middot; 10 min read</p>
92+
<h2 class="post-card-title">Speed Is the Wrong Axis: Benchmarking Draft's Graph Engine Against grep</h2>
93+
<p class="post-card-excerpt">On two real codebases &mdash; a 17K-LOC Rust service and a 221K-LOC polyglot platform &mdash; grep is often faster than Draft's graph engine. It's also wrong far more often (10% vs 100% hotspot precision), and it costs an AI agent up to <strong>108&times;</strong> more tokens to reach the correct answer. In an agent loop, latency is the axis that matters least.</p>
94+
<span class="post-card-cta">Read post <span class="post-card-cta-arrow" aria-hidden="true">&rarr;</span></span>
95+
</a>
96+
</article>
97+
8998
<article class="post-card">
9099
<a href="mcp-tool-discovery/" class="post-card-link">
91100
<p class="post-card-meta"><time datetime="2026-05-11">May 11, 2026</time> &middot; 9 min read</p>

web/blog/local-graph-engine/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,7 @@ <h2>Try It</h2>
237237

238238
<footer class="post-footer">
239239
<p>Draft is open source: <a href="https://github.com/drafthq/draft">github.com/drafthq/draft</a>. The graph engine (codebase-memory-mcp) is installed to <code>~/.cache/draft/bin</code>, the deterministic shell helpers live under <code>scripts/tools/</code>, and the methodology under <code>core/</code>.</p>
240+
<p>Graph engine: <a href="https://github.com/DeusData/codebase-memory-mcp" target="_blank" rel="noopener noreferrer">codebase-memory-mcp</a> by <a href="https://github.com/DeusData" target="_blank" rel="noopener noreferrer">DeusData</a>.</p>
240241
<p><a href="../">&larr; Back to all posts</a></p>
241242
</footer>
242243
</article>

web/book/chapters/00-what-is-draft.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ <h2>What You Get</h2>
7474
<li><strong>Strategy</strong> &mdash; <code>/draft:tech-debt</code> for technical debt analysis across 6 dimensions with prioritization</li>
7575
<li><strong>Documentation</strong> &mdash; <code>/draft:docs</code> orchestrates doc generation: readme, runbook, api, onboarding via <code>/draft:documentation</code></li>
7676
<li><strong>Knowledge &amp; Governance</strong> &mdash; <code>/draft:adr</code>, <code>/draft:learn</code>, <code>/draft:decompose</code>, <code>/draft:graph</code></li>
77-
<li><strong>Integration</strong> &mdash; <code>/draft:jira preview</code>, <code>/draft:jira create</code></li>
77+
<li><strong>Integration</strong> &mdash; <code>/draft:jira preview</code>, <code>/draft:jira create</code>, <code>/draft:jira review &lt;JIRA-ID&gt;</code></li>
7878
</ul>
7979

8080
<p><strong>7 specialized agents</strong> &mdash; Architect, Debugger, Planner, RCA, Reviewer, Ops, and Writer &mdash; each with behavioral protocols tuned for their domain.</p>
@@ -171,10 +171,11 @@ <h2>Platform Support</h2>
171171
<p>Draft works with the AI coding tools you already use:</p>
172172
<ul>
173173
<li><strong>Claude Code</strong> &mdash; Native plugin installation via <code>/plugin install</code></li>
174-
<li><strong>Cursor</strong> &mdash; Native support for the <code>.claude/</code> plugin structure</li>
174+
<li><strong>Cursor</strong> &mdash; Native support for the <code>.claude-plugin/</code> structure</li>
175+
<li><strong>Codex</strong> &mdash; Via an <code>AGENTS.md</code> file that Codex reads automatically</li>
176+
<li><strong>opencode</strong> &mdash; Via <code>AGENTS.md</code> plus a global <code>skills/</code> directory, both auto-discovered</li>
175177
<li><strong>GitHub Copilot</strong> &mdash; Via <code>.github/copilot-instructions.md</code></li>
176-
<li><strong>Gemini</strong> &mdash; Via <code>.gemini.md</code> bootstrap file</li>
177-
<li><strong>Antigravity IDE</strong> &mdash; Via global skill installation</li>
178+
<li><strong>Gemini</strong> &mdash; Via the <code>.gemini.md</code> bootstrap file (including the Antigravity global-skills path)</li>
178179
</ul>
179180

180181
<div class="callout callout-tip">

web/book/chapters/20-multi-ide-support.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@ <h2>The Build Pipeline</h2>
112112
<li><strong>Frontmatter extraction</strong> &mdash; Each skill's YAML frontmatter (<code>name:</code> and <code>description:</code>) is validated. The body is extracted via <code>extract_body()</code>, which strips the frontmatter delimiters.</li>
113113
<li><strong>Body format validation</strong> &mdash; The body must follow a strict format: blank line, <code># Title</code> heading, blank line, then content. The build skips the first 3 body lines when inlining (the title is replaced by the integration's section header).</li>
114114
<li><strong>Syntax transformation</strong> &mdash; Platform-specific transforms are applied: <code>/draft:command</code> becomes <code>draft command</code> for Copilot, agent references become <code>@workspace</code>.</li>
115-
<li><strong>Core file inlining</strong> &mdash; 22 core reference files (methodology, shared procedures, templates, agents) are inlined into the output, each wrapped in <code>&lt;core-file&gt;</code> tags.</li>
115+
<li><strong>Core file inlining</strong> &mdash; 62 core reference files (methodology, shared procedures, templates, agents, guardrails) are inlined into the output, each wrapped in <code>&lt;core-file&gt;</code> tags.</li>
116116
<li><strong>Verification</strong> &mdash; <code>verify_output()</code> checks minimum line count (&gt;1000), completeness sentinel (<code>DRAFT_BUILD_COMPLETE</code>), and that no untransformed syntax remains.</li>
117117
</ol>
118118

@@ -166,7 +166,7 @@ <h2>The Build Pipeline</h2>
166166
<!-- Stage 5: Core Inline -->
167167
<rect x="530" y="40" width="88" height="60" rx="6" fill="#059669" filter="url(#bp-shadow)"/>
168168
<text x="574" y="60" text-anchor="middle" fill="#fff" font-family="Arial,sans-serif" font-size="10" font-weight="bold">Core Inline</text>
169-
<text x="574" y="74" text-anchor="middle" fill="rgba(255,255,255,0.7)" font-family="Arial,sans-serif" font-size="9">22 reference</text>
169+
<text x="574" y="74" text-anchor="middle" fill="rgba(255,255,255,0.7)" font-family="Arial,sans-serif" font-size="9">62 reference</text>
170170
<text x="574" y="86" text-anchor="middle" fill="rgba(255,255,255,0.7)" font-family="Arial,sans-serif" font-size="9">files</text>
171171
<!-- Arrow -->
172172
<line x1="618" y1="70" x2="636" y2="70" stroke="#718096" stroke-width="1.5" marker-end="url(#bp-arrow)"/>

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

Lines changed: 8 additions & 1 deletion
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 33 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 33 Draft commands. Syntax shown is for Claude Code; Cursor uses the same <code>/draft:command</code> syntax (it reads the native plugin structure), Copilot uses <code>draft command</code> (no slash), and Gemini uses natural-language <code>@draft</code> prompts.</p>
66

77
<div class="figure">
88
<div class="figure-content">
@@ -298,6 +298,13 @@ <h1>Appendix A: Command Reference</h1>
298298
<td><code>/draft:jira preview</code> (or auto-generates), MCP-Jira configured</td>
299299
<td>19</td>
300300
</tr>
301+
<tr>
302+
<td><code>/draft:jira review &lt;JIRA-ID&gt;</code></td>
303+
<td>Qualification pipeline for a Jira ticket: deep-review + bughunt + coverage + test-gap analysis</td>
304+
<td><code>&lt;JIRA-ID&gt;</code> &mdash; the ticket to qualify</td>
305+
<td>MCP-Jira configured</td>
306+
<td>19</td>
307+
</tr>
301308
<tr>
302309
<td><code>/draft:tour</code></td>
303310
<td>Interactive architecture mentorship and codebase walk-through</td>

web/book/command-reference/index.html

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -210,7 +210,7 @@
210210
<h1>Appendix A: Command Reference</h1>
211211
<p class="chapter-meta"><span class="part-name">Appendix</span></p>
212212

213-
<p class="chapter-intro">Quick-reference for all 33 Draft commands. Syntax shown is for Claude Code; Copilot uses <code>draft command</code> (no slash), Cursor uses <code>@draft command</code>.</p>
213+
<p class="chapter-intro">Quick-reference for all 33 Draft commands. Syntax shown is for Claude Code; Cursor uses the same <code>/draft:command</code> syntax (it reads the native plugin structure), Copilot uses <code>draft command</code> (no slash), and Gemini uses natural-language <code>@draft</code> prompts.</p>
214214

215215
<div class="figure">
216216
<div class="figure-content">
@@ -506,6 +506,13 @@ <h1>Appendix A: Command Reference</h1>
506506
<td><code>/draft:jira preview</code> (or auto-generates), MCP-Jira configured</td>
507507
<td>19</td>
508508
</tr>
509+
<tr>
510+
<td><code>/draft:jira review &lt;JIRA-ID&gt;</code></td>
511+
<td>Qualification pipeline for a Jira ticket: deep-review + bughunt + coverage + test-gap analysis</td>
512+
<td><code>&lt;JIRA-ID&gt;</code> &mdash; the ticket to qualify</td>
513+
<td>MCP-Jira configured</td>
514+
<td>19</td>
515+
</tr>
509516
<tr>
510517
<td><code>/draft:tour</code></td>
511518
<td>Interactive architecture mentorship and codebase walk-through</td>

web/book/multi-ide-support/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -320,7 +320,7 @@ <h2>The Build Pipeline</h2>
320320
<li><strong>Frontmatter extraction</strong> &mdash; Each skill's YAML frontmatter (<code>name:</code> and <code>description:</code>) is validated. The body is extracted via <code>extract_body()</code>, which strips the frontmatter delimiters.</li>
321321
<li><strong>Body format validation</strong> &mdash; The body must follow a strict format: blank line, <code># Title</code> heading, blank line, then content. The build skips the first 3 body lines when inlining (the title is replaced by the integration's section header).</li>
322322
<li><strong>Syntax transformation</strong> &mdash; Platform-specific transforms are applied: <code>/draft:command</code> becomes <code>draft command</code> for Copilot, agent references become <code>@workspace</code>.</li>
323-
<li><strong>Core file inlining</strong> &mdash; 22 core reference files (methodology, shared procedures, templates, agents) are inlined into the output, each wrapped in <code>&lt;core-file&gt;</code> tags.</li>
323+
<li><strong>Core file inlining</strong> &mdash; 62 core reference files (methodology, shared procedures, templates, agents, guardrails) are inlined into the output, each wrapped in <code>&lt;core-file&gt;</code> tags.</li>
324324
<li><strong>Verification</strong> &mdash; <code>verify_output()</code> checks minimum line count (&gt;1000), completeness sentinel (<code>DRAFT_BUILD_COMPLETE</code>), and that no untransformed syntax remains.</li>
325325
</ol>
326326

@@ -374,7 +374,7 @@ <h2>The Build Pipeline</h2>
374374
<!-- Stage 5: Core Inline -->
375375
<rect x="530" y="40" width="88" height="60" rx="6" fill="#059669" filter="url(#bp-shadow)"/>
376376
<text x="574" y="60" text-anchor="middle" fill="#fff" font-family="Arial,sans-serif" font-size="10" font-weight="bold">Core Inline</text>
377-
<text x="574" y="74" text-anchor="middle" fill="rgba(255,255,255,0.7)" font-family="Arial,sans-serif" font-size="9">22 reference</text>
377+
<text x="574" y="74" text-anchor="middle" fill="rgba(255,255,255,0.7)" font-family="Arial,sans-serif" font-size="9">62 reference</text>
378378
<text x="574" y="86" text-anchor="middle" fill="rgba(255,255,255,0.7)" font-family="Arial,sans-serif" font-size="9">files</text>
379379
<!-- Arrow -->
380380
<line x1="618" y1="70" x2="636" y2="70" stroke="#718096" stroke-width="1.5" marker-end="url(#bp-arrow)"/>

web/book/what-is-draft/index.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -282,7 +282,7 @@ <h2>What You Get</h2>
282282
<li><strong>Strategy</strong> &mdash; <code>/draft:tech-debt</code> for technical debt analysis across 6 dimensions with prioritization</li>
283283
<li><strong>Documentation</strong> &mdash; <code>/draft:docs</code> orchestrates doc generation: readme, runbook, api, onboarding via <code>/draft:documentation</code></li>
284284
<li><strong>Knowledge &amp; Governance</strong> &mdash; <code>/draft:adr</code>, <code>/draft:learn</code>, <code>/draft:decompose</code>, <code>/draft:graph</code></li>
285-
<li><strong>Integration</strong> &mdash; <code>/draft:jira preview</code>, <code>/draft:jira create</code></li>
285+
<li><strong>Integration</strong> &mdash; <code>/draft:jira preview</code>, <code>/draft:jira create</code>, <code>/draft:jira review &lt;JIRA-ID&gt;</code></li>
286286
</ul>
287287

288288
<p><strong>7 specialized agents</strong> &mdash; Architect, Debugger, Planner, RCA, Reviewer, Ops, and Writer &mdash; each with behavioral protocols tuned for their domain.</p>
@@ -379,10 +379,11 @@ <h2>Platform Support</h2>
379379
<p>Draft works with the AI coding tools you already use:</p>
380380
<ul>
381381
<li><strong>Claude Code</strong> &mdash; Native plugin installation via <code>/plugin install</code></li>
382-
<li><strong>Cursor</strong> &mdash; Native support for the <code>.claude/</code> plugin structure</li>
382+
<li><strong>Cursor</strong> &mdash; Native support for the <code>.claude-plugin/</code> structure</li>
383+
<li><strong>Codex</strong> &mdash; Via an <code>AGENTS.md</code> file that Codex reads automatically</li>
384+
<li><strong>opencode</strong> &mdash; Via <code>AGENTS.md</code> plus a global <code>skills/</code> directory, both auto-discovered</li>
383385
<li><strong>GitHub Copilot</strong> &mdash; Via <code>.github/copilot-instructions.md</code></li>
384-
<li><strong>Gemini</strong> &mdash; Via <code>.gemini.md</code> bootstrap file</li>
385-
<li><strong>Antigravity IDE</strong> &mdash; Via global skill installation</li>
386+
<li><strong>Gemini</strong> &mdash; Via the <code>.gemini.md</code> bootstrap file (including the Antigravity global-skills path)</li>
386387
</ul>
387388

388389
<div class="callout callout-tip">

0 commit comments

Comments
 (0)