Skip to content

Commit 12a7224

Browse files
authored
chore: remove TDD schema and all references (Fission-AI#586)
* chore: remove TDD schema and all references TDD was an internal test example that should not be in user-facing docs. This removes: - The schemas/tdd directory and all its templates - All TDD references from documentation - TDD examples from skill templates and source code comments * test: update tests to remove TDD schema references All tests that referenced the removed TDD schema have been updated to use spec-driven or custom-schema names instead. * chore: remove accidentally committed files
1 parent c773ef6 commit 12a7224

22 files changed

Lines changed: 96 additions & 463 deletions

docs/cli.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -527,7 +527,7 @@ openspec templates [options]
527527
openspec templates
528528

529529
# Show templates for custom schema
530-
openspec templates --schema tdd
530+
openspec templates --schema my-workflow
531531

532532
# JSON for programmatic use
533533
openspec templates --json
@@ -576,10 +576,6 @@ Available schemas:
576576
The default spec-driven development workflow
577577
Flow: proposal → specs → design → tasks
578578
579-
tdd (package)
580-
Test-driven development workflow
581-
Flow: spec → tests → implementation → docs
582-
583579
my-custom (project)
584580
Custom workflow for this project
585581
Flow: research → proposal → tasks
@@ -623,9 +619,9 @@ openspec schema init <name> [options]
623619
openspec schema init research-first
624620

625621
# Non-interactive with specific artifacts
626-
openspec schema init tdd-lite \
627-
--description "Lightweight TDD workflow" \
628-
--artifacts "spec,tests,implementation" \
622+
openspec schema init rapid \
623+
--description "Rapid iteration workflow" \
624+
--artifacts "proposal,tasks" \
629625
--default
630626
```
631627

docs/commands.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -115,16 +115,6 @@ AI: Created openspec/changes/add-dark-mode/
115115
Use /opsx:continue to create it, or /opsx:ff to create all artifacts.
116116
```
117117

118-
**Example with schema:**
119-
```
120-
You: /opsx:new write-tests --schema tdd
121-
122-
AI: Created openspec/changes/write-tests/
123-
Schema: tdd
124-
125-
Ready to create: spec
126-
```
127-
128118
**Tips:**
129119
- Use descriptive names: `add-feature`, `fix-bug`, `refactor-module`
130120
- Avoid generic names like `update`, `changes`, `wip`

docs/concepts.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -420,16 +420,6 @@ proposal → specs → design → tasks → implement
420420

421421
Best for: Most feature work where you want to agree on specs before implementation.
422422

423-
**tdd**
424-
425-
Test-driven development workflow:
426-
427-
```
428-
spec → tests → implementation → docs
429-
```
430-
431-
Best for: Teams practicing TDD who write tests before implementation.
432-
433423
### Custom Schemas
434424

435425
Create custom schemas for your team's workflow:

docs/customization.md

Lines changed: 23 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Tech stack: TypeScript, React, Node.js, PostgreSQL
8484

8585
When OpenSpec needs a schema, it checks in this order:
8686

87-
1. CLI flag: `--schema tdd`
87+
1. CLI flag: `--schema <name>`
8888
2. Change metadata (`.openspec.yaml` in the change folder)
8989
3. Project config (`openspec/config.yaml`)
9090
4. Default (`spec-driven`)
@@ -140,9 +140,9 @@ For a completely fresh workflow:
140140
openspec schema init research-first
141141

142142
# Non-interactive
143-
openspec schema init tdd-lite \
144-
--description "Lightweight TDD workflow" \
145-
--artifacts "spec,tests,impl" \
143+
openspec schema init rapid \
144+
--description "Rapid iteration workflow" \
145+
--artifacts "proposal,tasks" \
146146
--default
147147
```
148148

@@ -275,33 +275,35 @@ Path: /path/to/project/openspec/schemas/my-workflow
275275

276276
## Examples
277277

278-
### Minimal TDD Workflow
278+
### Rapid Iteration Workflow
279+
280+
A minimal workflow for quick iterations:
279281

280282
```yaml
281-
# openspec/schemas/tdd-minimal/schema.yaml
282-
name: tdd-minimal
283+
# openspec/schemas/rapid/schema.yaml
284+
name: rapid
283285
version: 1
284-
description: Write tests first, then implement
286+
description: Fast iteration with minimal overhead
285287
286288
artifacts:
287-
- id: tests
288-
generates: tests.md
289-
description: Test cases to implement
290-
template: tests.md
289+
- id: proposal
290+
generates: proposal.md
291+
description: Quick proposal
292+
template: proposal.md
291293
instruction: |
292-
Define test cases for this feature.
293-
Each test should be a clear Given/When/Then scenario.
294+
Create a brief proposal for this change.
295+
Focus on what and why, skip detailed specs.
294296
requires: []
295297
296-
- id: impl
297-
generates: implementation.md
298-
description: Implementation notes
299-
template: impl.md
300-
requires: [tests]
298+
- id: tasks
299+
generates: tasks.md
300+
description: Implementation checklist
301+
template: tasks.md
302+
requires: [proposal]
301303
302304
apply:
303-
requires: [impl]
304-
tracks: implementation.md
305+
requires: [tasks]
306+
tracks: tasks.md
305307
```
306308

307309
### Adding a Review Artifact

docs/migration-guide.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -452,7 +452,7 @@ rules:
452452
453453
When determining which schema to use, OPSX checks in order:
454454
455-
1. **CLI flag**: `--schema tdd` (highest priority)
455+
1. **CLI flag**: `--schema <name>` (highest priority)
456456
2. **Change metadata**: `.openspec.yaml` in the change directory
457457
3. **Project config**: `openspec/config.yaml`
458458
4. **Default**: `spec-driven`
@@ -462,7 +462,6 @@ When determining which schema to use, OPSX checks in order:
462462
| Schema | Artifacts | Best For |
463463
|--------|-----------|----------|
464464
| `spec-driven` | proposal → specs → design → tasks | Most projects |
465-
| `tdd` | spec → tests → implementation → docs | Test-first development |
466465

467466
List all available schemas:
468467

@@ -507,7 +506,6 @@ Restart your IDE. Skills are detected at startup.
507506
Check that your `rules:` keys match your schema's artifact IDs:
508507

509508
- **spec-driven**: `proposal`, `specs`, `design`, `tasks`
510-
- **tdd**: `spec`, `tests`, `implementation`, `docs`
511509

512510
Run this to see valid artifact IDs:
513511

docs/opsx.md

Lines changed: 2 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -100,14 +100,14 @@ rules:
100100
101101
| Field | Type | Description |
102102
|-------|------|-------------|
103-
| `schema` | string | Default schema for new changes (e.g., `spec-driven`, `tdd`) |
103+
| `schema` | string | Default schema for new changes (e.g., `spec-driven`) |
104104
| `context` | string | Project context injected into all artifact instructions |
105105
| `rules` | object | Per-artifact rules, keyed by artifact ID |
106106

107107
### How It Works
108108

109109
**Schema precedence** (highest to lowest):
110-
1. CLI flag (`--schema tdd`)
110+
1. CLI flag (`--schema <name>`)
111111
2. Change metadata (`.openspec.yaml` in change directory)
112112
3. Project config (`openspec/config.yaml`)
113113
4. Default (`spec-driven`)
@@ -130,12 +130,6 @@ rules:
130130
- `design` — Technical design
131131
- `tasks` — Implementation tasks
132132

133-
**tdd**:
134-
- `spec` — Feature specification
135-
- `tests` — Test file
136-
- `implementation` — Implementation code
137-
- `docs` — Documentation
138-
139133
### Config Validation
140134

141135
- Unknown artifact IDs in `rules` generate warnings
@@ -618,7 +612,6 @@ artifacts:
618612
Schemas define what artifacts exist and their dependencies. Currently available:
619613

620614
- **spec-driven** (default): proposal → specs → design → tasks
621-
- **tdd**: tests → implementation → docs
622615

623616
```bash
624617
# List available schemas

0 commit comments

Comments
 (0)