# Tdd

> >

- **Type:** Skill
- **Install:** `agentstack add skill-dianyike-claude-code-insights-tdd`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dianyike](https://agentstack.voostack.com/s/dianyike)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dianyike](https://github.com/dianyike)
- **Source:** https://github.com/dianyike/claude-code-insights/tree/main/examples/tdd

## Install

```sh
agentstack add skill-dianyike-claude-code-insights-tdd
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Test-Driven Development

Tests verify behavior through public interfaces, not implementation details. Always use vertical slices (one test -> one implementation -> repeat), never horizontal slices.

## Additional resources

- For TDD philosophy and anti-patterns, see [reference/philosophy.md](reference/philosophy.md)
- For good/bad test examples, see [examples/tests.md](examples/tests.md)
- For mocking guidelines, see [examples/mocking.md](examples/mocking.md)
- For deep module design, see [reference/deep-modules.md](reference/deep-modules.md)
- For interface testability, see [reference/interface-design.md](reference/interface-design.md)
- For refactor candidates, see [reference/refactoring.md](reference/refactoring.md)

## Workflow

### 1. Planning

- [ ] Identify what interface changes are needed
- [ ] Identify which behaviors to test (prioritize)
- [ ] Design interfaces for testability (accept deps, return results, small surface)
- [ ] List the behaviors to test (not implementation steps)

### 2. Tracer Bullet

Write ONE test that confirms ONE thing about the system:

```
RED:   Write test for first behavior -> test fails
GREEN: Write minimal code to pass -> test passes
```

### 3. Incremental Loop

For each remaining behavior:

```
RED:   Write next test -> fails
GREEN: Minimal code to pass -> passes
```

- One test at a time
- Only enough code to pass current test
- Don't anticipate future tests

### 4. Refactor

After all tests pass:

- [ ] Extract duplication
- [ ] Deepen modules (move complexity behind simple interfaces)
- [ ] Run tests after each refactor step

**Never refactor while RED.** Get to GREEN first.

## Checklist Per Cycle

- [ ] Test describes behavior, not implementation
- [ ] Test uses public interface only
- [ ] Test would survive internal refactor
- [ ] Code is minimal for this test
- [ ] No speculative features added

## Completion Criteria

- [ ] All planned behaviors have a corresponding test
- [ ] All tests pass (GREEN state)
- [ ] Refactor pass completed — no duplication, modules are deep
- [ ] No speculative code — every line justified by a test

## Gotchas

- **Iterate this section**: After each TDD session, append new gotchas here

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dianyike](https://github.com/dianyike)
- **Source:** [dianyike/claude-code-insights](https://github.com/dianyike/claude-code-insights)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dianyike-claude-code-insights-tdd
- Seller: https://agentstack.voostack.com/s/dianyike
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.