test-driven-development-extras

Validate metrics on live data and enforce lint during TDD workflows.

Updated Nov 24, 2025
One-click install
npx skills add https://github.com/ByronWilliamsCPA/.claude --skill test-driven-development-extras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-driven-development-extras
Source: https://github.com/ByronWilliamsCPA/.claude/tree/main/.claude/skills/test-driven-development-extras
Command: npx skills add https://github.com/ByronWilliamsCPA/.claude --skill test-driven-development-extras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standard test-driven development workflows miss critical guardrails that lead to silent spec errors in metric design, avoidable cumulative linter threshold violations from small code changes, and broken intermediate code states caused by autofix formatter hooks, resulting in rework and undetected defects.

Core Features & Use Cases

  • Design-level metric falsification: Validates proposed scoring or heuristic metrics on real live data before implementation to catch spec errors that unit tests will never flag, preventing perfectly implemented but fundamentally flawed metrics.
  • Shared definition extraction for comparable values: Eliminates silent drift between duplicate formula implementations by extracting shared, separately tested helper functions for values that must match across different parts of the codebase.
  • GREEN-phase lint discipline: Runs project linters during the GREEN step of the TDD loop to catch cumulative complexity threshold violations early, when fixes are cheap, rather than at commit time when they require costly refactoring.
  • Autofix-safe edit sequencing: Stages code edits to prevent formatter autofixers from stripping unused imports or breaking intermediate code states, avoiding NameErrors that only surface during test collection. Use this skill when implementing a new scoring metric, adding a control-flow branch to a dense function, or working in a repository with active PostToolUse formatter hooks to eliminate common TDD pitfalls that standard workflows do not cover.

Quick Start

Use the test-driven-development-extras skill alongside your standard test-driven development workflow when implementing a new feature that computes a value matching an existing reported metric, adds a control-flow branch to an already dense function, or edits files in a repository with active autofix formatter hooks.

Frequently Asked Questions about test-driven-development-extras

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent silent spec errors when implementing new scoring metrics with test-driven development?

Design-level metric falsification validates proposed scoring metrics against real live data before implementation, catching spec errors that standard unit tests miss and preventing fundamentally flawed metrics from passing the TDD cycle.

Why does my formatter hook break intermediate code states during TDD refactoring?

Formatter autofixers strip unused imports and break intermediate code states during refactoring. Autofix-safe edit sequencing stages code edits to prevent NameErrors that only surface during test collection.

When do I need to run linters during the TDD loop instead of at commit time?

Run project linters during the GREEN step of the TDD loop to catch cumulative complexity threshold violations early when fixes are cheap, rather than at commit time when they require costly refactoring.

How do I avoid value drift between duplicate formula implementations across a codebase?

Extract shared, separately tested helper functions for values that must match across different parts of the codebase. This eliminates silent drift between duplicate formula implementations and ensures comparable cross-codebase values.

Does test-driven-development-extras work for adding control-flow branches to dense functions?

Yes, test-driven-development-extras applies to software engineering tasks adding control-flow branches to dense functions, staging edits safely to avoid broken intermediate states and cumulative lint threshold violations during the TDD workflow.