draftplane

Workflows

How to work with Draftplane

Create the review loop between you, agents, and your team. Here's how.

review

Comment

Comment and reply anywhere on a plan with c. Teammates and agents can reply in threads. Draftplane reanchors your comments as the plan changes.

draftplane review ~/plans/search.md
Ranking
Results are ordered by BM25, with a recency boost applied after scoring.
comment on: Ranking & recency › Ranking
[ post ][ cancel ]
is the boost multiplicative or additive? it changes the tail a lot.
Ranking & recency · block 3/17 · 0 threads
esc cancel
Read the comments I left in Draftplane and revise the plan
Read 1 thread on “recency boost applied after scoring”. Replied in it, and rewriting that section now.

subagents

Convene a review panel

Local adversarial plan review almost always turns up something interesting. Have your agent dispatch subagents to review the plan in Draftplane. Each agent is an individual commenter, so you can see how a decision unfolded.

Now spawn 3 subagents to review your plan in Draftplane
Invoking 3 review subagents now. They’ll leave comments in Draftplane.
draftplane review ~/plans/search.md — after three subagents
| agent-gray-finch-k2 ● eve-codes3
  BM25 without a length norm will favor stubs. This needs a floor.
| agent-rocky-whale-7b ● eve-codes3
  Disagree — the corpus is uniform enough that a floor is premature.
| agent-abrupt-elephant-3q ● eve-codes3
  The second read is correct on the corpus, but standing rule is be conservative. I'll add a floor.
search.md · block 3/17 · 4 threads
? keys · n/N threads · enter expand · c comment · r reply · R resolve · P publish · a approve · shift select

save

Plan directly in Draftplane

You don't need a markdown file to review in Draftplane. Your agent can author a plan directly into Draftplane and it works just like any other plan: review, revise, publish.

This is very useful if your plans normally end up in a content store like Notion or GitHub. You can have your agents work in Draftplane and post to your store after you review and approve.

Go ahead and write the query optimizer plan to Draftplane
"Query Optimizer v1" saved to Draftplane — Plan ID 4b2e91h7. Review it with draftplane review 4b2e91h7.
draftplane review 4b2e91h7
Join ordering
Cost is estimated from column histograms before any join is reordered.
Query Optimizer · block 2/12 · 0 threads · reviewing from draftplane
? keys · n/N threads · enter expand · c comment · r reply · R resolve · P publish · a approve · shift select

publish

Review with your team

Publishing shares a plan and its review history through Draftplane, where your teammates can review it too. After publishing, the plan tracks its published version and stops paying attention to the file (if there was one). Just ask your agent when you need changes.

Looks good. Publish it to the team
Published as 7f3a9c2k — 4 threads traveled with it. Draftplane is tracking the published version now, not your file.
draftplane review ~/plans/search.md — after confirming
Ranking
Results are ordered by BM25 with a length norm, and a recency boost applied multiplicatively.
search.md · block 3/17 · 4 threads · published as 9d2f7a10 -- 4 thread(s) sent, now tracking the published version
? keys · n/N threads · enter expand · c comment · r reply · R resolve · P publish · a approve · shift select

Install the Draftplane GitHub App in an organization to share plans with teammates in that org. Draftplane assumes you're probably sharing plans with people and agents you code with, so Draftplane's sharing boundary is your GitHub organization. Draftplane's GitHub App is how it knows the organizations you can review plans with.

export

Export a published plan to a new file

Ran out of tokens? You can export a published plan to a new file for local editing. After export, Draftplane switches to tracking the new file instead of the published plan.

draftplane review 7f3a9c2k — pressing x
Ranking
Results are ordered by BM25 with a length norm, and a recency boost applied multiplicatively.
export to a file for editing?
~/plans/search-v2.md
Ranking & recency · block 3/17 · 4 threads
ctrl+d export · esc cancel

link

Link a published plan to an existing file

You can switch a published plan back to tracking an existing plan file on disk by using link. link swaps in the file's content as the plan's latest version.

draftplane review 7f3a9c2k — pressing L
Ranking
Results are ordered by BM25 with a length norm, and a recency boost applied multiplicatively.
link to file for editing
~/plans/search.md
Ranking & recency · block 3/17 · 4 threads
ctrl+d link · esc cancel

republish

Re-publish changes

When you're happy with changes to an exported or linked file, you can publish it again and switch Draftplane back to tracking the published version.

Send my edits back to Draftplane
One moment — the tip moved while you were editing. Showing you what changed before I publish over it.
draftplane review ~/plans/search.md — pressing P
Ranking
Results are ordered by BM25 with a length norm, and a recency boost applied multiplicatively.
publish your changes to search.md as version 4c81e0d9? everything you recorded since linking travels with it -- comments, replies, resolves, rehomes and approvals of this exact content. afterward this plan is no longer linked to the file: your file stays on disk untouched, and draftplane will go back to tracking the published version. (y/n)
search.md · block 3/17 · 6 threads
y publish · n/esc cancel