[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73924":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":16,"starSnapshotCount":16,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},73924,"tdd-guard","nizos\u002Ftdd-guard","nizos","Automated TDD enforcement for Claude Code","",null,"TypeScript",2182,167,15,16,0,7,19,82,21,28.68,"MIT License",false,"main",true,[27,28,29,30,31,32,33],"agentic-coding","automation","claude-code","code-quality","hooks","llm-tools","tdd","2026-06-12 02:03:19","# TDD Guard\n\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002Ftdd-guard.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Ftdd-guard)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdt\u002Ftdd-guard)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Ftdd-guard)\n[![CI](https:\u002F\u002Fgithub.com\u002Fnizos\u002Ftdd-guard\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fnizos\u002Ftdd-guard\u002Factions\u002Fworkflows\u002Fci.yml)\n[![Security](https:\u002F\u002Fgithub.com\u002Fnizos\u002Ftdd-guard\u002Factions\u002Fworkflows\u002Fsecurity.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fnizos\u002Ftdd-guard\u002Factions\u002Fworkflows\u002Fsecurity.yml)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](LICENSE)\n\nAutomated Test-Driven Development enforcement for Claude Code.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Ftdd-guard-demo.gif\" alt=\"TDD Guard blocking TDD violations\" width=\"1200\">\n\u003C\u002Fp>\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## 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. `\u002Fplugin marketplace add nizos\u002Ftdd-guard`\n2. `\u002Fplugin install tdd-guard@tdd-guard`\n3. `\u002Ftdd-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\u002Finstallation.md).\n\n## Configuration\n\n- [Custom instructions](docs\u002Fcustom-instructions.md) - Customize TDD validation rules\n- [Lint integration](docs\u002Flinting.md) - Automated refactoring support\n- [Strengthening enforcement](docs\u002Fenforcement.md) - Prevent agents from bypassing validation\n- [Ignore patterns](docs\u002Fignore-patterns.md) - Control which files are validated\n- [Validation Model](docs\u002Fvalidation-model.md) - Choose faster or more capable model\n- [All settings](docs\u002Fconfiguration.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:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fhooks#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\u002Fpytest support: [@Durafen](https:\u002F\u002Fgithub.com\u002FDurafen)\n- PHP\u002FPHPUnit support: [@wazum](https:\u002F\u002Fgithub.com\u002Fwazum)\n- Rust\u002Fcargo support: [@104hp6u](https:\u002F\u002Fgithub.com\u002F104hp6u)\n- Go support: [@sQVe](https:\u002F\u002Fgithub.com\u002FsQVe), [@wizzomafizzo](https:\u002F\u002Fgithub.com\u002Fwizzomafizzo)\n- Storybook support: [@akornmeier](https:\u002F\u002Fgithub.com\u002Fakornmeier)\n- Ruby\u002FRSpec & Minitest support: [@Hiro-Chiba](https:\u002F\u002Fgithub.com\u002FHiro-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## Related Projects\n\n### [Probity](https:\u002F\u002Fgithub.com\u002Fnizos\u002Fprobity)\n\nEnforces TDD and other policies across Claude Code, Codex, and Copilot. Works with any language and test runner. Uses session activity for validation, giving it a fuller picture when distinguishing refactors from new behavior.\n\nFor new projects, [Probity](https:\u002F\u002Fgithub.com\u002Fnizos\u002Fprobity) is the better starting point. Stay on TDD Guard if you use its lint integration. Probity doesn't have an equivalent yet.\n\n## Support\n\n- [Discussions](https:\u002F\u002Fgithub.com\u002Fnizos\u002Ftdd-guard\u002Fdiscussions) - Ask questions and share ideas\n- [Issues](https:\u002F\u002Fgithub.com\u002Fnizos\u002Ftdd-guard\u002Fissues) - Report bugs and request features\n\n## License\n\n[MIT](LICENSE)\n","TDD Guard 是一个用于 Claude Code 的自动化测试驱动开发（TDD）强制执行工具。它通过阻止在没有失败测试的情况下进行代码实现以及防止超出当前测试需求的过度编码，来确保代码遵循 TDD 原则。此外，该工具还支持与现有代码质量检查工具集成，并允许用户自定义验证规则以适应不同的 TDD 实践风格。TDD Guard 适用于希望提高代码质量和遵守严格TDD流程的软件开发团队，特别是那些使用Claude Code作为开发环境的团队。",2,"2026-06-11 03:47:56","high_star"]