← Back to skills
Test-First Code ChangesHigh ReliabilityModerate-Risk Workflow

Test-First Change Guardrail

Encodes a deterministic red-green workflow for behavior-changing code updates and requires regression evidence before merge.

Version

0.1.0

Last Updated

Apr 22, 2026

Verification Type

unit tests, integration tests

Downloads

0

Required inputs

  • change_request (markdown)

    Bug report or feature acceptance criteria.

  • existing_tests (code)

    Current tests near impacted behavior.

Expected outputs

  • failing_test_patch (diff)

    Test updates that fail before implementation.

  • verification_log (text)

    Execution evidence that updated and regression tests pass.

Included checks and assets

  • scripts/check_test_plan.py (script)

    Validates test-first plan sections.

  • references/checklist.md (reference)

    Compact execution checklist for test-first delivery.

  • references/test-design-patterns.md (reference)

    Deterministic test design patterns for reproducible behavior checks.

  • references/flaky-test-triage.md (reference)

    Playbook for identifying and remediating flaky tests.

Failure modes

  • Tests created after implementation hide root cause.
  • Regression suite misses neighboring modules.
  • Plans skip explicit baseline behavior capture.

Ideal use cases

  • Critical bug fixes
  • Behavioral feature updates
  • High-risk pull requests

Example runs

Tax rounding bug fix

Validated sample run

Captures off-by-one cent failure before changing calculator logic.

Input preview

Bug report + failing unit test

Output preview

Passing focused tests + full regression log

Changelog summary

  • 0.1.0 · Apr 22, 2026

    Initial release for deterministic test-first workflows.

Links

Inspect the source, read authored documentation, or download the published skill bundle.