sr:generate

sr:generate

Goal: produce a complete, publication-ready IEEE 830 SRS. No word limit. Each section file must be fully written — no placeholders, no summaries, no "see plan for details."

---

Step 0 — Identify Project & Gate

AskUserQuestion: "Which project to generate SRS for? (slug)"

Read all files in projects/{slug}/plan/. If plan files don't exist or are incomplete: tell user to run /sr:plan first.

Run the readiness gate before writing anything:

python .claude/scripts/plan_validator.py --dir projects/{slug}/plan/

• BLOCKED (ERRORs found, e.g. missing file, FR numbering gap, missing "shall" clause, bad priority tag): stop here. List the ERRORs and tell the user to fix them via /sr:plan before retrying /sr:generate.
• READY WITH WARNINGS (e.g. unresolved [NEEDS USER INPUT] not yet logged in appendix-b-open-issues.md): show the warnings and ask the user to confirm proceeding anyway, or go back to /sr:plan to resolve them.
• READY: proceed to Step 1.

Load .claude/skills/srs-generator/references/srs-template.md.

---

Step 1 — Generate Section Files

Create files under projects/{slug}/srs/. Write each file completely before moving to the next. Follow srs-template.md formatting for each section.

File order:

srs/
  01-introduction.md
  02-overall-description.md
  03-01-external-interfaces.md
  03-02-functional-requirements.md
  03-03-performance.md
  03-04-database.md
  03-05-design-constraints.md
  03-06-system-attributes.md
  03-07-other-requirements.md
  appendix-a-glossary.md
  appendix-b-open-issues.md

---

FR Format (mandatory for every FR in 03-02)

#### FR-NN [Essential|Conditional|Optional]

**Requirement:** The system shall {precise verb} {object} when {condition}.

| Field | Value |
|-------|-------|
| Actor | {who triggers this} |
| Precondition | {system state before} |
| Trigger | {what causes it} |
| Source | {brainstorm round / business rule / regulatory} |

**Acceptance Criteria (GWT):**
- **Given** {system state}
- **When** {actor action or event}
- **Then** {expected system response — measurable}
- **And** {additional assertions if needed}