Skip to content

Add test-design stage (English-language test specification)#339

Open
SiddhJog wants to merge 1 commit into
feature/real-world-simulationfrom
feature/test-design-stage
Open

Add test-design stage (English-language test specification)#339
SiddhJog wants to merge 1 commit into
feature/real-world-simulationfrom
feature/test-design-stage

Conversation

@SiddhJog

@SiddhJog SiddhJog commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Summary

New stage between nfr-design and infrastructure-design that produces English-language test cases as a specification, not code. Serves as acceptance criteria for code-generation and as a test plan for QA teams.

Changes

  • test-design stage — definition + test-specification.md template with tiered test cases (unit, component, integration, NFR)
  • stage-graph — added test-design entry and dependencies; code-generation now consumes test-design as acceptance criteria
  • test-design-stage-summary.md — design thinking document
  • future-test-workflow.md — vision for parallel code-gen / test-code-gen tracks (next iteration)

Flow after this PR

functional-design → nfr-design → test-design → infrastructure-design → code-generation

Key design decisions

  • English not code — reviewable by product people, framework-agnostic
  • Traceability: Every test case traces to BR-n or NFR-n (traceability chain: requirement → rule → test → code)
  • Two consumers: code-gen (guardrails) and QA team (independent test plan)
  • Future fork point for parallel AI tracks (documented, not yet implemented)

New stage between nfr-design and infrastructure-design. Produces
English-language test cases (not code) organised by tier:
- Unit tests (method-level)
- Component tests (call chain within unit)
- Integration tests (cross-unit via contracts)
- NFR tests (performance, security, availability)

Each test case traces to BR-n or NFR-n. Coverage matrix ensures
no rule is untested.

Two consumers: code-gen (acceptance criteria) and QA team (test plan).
Future iteration will fork into parallel code-gen + test-code-gen tracks.

Includes: test-design-stage-summary.md and future-test-workflow.md
documenting the design thinking and future vision.
@SiddhJog SiddhJog requested review from raj-jain-aws and spraja08 June 8, 2026 01:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant