| íëĒŠ | ë´ėŠ |
| Invoke | /spec:evolve |
| Category | spec-clarity |
| Complexity | medium |
/spec:evolve#
Changes a locked (LOCKED) Seed spec through the explicit evolution protocol.
Core Problem (S1) and Immutable Constraints (S2) cannot be changed.
Usage#
/spec:evolve # Start evolution process
/spec:evolve --file {path} # Specify a specific Seed spec
Parameters#
| Parameter | Description | Default |
--file |
Seed spec file path |
Latest docs/seed-spec-*.md |
Prerequisites#
- Seed spec is in LOCKED status
- Evolution count within cycle < 3
Allowed/Prohibited Changes#
| Section | Allowed Changes |
| S1 Core Problem | Not allowed â Requires new Seed creation |
| S2 Immutable Constraints | Not allowed â Requires new Seed creation |
| S3 Domain Entities | Additions only (existing cannot be modified) |
| S4 Acceptance Boundaries | Only May items can be changed |
| S5 Exposed Assumptions | Verification status can be updated |
Execution Flow#
1. Pre-validation#
- Confirm LOCKED status
- Check evolution count (max 3 per cycle)
2. Collect Change Requests#
- Ask the user for change details
- Inform about allowed/prohibited scope
3. Change Validity Check#
- Reject attempts to modify prohibited sections + provide guidance
- Apply only changes within allowed scope
4. Version Bump#
| Change Type | Version Change |
| Domain entity addition | MINOR (v1.0.0 â v1.1.0) |
| May item change | MINOR |
| Assumption status update | PATCH (v1.1.0 â v1.1.1) |
5. Evolution Log Entry#
- Append to evolution log (S6)
- Record change details, reason, and approver
6. Re-verification#
- Suggest re-evaluating ambiguity score after changes
Output#
Seed spec file updated (version + evolution log).
/spec:seed â Create Seed spec
/spec:verify â Verification + lock
/spec:ambiguity â Ambiguity re-evaluation