name: spec-change
description: "Spec modification router with comprehensive validation. Detects duplicates, conflicts, quality issues, and impact before applying changes. Use for any spec add/remove/modify requests."
allowed-tools: Read, Write, Edit, Bash, Task, AskUserQuestion, Glob, Grep
argument-hint: " [--target ] [--skip-checks]"
permissionMode: bypassPermissions

spec-change: Spec Modification Router

Validates and applies spec changes with comprehensive pre-flight checks.

References

• Output Formats - Analysis results, change plan, RTM formats
• shared/output-rules.md - Agent output rules
• shared/context-rules.md - Context management

Workflow

[Request] → [Parallel Analysis] → [Plan Review] → [User Approval] → [Apply]
                   │
    ┌──────────────┼──────────────┐
    │              │              │
Doppelganger  Conflict   Clarity/Coverage
    │              │              │
    └──────────────┼──────────────┘
                   │
            Butterfly Effect
                   │
           [Change Plan] → [Approve?] → [Apply]

Phase 0: Init

1. Context Validation
   Read: .claude/settings.local.json
   REQUIRE: context != "none" (minimum: fork)

2. Session Detection
   IF sessionId provided: use it
   ELSE: find most recent in tmp/

3. Parse Request
   EXTRACT: action (add/remove/modify), target, content

Phase 1: Parallel Analysis

Batch 1 (4 parallel)

Batch 2 (2 parallel)

Aggregate

Read: _analysis/*.json
Create: _analysis/summary.md

Phase 2: Plan Review

Task(change-planner, opus):
  Input: summary.md, butterfly.json
  Output: _analysis/change-plan.md

AskUserQuestion: "Apply these changes?"
  Options: ["Yes, apply all", "Modify plan", "Cancel"]

Phase 3: Apply Changes

FOR each change in plan:
  Edit: {target_file}
  Checkpoint: meta-checkpoint.sh

Task(rtm-updater, haiku):
  Output: _traceability/rtm.json

Output: "✓ Changes applied. Run /spec-change --verify to validate."

Output Structure

.spec-it/{sessionId}/plan/
├── _analysis/
│   ├── doppelganger.json, conflict.json, clarity.json
│   ├── consistency.json, coverage.json, butterfly.json
│   ├── summary.md
│   └── change-plan.md
└── _traceability/
    └── rtm.json

See Output Formats for detailed structures.

Agents

Arguments

Examples

# Add requirement
/spec-change 20260130-123456 "Add 2FA to authentication"

# Modify with target
/spec-change 20260130-123456 --target 01-chapters/CH-02.md "Change to OAuth"

# Verify changes
/spec-change --verify 20260130-123456