{"id":29756296,"url":"https://github.com/nizos/tdd-guard","last_synced_at":"2026-04-19T19:06:28.364Z","repository":{"id":303391664,"uuid":"1015280784","full_name":"nizos/tdd-guard","owner":"nizos","description":"Automated TDD enforcement for Claude Code","archived":false,"fork":false,"pushed_at":"2026-04-18T10:16:44.000Z","size":2059,"stargazers_count":1992,"open_issues_count":32,"forks_count":148,"subscribers_count":15,"default_branch":"main","last_synced_at":"2026-04-18T12:18:53.322Z","etag":null,"topics":["agentic-coding","automation","claude-code","code-quality","hooks","llm-tools","tdd"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nizos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-07T09:14:14.000Z","updated_at":"2026-04-18T10:16:49.000Z","dependencies_parsed_at":"2025-07-15T12:12:03.718Z","dependency_job_id":"8ba9a497-629f-4b3c-a1f7-27f45e8ee6d6","html_url":"https://github.com/nizos/tdd-guard","commit_stats":null,"previous_names":["nizos/tdd-guard"],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/nizos/tdd-guard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nizos%2Ftdd-guard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nizos%2Ftdd-guard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nizos%2Ftdd-guard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nizos%2Ftdd-guard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nizos","download_url":"https://codeload.github.com/nizos/tdd-guard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nizos%2Ftdd-guard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32018774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-coding","automation","claude-code","code-quality","hooks","llm-tools","tdd"],"created_at":"2025-07-26T17:00:42.004Z","updated_at":"2026-04-19T19:06:28.359Z","avatar_url":"https://github.com/nizos.png","language":"TypeScript","funding_links":[],"categories":["Hooks 🪝","TypeScript","Tools \u0026 Utilities","🎯 Project Management \u0026 Orchestration","HarmonyOS","automation","Testing \u0026 Security","AI Coding Agents","Other","Dependency Sources","Skills \u0026 Plugins","钩子 🪝"],"sub_categories":["General","📖 Community Guides \u0026 Tutorials","Windows Manager","Other IDEs","Claude Code","Full Stack Examples","通用"],"readme":"# TDD Guard\n\n[![npm version](https://badge.fury.io/js/tdd-guard.svg)](https://www.npmjs.com/package/tdd-guard)\n[![npm downloads](https://img.shields.io/npm/dt/tdd-guard)](https://www.npmjs.com/package/tdd-guard)\n[![CI](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml/badge.svg)](https://github.com/nizos/tdd-guard/actions/workflows/ci.yml)\n[![Security](https://github.com/nizos/tdd-guard/actions/workflows/security.yml/badge.svg)](https://github.com/nizos/tdd-guard/actions/workflows/security.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nAutomated Test-Driven Development enforcement for Claude Code.\n\n## Overview\n\nTDD Guard ensures Claude Code follows Test-Driven Development principles. When your agent tries to skip tests or over-implement, TDD Guard blocks the action and explains what needs to happen instead.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nizar.se/uploads/videos/tdd-guard-demo.mp4\"\u003e\n    \u003cimg src=\"docs/assets/tdd-guard-demo-screenshot.gif\" alt=\"TDD Guard Demo\" width=\"600\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  \u003cem\u003eClick to watch TDD Guard in action\u003c/em\u003e\n\u003c/p\u003e\n\n## Features\n\n- **Test-First Enforcement** - Blocks implementation without failing tests\n- **Minimal Implementation** - Prevents code beyond current test requirements\n- **Lint Integration** - Enforces refactoring using your linting rules\n- **Customizable Rules** - Adjust validation rules to match your TDD style\n- **Flexible Validation** - Choose faster or more capable models for your needs\n- **Session Control** - Toggle on and off mid-session\n\n## Getting Started\n\n### Requirements\n\n- Node.js 22+\n- A supported test framework (Vitest, Jest, Storybook, pytest, PHPUnit, Go, Rust, RSpec, Minitest)\n\n### Installation\n\nOpen Claude Code in your project and run:\n\n1. `/plugin marketplace add nizos/tdd-guard`\n2. `/plugin install tdd-guard@tdd-guard`\n3. `/tdd-guard:setup`\n\nThis adds the marketplace, installs the plugin, and configures the test reporter for your project. You may need to restart your terminal session or IDE extension for the setup skill to appear. For manual installation and configuration, see the [installation guide](docs/installation.md).\n\n## Configuration\n\n- [Custom instructions](docs/custom-instructions.md) - Customize TDD validation rules\n- [Lint integration](docs/linting.md) - Automated refactoring support\n- [Strengthening enforcement](docs/enforcement.md) - Prevent agents from bypassing validation\n- [Ignore patterns](docs/ignore-patterns.md) - Control which files are validated\n- [Validation Model](docs/validation-model.md) - Choose faster or more capable model\n- [All settings](docs/configuration.md) - Complete settings documentation\n\n## Security\n\nTDD Guard hooks run with your user permissions. We maintain automated security scanning, dependency audits, and welcome source code review. See [Claude Code's security considerations](https://docs.anthropic.com/en/docs/claude-code/hooks#security-considerations) for more on hook safety.\n\n## Development\n\n### Contributing\n\nContributions are welcome! See the [contributing guidelines](CONTRIBUTING.md) to get started.\n\n**Contributors:**\n\n- Python/pytest support: [@Durafen](https://github.com/Durafen)\n- PHP/PHPUnit support: [@wazum](https://github.com/wazum)\n- Rust/cargo support: [@104hp6u](https://github.com/104hp6u)\n- Go support: [@sQVe](https://github.com/sQVe), [@wizzomafizzo](https://github.com/wizzomafizzo)\n- Storybook support: [@akornmeier](https://github.com/akornmeier)\n- Ruby/RSpec \u0026 Minitest support: [@Hiro-Chiba](https://github.com/Hiro-Chiba)\n\n### Roadmap\n\n- Expand language and test framework support\n- Validate file modifications made through MCPs and shell commands\n- Encourage meaningful refactoring opportunities when tests are green\n- Add support for multiple concurrent sessions per project\n\n## Support\n\n- [Discussions](https://github.com/nizos/tdd-guard/discussions) - Ask questions and share ideas\n- [Issues](https://github.com/nizos/tdd-guard/issues) - Report bugs and request features\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnizos%2Ftdd-guard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnizos%2Ftdd-guard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnizos%2Ftdd-guard/lists"}