Skill

init

Initialize workspace TDD Guardian config and enable strict hooks for test/coverage enforcement.

Install

Run in your terminal

npx claudepluginhub xiaolai/claude-plugin-marketplace --plugin tdd-guardian

Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

Similar Skills

skill-lookup

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

157.5k

prompt-lookup

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

157.5k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

ecc

140.7k

Stats

Stars0

Forks0

Last CommitMar 10, 2026

Actions

View Source View Plugin View on GitHub View README

Steps

Detect package manager and test stack from project files.

Propose commands for:

testCommand
coverageCommand
mutationCommand (optional)

Ask the user whether to enable blocking hooks:

enforceOnTaskCompleted — run gates automatically on task completion
blockCommitWithoutFreshGate — block commit/push/publish without fresh gates
Default: both false (non-blocking). Skills, agents, and slash commands still work — only automatic blocking is opt-in.

Write config file.

Default config template:

{ "enabled": true, "enforceOnTaskCompleted": false, "blockCommitWithoutFreshGate": false, "gateFreshnessMinutes": 120, "bypassEnv": "TDD_GUARD_BYPASS", "preflightCommand": "", "testCommand": "pnpm test", "coverageCommand": "pnpm test -- --coverage", "coverageSummaryPath": "coverage/coverage-summary.json", "coverageThresholds": { "lines": 100, "functions": 100, "branches": 100, "statements": 100 }, "coverageMode": "absolute", "smartStaleness": true, "requireMutation": false, "mutationCommand": "" }

Coverage mode

"absolute" (default): must meet configured thresholds

"no-decrease": blocks only if coverage decreased from recorded baseline (useful for projects with pre-existing coverage gaps)

Smart staleness

When smartStaleness: true (default), stale gate timestamps are allowed if no source files have changed since the last gate pass. This prevents unnecessary re-runs when stepping away from the project.

If project is not Node-based, replace commands with project-native equivalents.

Initialize TDD Guardian

Create .claude/tdd-guardian/config.json using project-appropriate commands.

Steps

Detect package manager and test stack from project files.
Propose commands for:
- testCommand
- coverageCommand
- mutationCommand (optional)
Ask the user whether to enable blocking hooks:
- enforceOnTaskCompleted — run gates automatically on task completion
- blockCommitWithoutFreshGate — block commit/push/publish without fresh gates
- Default: both false (non-blocking). Skills, agents, and slash commands still work — only automatic blocking is opt-in.
Write config file.

Default config template:

{
  "enabled": true,
  "enforceOnTaskCompleted": false,
  "blockCommitWithoutFreshGate": false,
  "gateFreshnessMinutes": 120,
  "bypassEnv": "TDD_GUARD_BYPASS",
  "preflightCommand": "",
  "testCommand": "pnpm test",
  "coverageCommand": "pnpm test -- --coverage",
  "coverageSummaryPath": "coverage/coverage-summary.json",
  "coverageThresholds": {
    "lines": 100,
    "functions": 100,
    "branches": 100,
    "statements": 100
  },
  "coverageMode": "absolute",
  "smartStaleness": true,
  "requireMutation": false,
  "mutationCommand": ""
}

Coverage mode

"absolute" (default): must meet configured thresholds
"no-decrease": blocks only if coverage decreased from recorded baseline (useful for projects with pre-existing coverage gaps)

Smart staleness

If project is not Node-based, replace commands with project-native equivalents.