LogoSkills

SEED_SPEC_SCHEMA

Seed Spec Schema — Structure and field definitions for the immutable core spec document

Seed Spec Schema#

The Seed Spec is a constitutional document created before the PRD. After locking (LOCKED), it can only be changed through the explicit evolution protocol.

Document Structure#

# Seed: {project-name}  |  v{major.minor.patch}  |  Status: {DRAFT|LOCKED}

## Metadata
- Created: {YYYY-MM-DD}
- Author: {author}
- Locked: {YYYY-MM-DD or N/A}
- Ambiguity Score: {0.0-1.0}

## 1. Core Problem
 >   Immutable after locking. Cannot evolve.

{Core problem defined in a single sentence, without assumptions}

### Problem Rationale
- {Rationale based on data or user interviews 1}
- {Rationale 2}

## 2. Immutable Constraints
 >   Immutable after locking. Each item requires rationale.

| ID | Constraint | Rationale | Type |
|----|-----------|-----------|------|
| C-01 | {Constraint} | {Why this constraint is needed} | Technical/Business/Legal |
| C-02 | {Constraint} | {Rationale} | {Type} |

## 3. Domain Entities
 >   After locking, only additions are allowed (existing entities cannot be modified)

### {Entity Name}
- **Attributes**: {Attribute list}
- **Relationships**: {Relationships with other entities}
- **Invariants**: {Conditions that must always hold true}

## 4. Acceptance Boundaries

### Must (Required)
- {Requirements that must be satisfied}

### Must Not (Prohibited)
- {Things that must never be done}

### May (Optional)
- {Things that may or may not be implemented}

## 5. Exposed Assumptions
 >   List of assumptions derived from Socratic interviews

| ID | Assumption | Verification Status | Verification Method |
|----|-----------|-------------------|-------------------|
| A-01 | {Assumption content} | Verified/Unverified/Disproved | {Verification method} |

## 6. Evolution Log
 >   Append-only. Records change history after locking.

| Version | Date | Changes | Reason | Approver |
|---------|------|---------|--------|----------|
| v1.0.0 | {Date} | Initial version | Creation | {Approver} |

Field Rules#

State Transitions#

DRAFT → LOCKED (after approval)
LOCKED → LOCKED (version bump via evolution protocol)
  • DRAFT: Freely modifiable
  • LOCKED: Evolution protocol required (evolve command)

Version Rules (SemVer)#

Change TypeVersion ChangeExample
Domain entity additionMINORv1.0.0 → v1.1.0
Acceptance boundary May item changeMINORv1.1.0 → v1.2.0
Assumption verification status updatePATCHv1.2.0 → v1.2.1
Core problem change Not allowed — Requires new Seed creation
Immutable constraint change Not allowed — Requires new Seed creation

Lock Policy#

  1. Can be locked when ambiguity score ≤ 0.2 is achieved
  2. After locking, Core Problem (S1) and Immutable Constraints (S2) cannot be modified
  3. Domain Entities (S3) can only be added (existing ones cannot be modified)
  4. Only May items in Acceptance Boundaries (S4) can be changed
  5. Maximum 3 evolutions per cycle

File Location#

docs/seed-spec-{project-slug}.md