# SeedSpec authoring

> Author a specification your agent can build from.

seedspec.ai is the authoring product. It helps a person turn what they know
about a product into a portable SeedSpec package: the intended outcome, the
boundaries, the decisions that have no obviously right answer, and observable
success criteria.

The protocol beneath it — the package format, schemas, conformance suite, and
specification — lives at https://seedspec.dev/. This domain does not host the
normative contract.

## What authoring does

Guided review works through four private threads: the seed itself, coherence
across authored material, observable success, and configuration and supporting
material. Findings are source-bound — a concern must be triggered by something
the author actually wrote. Absence is not treated as a gap, and no checklist
introduces requirements the author never raised.

Every package change requires explicit author acceptance. A declined suggestion
creates no configuration, no open question, and no future work.

## Start

```
npx @seedspec/cli init application --output my-package
cd my-package
npx @seedspec/cli author
```

Or inspect an existing package before adopting it:

```
npx @seedspec/cli begin https://github.com/SeedSpec/reference-solutions/tree/main/solutions/family-hub/seedspec
```

`begin` validates and describes a package. It never executes package content.

## Pages

- https://seedspec.ai/ — what authoring is for
- https://seedspec.ai/authoring/ — the workflow and the command surface
- https://seedspec.ai/examples/family-hub/ — a walkthrough from idea to package

## Status

Experimental. The CLI is published as `@seedspec/cli`. Pin an exact version for
automation. There is no hosted authoring product yet; everything runs locally.