SeedSpec 0.2.3 · experimental

Start from a seed, not a blank prompt.

SeedSpec turns product and domain knowledge into a structured starting point for AI agents—with tools to author it well and a package format built to travel.

What’s in a SeedSpec?

A SeedSpec is a portable package for what should be understood before implementation begins: the intended outcome, boundaries, meaningful choices, relevant guidance, and how success should be evaluated.

The name describes its role. It is a starting point meant to grow into a particular result—not a complete implementation and not a promise that two agents will produce identical software.

Why SeedSpec

A specification is useful before it becomes a package. SeedSpec adds value at three points: improving the starting state, helping the author develop the material, and making the result cleanly distributable.

Better starting point

Start with more than a request: product intent, constraints, open decisions, relevant context, and success criteria already in view. The agent spends less of the implementation inventing the product.

Better authoring

Guided review helps an author surface ambiguity, missing policy, adopter choices, provenance, and evidence. The authoring tools live at seedspec.ai; the protocol only defines what they produce.

Clean distribution

Package human-readable intent with stable semantic roles, versions, and exact digests. Share it directly, through a repository, or in a public or private collection without losing which material means what.

What we know about specifications

The most important result from our evaluations is simple: explicit intent gives an agent a better opportunity to preserve important product decisions than leaving those decisions implicit.

Good Markdown can already be excellent. SeedSpec’s opportunity is not “more files means a better spec.” It is guided authoring, semantic ownership, and a package that can be reviewed, adapted, and distributed without every recipient reconstructing what each passage means.

Product intent
What must be true.
Configuration
What the adopter may choose.
Decisions and provenance
Who selected what, and why.
Acceptance
How success should be evaluated.
Implementation resources
Guidance about how to do the work.
Evidence
What has actually been observed or verified.

Read the contract

Normative behavior is defined by the specification, the versioned schemas, and the conformance corpus. Everything else on this site is explanatory.

See how it feels to use

These walkthroughs connect the authored specification to adopter choices, implementation paths, and the output an agent should produce. Where no realization has been committed, the pages say so directly.

Use cases

Different people can create, distribute, approve, adapt, and implement specifications. The package remains open and inspectable while each organization adds its own trust, support, governance, or commercial model.

See all use cases →

Okay, what’s next?