Name: tdd-workflow
Author: ZenRay

Prompt file imported from ZenRay/CursorTemplate (.cursor/commands/tdd-workflow.md). Copyright stays with the author.

/tdd-workflow — Test-Driven Development

Complete TDD workflow using Cursor Test Panel and automated testing.

What is Cursor Test Panel?

Cursor has built-in test integration:

Shows test results inline in the editor
Displays pass/fail status in the gutter
Integrated with Agent for auto-test workflows

TDD Cycle with Cursor

1. Red — Write Failing Test

/tdd-workflow red

Describe: "User registration should validate email format"
Test file: src/auth/__tests__/register.test.ts

Agent generates:
- Test case with invalid email
- Assertion for error response
- Edge cases (empty, malformed, missing)

Run tests (expect failure):

npm test -- register.test.ts

Cursor Test Panel shows: 🔴 3 tests failing

2. Green — Write Minimal Code

/tdd-workflow green

Implement minimal validation to pass tests.
Don't over-engineer.

Agent generates:

Email regex validation
Error response format

Test Panel updates: 🟢 3 tests passing

3. Refactor — Improve Code

/tdd-workflow refactor

Clean up:
- Extract validation to helper
- Improve error messages
- Add JSDoc

Test Panel stays: 🟢 All passing (regression safety)

Test Panel Commands

Open Test Panel

Cmd/Ctrl + Shift + P → "Cursor: Open Test Panel"

Or keyboard shortcut:

Cmd/Ctrl + Shift + T

View Test Status

/tdd-workflow status

Output:
## Test Status

| Suite | Passing | Failing | Skipped |
|-------|---------|---------|---------|
| auth | 12 ✅ | 0 | 0 |
| api | 45 ✅ | 2 🔴 | 1 ⏸️ |
| utils | 8 ✅ | 0 | 0 |

Failing:
- api/users.test.ts:42 - should reject duplicate email
- api/auth.test.ts:15 - should refresh expired token

Run Affected Tests

After code changes:

/tdd-workflow run-affected

Runs only tests related to modified files.
Much faster than full suite.

YOLO Mode Integration

/tdd-workflow yolo

Enables:
1. Auto-run affected tests on file save
2. Auto-fix failing tests (if safe)
3. Stop after 3 failed attempts
4. Notify when all pass

⚠️ Requires YOLO mode enabled in settings.

Test Generation Patterns

Pattern 1: Happy Path + Edge Cases

// Generated by /tdd-workflow generate
describe('createUser', () => {
  // Happy path
  it('creates user with valid data', () => {
    const user = createUser({ email: 'test@example.com', name: 'Test' });
    expect(user.id).toBeDefined();
    expect(user.email).toBe('test@example.com');
  });

  // Edge cases
  it('rejects invalid email', () => {
    expect(() => createUser({ email: 'invalid' }))
      .toThrow('Invalid email format');
  });

  it('rejects duplicate email', async () => {
    await createUser({ email: 'test@example.com' });
    await expect(createUser({ email: 'test@example.com' }))
      .rejects.toThrow('Email already exists');
  });

  it('handles empty name', () => {
    const user = createUser({ email: 'test@example.com', name: '' });
    expect(user.name).toBe(''); // or should it throw?
  });
});

Pattern 2: API Endpoint Tests

// /tdd-workflow generate-api-test POST /api/users
describe('POST /api/users', () => {
  it('creates user and returns 201', async () => {
    const res = await request(app)
      .post('/api/users')
      .send({ email: 'test@example.com', password: 'secure123' });

    expect(res.status).toBe(201);
    expect(res.body).toHaveProperty('id');
    expect(res.body.password).toBeUndefined(); // never return password
  });

  it('returns 400 for invalid input', async () => {
    const res = await request(app)
      .post('/api/users')
      .send({ email: 'invalid' });

    expect(res.status).toBe(400);
    expect(res.body.errors).toContainEqual(
      expect.objectContaining({ field: 'email' })
    );
  });
});

Pattern 3: Component Tests

// /tdd-workflow generate-component LoginForm
describe('LoginForm', () => {
  it('renders email and password inputs', () => {
    render(<LoginForm />);
    expect(screen.getByLabelText(/email/i)).toBeInTheDocument();
    expect(screen.getByLabelText(/password/i)).toBeInTheDocument();
  });

  it('submits form with user input', async () => {
    const onSubmit = jest.fn();
    render(<LoginForm onSubmit={onSubmit} />);

    await userEvent.type(screen.getByLabelText(/email/i), 'test@example.com');
    await userEvent.type(screen.getByLabelText(/password/i), 'password123');
    await userEvent.click(screen.getByRole('button', { name: /login/i }));

    expect(onSubmit).toHaveBeenCalledWith({
      email: 'test@example.com',
      password: 'password123'
    });
  });

  it('shows validation errors', async () => {
    render(<LoginForm />);
    await userEvent.click(screen.getByRole('button', { name: /login/i }));

    expect(screen.getByText(/email is required/i)).toBeInTheDocument();
  });
});

Integration with Agent

Agent-Assisted TDD

"Implement user authentication using TDD"

Agent will:
1. /tdd-workflow red → Write failing tests
2. /tdd-workflow green → Implement minimal code
3. /tdd-workflow refactor → Clean up
4. Repeat for each auth feature

Auto-Generate from Code

/tdd-workflow generate-from src/utils/validation.ts

Analyzes code and generates:
- Unit tests for exported functions
- Edge case coverage
- Integration test suggestions

Coverage Goals

Recommended coverage thresholds:

Module	Lines	Functions	Branches
Core logic	90%	95%	85%
API handlers	85%	90%	80%
Utilities	80%	85%	75%
UI components	70%	75%	60%

View coverage:

/tdd-workflow coverage

Output:
## Coverage Report

| File | Lines | Functions | Branches |
|------|-------|-----------|----------|
| src/auth.ts | 92% ✅ | 100% ✅ | 88% ✅ |
| src/api.ts | 78% ⚠️ | 85% ⚠️ | 72% ⚠️ |

Areas needing tests:
- src/api.ts:42 - Error handling branch
- src/api.ts:88 - Rate limiting check

Debugging Failed Tests

/tdd-workflow debug src/auth.test.ts:42

Agent:
1. Reads failing test
2. Reads implementation
3. Identifies root cause
4. Suggests fix
5. Can auto-fix if safe

Test Organization

Recommended structure:

src/
├── components/
│   ├── Button.tsx
│   └── __tests__/
│       └── Button.test.tsx  # Component tests
├── utils/
│   ├── validation.ts
│   └── __tests__/
│       └── validation.test.ts  # Unit tests
├── api/
│   ├── users.ts
│   └── __tests__/
│       └── users.test.ts  # Integration tests
└── e2e/  # End-to-end
    └── auth.spec.ts

CI Integration

Pre-commit hook:

#!/bin/bash
# .cursor/hooks/pre-test.sh
npm run test:staged  # Run only changed tests

Quick Reference

/tdd-workflow red          → Write failing test
/tdd-workflow green        → Make it pass
/tdd-workflow refactor     → Clean up
/tdd-workflow status       → View all test status
/tdd-workflow run-affected → Run related tests
/tdd-workflow yolo         → Auto-run mode
/tdd-workflow coverage     → Coverage report
/tdd-workflow debug [file] → Debug failing test

Best Practices

Test behavior, not implementation — Refactor-friendly
One assertion per test (mostly) — Clear failure messages
Descriptive names — it('should reject invalid email')
Given-When-Then — Structure: arrange, act, assert
Fast feedback — < 1 second per test file
YOLO with care — Only in well-tested codebases

Install tdd-workflow and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# /tdd-workflow — Test-Driven Development Complete TDD workflow using Cursor Test Panel and automated testing. ## What is Cursor Test Panel? Cursor has built-in test integration: - Shows test results inline in the editor - Displays pass/fail status in the gutter - Integrated with Agent for auto-test workflows ## TDD Cycle with Cursor ### 1. Red — Write Failing Test ``` /tdd-workflow red Describe: "User registration should validate email format" Test file: src/auth/__tests__/register.test.ts Agent generates: - Test case with invalid email - Assertion for error response - Edge cases (empty, malformed, missing) ``` Run tests (expect failure): ```bash npm test -- register.test.ts ``` Cursor Test Panel shows: 🔴 3 tests failing ### 2. Green — Write Minimal Code ``` /tdd-workflow green Implement minimal validation to pass tests. Don't over-engineer. ``` Agent generates: - Email regex validation - Error response format Test Panel updates: 🟢 3 tests passing ### 3. Refactor — Improve Code ``` /tdd-workflow refactor Clean up: - Extract validation to helper - Improve error messages - Add JSDoc ``` Test Panel stays: 🟢 All passing (regression safety) ## Test Panel Commands ### Open Test Panel ``` Cmd/Ctrl + Shift + P → "Cursor: Open Test Panel" ``` Or keyboard shortcut: ``` Cmd/Ctrl + Shift + T ``` ### View Test Status ``` /tdd-workflow status Output: ## Test Status | Suite | Passing | Failing | Skipped | |-------|---------|---------|---------| | auth | 12 ✅ | 0 | 0 | | api | 45 ✅ | 2 🔴 | 1 ⏸️ | | utils | 8 ✅ | 0 | 0 | Failing: - api/users.test.ts:42 - should reject duplicate email - api/auth.test.ts:15 - should refresh expired token ``` ### Run Affected Tests After code changes: ``` /tdd-workflow run-affected Runs only tests related to modified files. Much faster than full suite. ``` ### YOLO Mode Integration ``` /tdd-workflow yolo Enables: 1. Auto-run affected tests on file save 2. Auto-fix failing tests (if safe) 3. Stop after 3 failed attempts 4. Notify when all pass ⚠️ Requires YOLO mode enabled in settings. ``` ## Test Generation Patterns ### Pattern 1: Happy Path + Edge Cases ```typescript // Generated by /tdd-workflow generate describe('createUser', () => { // Happy path it('creates user with valid data', () => { const user = createUser({ email: 'test@example.com', name: 'Test' }); expect(user.id).toBeDefined(); expect(user.email).toBe('test@example.com'); }); // Edge cases it('rejects invalid email', () => { expect(() => createUser({ email: 'invalid' })) .toThrow('Invalid email format'); }); it('rejects duplicate email', async () => { await createUser({ email: 'test@example.com' }); await expect(createUser({ email: 'test@example.com' })) .rejects.toThrow('Email already exists'); }); it('handles empty name', () => { const user = createUser({ email: 'test@example.com', name: '' }); expect(user.name).toBe(''); // or should it throw? }); }); ``` ### Pattern 2: API Endpoint Tests ```typescript // /tdd-workflow generate-api-test POST /api/users describe('POST /api/users', () => { it('creates user and returns 201', async () => { const res = await request(app) .post('/api/users') .send({ email: 'test@example.com', password: 'secure123' }); expect(res.status).toBe(201); expect(res.body).toHaveProperty('id'); expect(res.body.password).toBeUndefined(); // never return password }); it('returns 400 for invalid input', async () => { const res = await request(app) .post('/api/users') .send({ email: 'invalid' }); expect(res.status).toBe(400); expect(res.body.errors).toContainEqual( expect.objectContaining({ field: 'email' }) ); }); }); ``` ### Pattern 3: Component Tests ```typescript // /tdd-workflow generate-component LoginForm describe('LoginForm', () => { it('renders email and password inputs', () => { render(<LoginForm />); expect(screen.getByLabelText(/email/i)).toBeInTheDocument(); expect(screen.getByLabelText(/password/i)).toBeInTheDocument(); }); it('submits form with user input', async () => { const onSubmit = jest.fn(); render(<LoginForm onSubmit={onSubmit} />); await userEvent.type(screen.getByLabelText(/email/i), 'test@example.com'); await userEvent.type(screen.getByLabelText(/password/i), 'password123'); await userEvent.click(screen.getByRole('button', { name: /login/i })); expect(onSubmit).toHaveBeenCalledWith({ email: 'test@example.com', password: 'password123' }); }); it('shows validation errors', async () => { render(<LoginForm />); await userEvent.click(screen.getByRole('button', { name: /login/i })); expect(screen.getByText(/email is required/i)).toBeInTheDocument(); }); }); ``` ## Integration with Agent ### Agent-Assisted TDD ``` "Implement user authentication using TDD" Agent will: 1. /tdd-workflow red → Write failing tests 2. /tdd-workflow green → Implement minimal code 3. /tdd-workflow refactor → Clean up 4. Repeat for each auth feature ``` ### Auto-Generate from Code ``` /tdd-workflow generate-from src/utils/validation.ts Analyzes code and generates: - Unit tests for exported functions - Edge case coverage - Integration test suggestions ``` ## Coverage Goals Recommended coverage thresholds: | Module | Lines | Functions | Branches | |--------|-------|-----------|----------| | Core logic | 90% | 95% | 85% | | API handlers | 85% | 90% | 80% | | Utilities | 80% | 85% | 75% | | UI components | 70% | 75% | 60% | View coverage: ``` /tdd-workflow coverage Output: ## Coverage Report | File | Lines | Functions | Branches | |------|-------|-----------|----------| | src/auth.ts | 92% ✅ | 100% ✅ | 88% ✅ | | src/api.ts | 78% ⚠️ | 85% ⚠️ | 72% ⚠️ | Areas needing tests: - src/api.ts:42 - Error handling branch - src/api.ts:88 - Rate limiting check ``` ## Debugging Failed Tests ``` /tdd-workflow debug src/auth.test.ts:42 Agent: 1. Reads failing test 2. Reads implementation 3. Identifies root cause 4. Suggests fix 5. Can auto-fix if safe ``` ## Test Organization Recommended structure: ``` src/ ├── components/ │ ├── Button.tsx │ └── __tests__/ │ └── Button.test.tsx # Component tests ├── utils/ │ ├── validation.ts │ └── __tests__/ │ └── validation.test.ts # Unit tests ├── api/ │ ├── users.ts │ └── __tests__/ │ └── users.test.ts # Integration tests └── e2e/ # End-to-end └── auth.spec.ts ``` ## CI Integration Pre-commit hook: ```bash #!/bin/bash # .cursor/hooks/pre-test.sh npm run test:staged # Run only changed tests ``` ## Quick Reference ``` /tdd-workflow red → Write failing test /tdd-workflow green → Make it pass /tdd-workflow refactor → Clean up /tdd-workflow status → View all test status /tdd-workflow run-affected → Run related tests /tdd-workflow yolo → Auto-run mode /tdd-workflow coverage → Coverage report /tdd-workflow debug [file] → Debug failing test ``` ## Best Practices 1. **Test behavior, not implementation** — Refactor-friendly 2. **One assertion per test** (mostly) — Clear failure messages 3. **Descriptive names** — `it('should reject invalid email')` 4. **Given-When-Then** — Structure: arrange, act, assert 5. **Fast feedback** — < 1 second per test file 6. **YOLO with care** — Only in well-tested codebases

{ "prompt": "# /tdd-workflow — Test-Driven Development\n\nComplete TDD workflow using Cursor Test Panel and automated testing.\n\n## What is Cursor Test Panel?\n\nCursor has built-in test integration:\n- Shows test results inline in the editor\n- Displays pass/fail status in the gutter\n- Integrated with Agent for auto-test workflows\n\n## TDD Cycle with Cursor\n\n### 1. Red — Write Failing Test\n\n```\n/tdd-workflow red\n\nDescribe: \"User registration should validate email format\"\nTest file: src/auth/__tests__/register.test.ts\n\nAgent generates:\n- Test case with invalid email\n- Assertion for error response\n- Edge cases (empty, malformed, missing)\n```\n\nRun tests (expect failure):\n```bash\nnpm test -- register.test.ts\n```\n\nCursor Test Panel shows: 🔴 3 tests failing\n\n### 2. Green — Write Minimal Code\n\n```\n/tdd-workflow green\n\nImplement minimal validation to pass tests.\nDon't over-engineer.\n```\n\nAgent generates:\n- Email regex validation\n- Error response format\n\nTest Panel updates: 🟢 3 tests passing\n\n### 3. Refactor — Improve Code\n\n```\n/tdd-workflow refactor\n\nClean up:\n- Extract validation to helper\n- Improve error messages\n- Add JSDoc\n```\n\nTest Panel stays: 🟢 All passing (regression safety)\n\n## Test Panel Commands\n\n### Open Test Panel\n\n```\nCmd/Ctrl + Shift + P → \"Cursor: Open Test Panel\"\n```\n\nOr keyboard shortcut:\n```\nCmd/Ctrl + Shift + T\n```\n\n### View Test Status\n\n```\n/tdd-workflow status\n\nOutput:\n## Test Status\n\n| Suite | Passing | Failing | Skipped |\n|-------|---------|---------|---------|\n| auth | 12 ✅ | 0 | 0 |\n| api | 45 ✅ | 2 🔴 | 1 ⏸️ |\n| utils | 8 ✅ | 0 | 0 |\n\nFailing:\n- api/users.test.ts:42 - should reject duplicate email\n- api/auth.test.ts:15 - should refresh expired token\n```\n\n### Run Affected Tests\n\nAfter code changes:\n\n```\n/tdd-workflow run-affected\n\nRuns only tests related to modified files.\nMuch faster than full suite.\n```\n\n### YOLO Mode Integration\n\n```\n/tdd-workflow yolo\n\nEnables:\n1. Auto-run affected tests on file save\n2. Auto-fix failing tests (if safe)\n3. Stop after 3 failed attempts\n4. Notify when all pass\n\n⚠️ Requires YOLO mode enabled in settings.\n```\n\n## Test Generation Patterns\n\n### Pattern 1: Happy Path + Edge Cases\n\n```typescript\n// Generated by /tdd-workflow generate\ndescribe('createUser', () => {\n // Happy path\n it('creates user with valid data', () => {\n const user = createUser({ email: 'test@example.com', name: 'Test' });\n expect(user.id).toBeDefined();\n expect(user.email).toBe('test@example.com');\n });\n\n // Edge cases\n it('rejects invalid email', () => {\n expect(() => createUser({ email: 'invalid' }))\n .toThrow('Invalid email format');\n });\n\n it('rejects duplicate email', async () => {\n await createUser({ email: 'test@example.com' });\n await expect(createUser({ email: 'test@example.com' }))\n .rejects.toThrow('Email already exists');\n });\n\n it('handles empty name', () => {\n const user = createUser({ email: 'test@example.com', name: '' });\n expect(user.name).toBe(''); // or should it throw?\n });\n});\n```\n\n### Pattern 2: API Endpoint Tests\n\n```typescript\n// /tdd-workflow generate-api-test POST /api/users\ndescribe('POST /api/users', () => {\n it('creates user and returns 201', async () => {\n const res = await request(app)\n .post('/api/users')\n .send({ email: 'test@example.com', password: 'secure123' });\n\n expect(res.status).toBe(201);\n expect(res.body).toHaveProperty('id');\n expect(res.body.password).toBeUndefined(); // never return password\n });\n\n it('returns 400 for invalid input', async () => {\n const res = await request(app)\n .post('/api/users')\n .send({ email: 'invalid' });\n\n expect(res.status).toBe(400);\n expect(res.body.errors).toContainEqual(\n expect.objectContaining({ field: 'email' })\n );\n });\n});\n```\n\n### Pattern 3: Component Tests\n\n```typescript\n// /tdd-workflow generate-component LoginForm\ndescribe('LoginForm', () => {\n it('renders email and password inputs', () => {\n render(<LoginForm />);\n expect(screen.getByLabelText(/email/i)).toBeInTheDocument();\n expect(screen.getByLabelText(/password/i)).toBeInTheDocument();\n });\n\n it('submits form with user input', async () => {\n const onSubmit = jest.fn();\n render(<LoginForm onSubmit={onSubmit} />);\n\n await userEvent.type(screen.getByLabelText(/email/i), 'test@example.com');\n await userEvent.type(screen.getByLabelText(/password/i), 'password123');\n await userEvent.click(screen.getByRole('button', { name: /login/i }));\n\n expect(onSubmit).toHaveBeenCalledWith({\n email: 'test@example.com',\n password: 'password123'\n });\n });\n\n it('shows validation errors', async () => {\n render(<LoginForm />);\n await userEvent.click(screen.getByRole('button', { name: /login/i }));\n\n expect(screen.getByText(/email is required/i)).toBeInTheDocument();\n });\n});\n```\n\n## Integration with Agent\n\n### Agent-Assisted TDD\n\n```\n\"Implement user authentication using TDD\"\n\nAgent will:\n1. /tdd-workflow red → Write failing tests\n2. /tdd-workflow green → Implement minimal code\n3. /tdd-workflow refactor → Clean up\n4. Repeat for each auth feature\n```\n\n### Auto-Generate from Code\n\n```\n/tdd-workflow generate-from src/utils/validation.ts\n\nAnalyzes code and generates:\n- Unit tests for exported functions\n- Edge case coverage\n- Integration test suggestions\n```\n\n## Coverage Goals\n\nRecommended coverage thresholds:\n\n| Module | Lines | Functions | Branches |\n|--------|-------|-----------|----------|\n| Core logic | 90% | 95% | 85% |\n| API handlers | 85% | 90% | 80% |\n| Utilities | 80% | 85% | 75% |\n| UI components | 70% | 75% | 60% |\n\nView coverage:\n```\n/tdd-workflow coverage\n\nOutput:\n## Coverage Report\n\n| File | Lines | Functions | Branches |\n|------|-------|-----------|----------|\n| src/auth.ts | 92% ✅ | 100% ✅ | 88% ✅ |\n| src/api.ts | 78% ⚠️ | 85% ⚠️ | 72% ⚠️ |\n\nAreas needing tests:\n- src/api.ts:42 - Error handling branch\n- src/api.ts:88 - Rate limiting check\n```\n\n## Debugging Failed Tests\n\n```\n/tdd-workflow debug src/auth.test.ts:42\n\nAgent:\n1. Reads failing test\n2. Reads implementation\n3. Identifies root cause\n4. Suggests fix\n5. Can auto-fix if safe\n```\n\n## Test Organization\n\nRecommended structure:\n```\nsrc/\n├── components/\n│ ├── Button.tsx\n│ └── __tests__/\n│ └── Button.test.tsx # Component tests\n├── utils/\n│ ├── validation.ts\n│ └── __tests__/\n│ └── validation.test.ts # Unit tests\n├── api/\n│ ├── users.ts\n│ └── __tests__/\n│ └── users.test.ts # Integration tests\n└── e2e/ # End-to-end\n └── auth.spec.ts\n```\n\n## CI Integration\n\nPre-commit hook:\n```bash\n#!/bin/bash\n# .cursor/hooks/pre-test.sh\nnpm run test:staged # Run only changed tests\n```\n\n## Quick Reference\n\n```\n/tdd-workflow red → Write failing test\n/tdd-workflow green → Make it pass\n/tdd-workflow refactor → Clean up\n/tdd-workflow status → View all test status\n/tdd-workflow run-affected → Run related tests\n/tdd-workflow yolo → Auto-run mode\n/tdd-workflow coverage → Coverage report\n/tdd-workflow debug [file] → Debug failing test\n```\n\n## Best Practices\n\n1. **Test behavior, not implementation** — Refactor-friendly\n2. **One assertion per test** (mostly) — Clear failure messages\n3. **Descriptive names** — `it('should reject invalid email')`\n4. **Given-When-Then** — Structure: arrange, act, assert\n5. **Fast feedback** — < 1 second per test file\n6. **YOLO with care** — Only in well-tested codebases", "variables": [], "notes": "Test-Driven Development workflow with Cursor Test Panel and automated test execution", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/ZenRay/CursorTemplate", "path": ".cursor/commands/tdd-workflow.md", "ref": "0643e2b5863ee982562d545a9276c08523c183b8", "url": "https://github.com/ZenRay/CursorTemplate/blob/0643e2b5863ee982562d545a9276c08523c183b8/.cursor/commands/tdd-workflow.md", "key": "ZenRay/CursorTemplate/.cursor/commands/tdd-workflow.md" } } }

tdd-workflow

About