Skip to main content
Everything the plugin knows about your idea lives in one folder: startup/, created in your project root the first time you run /whats-next. There is no account, no database, and no SaaS behind it — if you delete the folder, the plugin forgets everything; if you commit it to git, your whole validation history travels with the repo.

​
The layout

Files appear as you go — a fresh project starts with just core.md and plan.md, and each skill creates its own artifacts when you first use it. A missing file simply means “not there yet,” never an error.

​
Who writes what

Each skill owns its corner of the workspace: /competitors manages competitors/ and the landscape files, /hypotheses manages hypotheses/, /interviews manages scripts, transcripts, and analyses, and so on. A few files are deliberately shared — audience-map.md is owned by /first-users but read by /interviews, /surveys, and /mvp, so who you can reach is worked out once rather than re-answered per skill. Two rules hold everywhere:
  • The plan is only ever changed by /whats-next. Other skills report progress; the planner decides what it means for your direction.
  • The advisor proposes before it writes. You’ll always see what’s about to be saved and confirm it first (with one documented exception — the competitor watch pass, which batches its updates and recaps them instead).
If you build an MVP with the plugin, its code lands in your project root next to startup/, never inside it — the workspace stays pure state, the code stays a normal codebase.

​
It’s just markdown

Every artifact has YAML frontmatter (status fields, dates, types) and a readable body. That buys you:
  • Grep-ability — grep -r "willingness_to_pay" startup/ works, and the plugin itself uses the same trick to trace evidence.
  • Obsidian as a free UI — open startup/ as a vault and the [[backlinks]] between interviews and hypotheses become a browsable graph. See The evidence graph.
  • Human-readable diffs — commit startup/ to git and you can watch your thinking evolve over time, decision by decision.
Commit startup/ to git. The artifacts are designed to produce clean, reviewable diffs — your validation work deserves version control as much as your code does.

Your plan

How core.md and plan.md steer everything else.

The evidence graph

How artifacts link together into a traceable evidence trail.