/spec:simplify#

Runs the Simplifier agent to measure the Seed spec's complexity and propose simplifications.

Usage#

/spec:simplify                       # Target the latest Seed spec
/spec:simplify --file {path}         # Target a specific file

Parameters#

Execution Flow#

1. Load Seed Spec#

• Read target file
• Parse each section

2. Complexity Measurement#

Calculate quantitative metrics:

• Entity count, relationship count, constraint count, Must item count, unverified assumption count
• Complexity score calculation: (entities x 1) + (relationships x 1.5) + (constraints x 0.5) + (must x 1) + (unverified assumptions x 2)

3. Verdict#

4. Generate Simplification Proposals#

Before/after comparison for each proposal:

• Removal candidates: Items not contributing to core value
• Merge candidates: Similar entities/constraints
• v2 deferral candidates: Items not essential for v1

5. Collect User Decisions#

For each proposal:

• Accept: Reflect in Seed spec
• Reject: Record reason
• Defer: Review later

6. Generate Report#

• Complexity measurement results + proposal list + decision records

Output#

Report content printed to console; accepted proposals reflected in the Seed spec.

Related Commands#

• /spec:challenge — Contrarian review (can run in parallel)
• /spec:evaluate — 3-stage integrated evaluation (results used in Stage 2c)
• /spec:seed — Create Seed spec

References#

• agents/simplifier.md — Detailed agent definition