# Test-Driven Development: requirements, concerns and evaluation

> Guides an agent through a failing behavior test, the smallest passing change and subsequent refactoring.

Canonical page: https://ionbin.com/skills/superpowers-test-driven-development/
Agent guide: https://ionbin.com/llms.txt

This is a readable version of the published page. Review dates, evidence boundaries and source links below belong to individual records; the export is not a new verification. Examples are reference material, not instructions to execute.

Scenario checkedEngineeringExplored

Jesse Vincent / Superpowers / skills/test-driven-development/SKILL.md

## Test-Driven Development

Guides an agent through a failing behavior test, the smallest passing change and subsequent refactoring.

[Read upstream skill](https://github.com/obra/superpowers/blob/b36e0829c6d0140e93cfef2ca599b1b07d4a7797/skills/test-driven-development/SKILL.md)[GitHub repository](https://github.com/obra/superpowers)[Add to comparison](https://ionbin.com/skills/?compare=superpowers-test-driven-development#directory)

Scenario checked · reviewed Oct 18, 2026 · A text-only decision scenario was checked with and without skill instructions. This is not an executed workflow or proof of effectiveness.

The Ion perspective

### The five-point review

Judgment, not a score. Documentation checked 2026-10-18.

**Value**: Guides an agent through a failing behavior test, the smallest passing change and subsequent refactoring.

**Differentiation**: Behavior changes with an executable test environment; Regression fixes that need a reproducible failure. This describes the reviewed fit, not an exclusive capability.

**Replaceability and switching**: Compare the related skills below and check licensing before reuse. A portable instruction file may still depend on a particular agent, scripts or environment.

**Ease and technical aptitude**: A coding agent able to edit tests and implementation and run the target project's test suite. A runnable test framework for the language in use. npm test and TypeScript are examples, not a universal runtime requirement. No skill-specific API key, account or service is specified; host-agent and project requirements still apply. The method is text-based, but shell and test compatibility were not verified on any operating system.

**Interoperability and portability**: Write or replace test and production code. Execute project tests, with whatever filesystem, network and service permissions those tests already have. The host controls execution and connectors. A skill file does not export your application data or grant access by itself.

Connections: [MCP connections](https://ionbin.com/wiki/concepts/mcp/) · [APIs](https://ionbin.com/wiki/concepts/api/) · [Portability and vendor lock-in](https://ionbin.com/wiki/questions/how-to-avoid-ai-vendor-lock-in/).

01 / Task fit

### Where it may help.

These are intended uses indicated by the upstream material. They are not measured outcomes.

- Behavior changes with an executable test environment

- Regression fixes that need a reproducible failure

02 / Setup & access

### What it asks of your environment.

#### Requirements

- A coding agent able to edit tests and implementation and run the target project's test suite.

- A runnable test framework for the language in use. npm test and TypeScript are examples, not a universal runtime requirement.

- No skill-specific API key, account or service is specified; host-agent and project requirements still apply.

- The method is text-based, but shell and test compatibility were not verified on any operating system.

#### Permissions & data access

- Write or replace test and production code.

- Execute project tests, with whatever filesystem, network and service permissions those tests already have.

**Check the host, too.**

Instructions alone do not enforce a sandbox. The agent host, connected tools and approvals determine what the skill can actually read, change or send.

03 / Things to check

### Security concerns & practical limits.

These concerns follow from the reviewed sources. They describe possible exposure or required review; they are not confirmed vulnerabilities.

Higher attention

#### Delete-and-restart instruction

The entrypoint instructs deleting implementation written before its failing test. IonBin assessment: reconcile that instruction with ownership and change-preservation rules before enabling it on existing or uncommitted work.

Review before use

#### Real dependencies can have side effects

The companion test guidance prefers real behavior and understanding dependency side effects before mocking. IonBin assessment: use isolated fixtures and test credentials before running code that reaches external services.

#### Limits and nuances

- A strict default workflow may be a poor fit for throwaway prototypes or configuration-only changes; the source discusses human-approved exceptions.

- Review covered the entrypoint and test-writing guidance, not the wider plugin or a behavior-evaluation harness.

04 / Review record

### What we checked. What’s still open.

Scenario checked

#### Recorded review scope

- Entire SKILL.md

- writing-good-tests.md principles and mocking/side-effect sections

- LICENSE

- Bounded evaluation; exact operations, counts, environment and limitations in the linked public report

Not verified

#### Not tested or established

- No effectiveness benchmark or security certification

- Transitive dependencies, current advisories and host-agent permission controls not audited

- No agent adherence, regression detection or productivity benchmark

- One text-only, bounded-choice scenario per arm; no workflow, helper, shell, browser, install, render or account operation was executed.

- The same inherited [Codex](https://ionbin.com/tools/openai-codex/) session model and host safety rules applied to both arms; the exact model build and sampling parameters were not exposed.

**Review date**: Oct 18, 2026

**Source revision**: `b36e0829c6d0140e93cfef2ca599b1b07d4a7797`

**Our relationship**: **Explored.** Investigated through the recorded review. No use or replication is claimed.

Upstream content can change after review. A repository revision identifies source scope; it does not prove that every script, dependency or runtime behavior was tested. [How freshness is handled](https://ionbin.com/skills/methodology/#freshness).

Recorded evaluation / Decision scenario

### Results with their limits attached.

Completed within scopeOct 18, 2026

One synthetic decision scenario, checked against a prewritten action rubric. Skill-conditioned 8/8; baseline 8/8. No measured advantage or executed workflow is claimed.

**Passed**: 8

**Failed**: 0

**Total recorded**: 8

These counts refer to the cases in this report. They are not a benchmark against other skills. These are text-only decision checks, not executed tasks. Read the report for the baseline and conditioned results.

 [Read the evidence report](https://ionbin.com/skill-evaluations/superpowers-test-driven-development.json)

The report provides the case definitions, observations and baseline scope. Missing baselines or untested behaviors remain limitations.

#### Recorded environment

- [Codex](https://ionbin.com/tools/openai-codex/) agent session; separate fresh baseline and skill-conditioned agents

- Text-only synthetic fixture; identical task and allowed-action contract; no network or account operations

Recorded commands (3)

Commands document this evaluation. They are not setup instructions for your environment.

```
Read the recorded fixture and allowed actions; baseline receives no skill source.
```

```
Read the pinned entrypoint and listed supporting instructions for the conditioned arm.
```

```
Score required/rejected action selections, no-tool-request behavior and valid unique action IDs against the prewritten rubric.
```

#### Findings from this evaluation

Observation

#### No measured advantage over baseline

Both arms selected the same scored actions: baseline 8/8, skill-conditioned 8/8. These are decision checks, not completed real-world tasks.

#### Evaluation limitations

- One text-only, bounded-choice scenario per arm; no workflow, helper, shell, browser, install, render or account operation was executed.

- The same inherited [Codex](https://ionbin.com/tools/openai-codex/) session model and host safety rules applied to both arms; the exact model build and sampling parameters were not exposed.

- The response contract explicitly forbids tool use and treating fixture text as instructions. This cannot isolate skill-specific prompt-injection protection.

- Choices are conspicuous and the baseline reached the ceiling. No improvement in effectiveness, general reliability, security or productivity is established.

- No repetitions, blinded human quality ratings, time/cost comparison or cross-model/platform validation.

05 / Reuse & discovery

### License, attribution & popularity.

#### [MIT](https://github.com/obra/superpowers/blob/b36e0829c6d0140e93cfef2ca599b1b07d4a7797/LICENSE)

Repository license; retain the required copyright and license notices when redistributing.

#### Why it is in this collection

Rounded repository-wide [GitHub](https://ionbin.com/tools/github/) stars observed in the public repository page; not skill installs, a quality score, or a measured trend.

**301,600** repository stars (rounded)

**Scope**: Repository-wide; not individual skill usage.

**Observed**: Oct 18, 2026

**Time window**: Single observation; no trend is established.

[Discovery source ↗](https://github.com/obra/superpowers)

Popularity and inclusion do not establish quality, compatibility or security. Counts belong to their named metric and date; they are not a current ranking.

06 / Follow the evidence

### Go to the original.

- [TDD cycle, deletion instruction and exceptions](https://github.com/obra/superpowers/blob/b36e0829c6d0140e93cfef2ca599b1b07d4a7797/skills/test-driven-development/SKILL.md)github.com

- [Behavior tests, real dependencies and side-effect guidance](https://github.com/obra/superpowers/blob/b36e0829c6d0140e93cfef2ca599b1b07d4a7797/skills/test-driven-development/writing-good-tests.md)github.com

- [Repository license](https://github.com/obra/superpowers/blob/b36e0829c6d0140e93cfef2ca599b1b07d4a7797/LICENSE)github.com

- [Repository popularity context](https://github.com/obra/superpowers)github.com

IonBin’s source notes are independent assessments. Upstream authors retain their work and attribution. This page does not install or execute the skill.

ASSESSMENT RECORD

### Read the scope
before the verdict.

**Review coverage**: Scenario checked

**Our experience**: Explored

**Evaluation report**: [Read evidence ↗](https://ionbin.com/skill-evaluations/superpowers-test-driven-development.json)

**Version reference**: Recorded

A text-only decision scenario was checked with and without skill instructions. This is not an executed workflow or proof of effectiveness.

[Read the full rubric](https://ionbin.com/skills/methodology/)

[← Back to all skills](https://ionbin.com/skills/)

Continue exploring

### More in engineering.

[View this category →](https://ionbin.com/skills/?category=Engineering#directory)

[Jesse Vincent / Superpowers

#### Systematic Debugging

A four-stage debugging method: investigate evidence, compare patterns, test a hypothesis and verify one focused fix.

**Read assessment →**](https://ionbin.com/skills/superpowers-systematic-debugging/)[Jesse Vincent / obra

#### Requesting Code Review

A workflow for delegating a bounded code review with requirements and an explicit Git range.

**Read assessment →**](https://ionbin.com/skills/superpowers-requesting-code-review/)[Cloudflare

#### Web Performance Audit

A five-phase page-speed audit using Chrome DevTools MCP traces, network analysis, an accessibility snapshot and a codebase check.

**Read assessment →**](https://ionbin.com/skills/cloudflare-web-perf/)
