specrail-write-tech-spec

SpecRail Write Tech Spec

Use this skill for the technical half of the write_spec route.

Steps

1. Read the linked issue and specs/GH<issue-number>/product.md.
2. Read the relevant tech spec template from templates/<locale>/tech_spec.md or templates/tech_spec.md.
3. Run the local gate when available:

python3 checks/route_gate.py --repo . --route write_spec --issue <issue-number> --state ready_to_spec --json

1. Write specs/GH<issue-number>/tech.md.
2. Ground the plan in codebase context: relevant files, current behavior, and why each area changes or stays unchanged.
3. Map each product behavior invariant to implementation area and verification.
4. Describe the proposed design, data flow, touched components, edge cases, migration or compatibility risks, verification plan, and rollback plan.
5. Name deterministic checks that prove the design was implemented.

Boundaries

• Do not start implementation from the tech spec step.
• Do not claim spec approval; report missing approval as a human gate.
• Preserve dry-run and advisory defaults for automation.
• Keep stable machine-facing IDs in English.