swingerman

swingerman / atdd

Public

Acceptance Test Driven Development for Claude Code — inspired by Uncle Bob's approach from empire-2025

acceptance-testing ai-development atdd bdd claude-code
79
4
100% credibility
Found Feb 17, 2026 at 34 stars 2x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

A plugin for Claude Code that enforces Acceptance Test Driven Development by prompting users to write plain-language specs first, generating project-tailored tests, and reminding to verify both acceptance and unit tests pass.

How It Works

1
🔍 Discover the Guide

You hear about a helpful plugin for your AI coding buddy that ensures you plan features with simple checklists before jumping into code.

2
📥 Add It Easily

You pick it up from the plugin store inside your AI tool and add it with a quick tap, ready to use right away.

3
💬 Start a New Feature

Chat with your AI and say what new ability you want, like user sign-ups, and it guides you to describe it plainly.

4
✏️ Write Plain Checklists

You jot down easy sentences like 'when a user signs up, they get added to the list' – no tech talk, just what should happen.

5
🧪 Create Matching Tests

Your AI studies your project and makes custom tests that check if your checklists work, so everything stays on track.

6
🔄 Build Until It Works

You add code bit by bit, running checks from both your checklists and details, feeling confident as greens light up everywhere.

✅ Reliable Project Ready

Your software now behaves exactly as planned, with solid structure that grows reliably for future features.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 34 to 79 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is atdd?

atdd is a Shell-based Claude Code plugin that enforces acceptance test driven development (ATDD) workflows, inspired by Uncle Bob's Spec Driven Design. You write human-readable Given/When/Then specs in domain language before coding, and it generates project-specific acceptance test pipelines tailored to your language and framework like pytest or Jest. It solves AI coding pitfalls like unconstrained code drops and implementation leakage into specs, ensuring dual streams of acceptance testing and unit tests both pass via reminders and checks.

Why is it gaining traction?

Unlike generic tools, it builds bespoke parsers with deep codebase knowledge, skipping manual fixtures while catching leaks with commands like /atdd:spec-check. Developers dig the Uncle Bob hook—ATDD vs TDD discipline for AI, boosting acceptance rates like GitHub Copilot but with github acceptance criteria enforced. Hooks warn pre-code and remind on stops, making ATDD testing feel natural without Big Up-Front Design.

Who should use this?

Backend devs building APIs with Claude Code, needing acceptance test cases before features like user auth. Teams debating ATDD vs BDD or ATDD vs TDD, wanting procedures (ATP) for reliable AI output across Python, JS, Java. Frontend or full-stack folks generating acceptance test reports from specs, tired of flaky AI unit tests alone.

Verdict

Try it if you're deep in Claude Code and want ATDD full form structure—solid docs and multi-language support shine despite 26 stars and 1.0% credibility score signaling early maturity. Low adoption means test it on a side project first; potential grows with contributions.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.