Start from a seed
Write what you want to exist in plain language. Your agent reflects it back, asks about the decisions only you can make, and records your answers where an implementer will actually see them.
Authoring tools · experimental
SeedSpec helps you write down what you actually know about a product — the outcome, the boundaries, the decisions that have no obviously right answer — so an agent builds that instead of something plausible.
An agent asked to build something will make every decision you left out. It will make them confidently, and it will not tell you which ones it made. Usually they are fine. The ones that are not are expensive, and you find them later.
Write what you want to exist in plain language. Your agent reflects it back, asks about the decisions only you can make, and records your answers where an implementer will actually see them.
The choices that make a product yours — what happens on a failed check, who can approve what, where the money goes — are the ones an agent invents when nobody wrote them down. Authoring is how you stop guessing from becoming policy.
The result is ordinary files with a version and a digest. Give it to Claude, Codex, or whatever you use next year. Nothing about the tool you authored in follows it.
Three paragraphs is a real starting point. You are not writing requirements and you are not designing the implementation.
Questions come one at a time, and every one is triggered by something you already wrote. Nothing is added because similar products usually have it.
Results someone could observe, not a test plan. This is what an implementing agent checks itself against.
A versioned package anyone can hand to their own agent, in their own environment, with their own connectors and their own security.
It stays a conversation. Nothing changes in your package until you say so, and declining a suggestion leaves nothing behind.
You need Node and an agent you already use. There is nothing to sign up for.
npx @seedspec/cli init application --output my-package cd my-package npx @seedspec/cli authorOr start from an existing package instead of a blank page:
npx @seedspec/cli begin https://github.com/SeedSpec/reference-solutions/tree/main/solutions/family-hub/seedspecbegin validates the package and shows you what it contains. It does not run anything the package carries.
What you author is a SeedSpec package: ordinary Markdown and a small manifest, with a versioned protocol behind it so the meaning survives moving between people, agents, and projects. You never have to look at that layer, but it is fully specified and open if you want to.
Read the protocol at seedspec.dev →