Claude Code TDD: Force Red-Green-Refactor with Hooks & CLAUDE.md (2026)

## Development workflow — STRICT TDD (always follow this order)

1. **RED**: Write a failing test first. Run `npm test` — confirm it FAILS.
   Do NOT write implementation before this step.

2. **GREEN**: Write the minimum code to make the test pass.
   Run `npm test` — confirm ALL tests pass.

3. **REFACTOR**: Clean up without changing behavior.
   Run tests after every change.

**Rules:**
- Never write implementation without a failing test first.
- Never write more implementation than the current test requires.
- One cycle at a time: RED → GREEN → REFACTOR before the next feature.

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npm test -- --reporter=verbose 2>&1 | tail -20"
          }
        ]
      }
    ]
  }
}

Build a `validatePassword` function. Follow TDD per CLAUDE.md:
write the test first, confirm RED, then implement.

Requirements: 8+ chars, 1 uppercase, 1 number.
Returns { valid: boolean, errors: string[] }

// src/lib/password.test.ts
describe('validatePassword', () => {
  it('returns valid for a strong password', () => {
    expect(validatePassword('SecurePass1')).toEqual({ valid: true, errors: [] })
  })

  it('fails when too short', () => {
    const result = validatePassword('Sh0rt')
    expect(result.valid).toBe(false)
    expect(result.errors).toContain('Password must be at least 8 characters')
  })

  it('fails when no uppercase', () => {
    const result = validatePassword('lowercase1')
    expect(result.errors).toContain('Password must contain at least one uppercase letter')
  })

  it('fails when no number', () => {
    const result = validatePassword('NoNumbers')
    expect(result.errors).toContain('Password must contain at least one number')
  })
})

// src/lib/password.ts
export function validatePassword(password: string) {
  const errors: string[] = []

  if (password.length < 8) errors.push('Password must be at least 8 characters')
  if (!/[A-Z]/.test(password)) errors.push('Password must contain at least one uppercase letter')
  if (!/[0-9]/.test(password)) errors.push('Password must contain at least one number')

  return { valid: errors.length === 0, errors }
}

// src/components/PasswordInput.test.tsx
describe('PasswordInput', () => {
  it('renders input with label', () => {
    render(<PasswordInput label="Password" />)
    expect(screen.getByLabelText('Password')).toBeInTheDocument()
  })

  it('toggles password visibility', async () => {
    const user = userEvent.setup()
    render(<PasswordInput label="Password" />)

    const input = screen.getByLabelText('Password')
    expect(input).toHaveAttribute('type', 'password')

    await user.click(screen.getByRole('button', { name: /show password/i }))
    expect(input).toHaveAttribute('type', 'text')
  })

  it('shows strength indicator', async () => {
    const user = userEvent.setup()
    render(<PasswordInput label="Password" />)

    await user.type(screen.getByLabelText('Password'), 'StrongPass1')
    expect(screen.getByText('Strong')).toBeInTheDocument()
  })
})

Add: at least one special character. Write the failing test first.

Stop. You wrote implementation before the test.
Delete `src/lib/feature.ts`. Write the test first, confirm RED, then implement.

# .husky/pre-commit
#!/bin/sh
npm test -- --run