test-discipline

Update test assertions in the same commit as API changes.

3|5|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/ronniegeraghty/hyoka --skill test-discipline-ronniegeraghty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-discipline
Source: https://github.com/ronniegeraghty/hyoka/tree/main/.agents/skills/test-discipline
Command: npx skills add https://github.com/ronniegeraghty/hyoka --skill test-discipline-ronniegeraghty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When APIs or public interfaces change, tests must be updated in the same commit to keep the project CI healthy. Stale tests cause false positives/negatives and block contributors.

Core Features & Use Cases

  • In-commit test synchronization: Update test assertions whenever APIs evolve to reflect the new behavior.
  • Disk-state alignment: Ensure test expectations match the actual files and counts on disk to avoid flaky CI.
  • CI reliability: Use in-repo guidelines to prevent regressions by enforcing synchronized test updates in the same change.

Quick Start

Update related tests in the same commit as API changes to maintain green CI.

Frequently Asked Questions about test-discipline

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

FAQPage Schema
How do I keep tests in sync with API changes to prevent flaky CI?

To keep tests in sync with API changes, update test assertions in the same commit as the source modifications. This disk-state alignment ensures test expectations match actual files, preventing flaky CI runs and false negatives.

Why do stale tests cause false positives and block contributors in CI?

Stale tests cause false positives and block contributors because test expectations no longer match the evolved public interfaces. Synchronizing test updates within the same commit maintains CI reliability and prevents regressions.

What is the best way to align test expectations with disk state across CI runs?

The best way to align test expectations with disk state is to enforce in-repo guidelines requiring test updates in the same commit as API changes. This ensures validated counts and expectations match actual files across CI runs.

When do I need to update test assertions for evolving public interfaces?

You need to update test assertions for evolving public interfaces whenever API changes occur. Strict synchronization between source changes and corresponding test updates prevents false negatives and maintains a healthy project CI.

Does enforcing in-commit test synchronization work for projects with frequently evolving APIs?

Yes, in-commit test synchronization works for projects with frequently evolving public interfaces. It ensures test counts and expectations are validated against disk state, maintaining CI reliability and preventing regressions when APIs change.