Converted and distributed by TomeVault — claim your Tome and manage your conversions.
Coder System Design Testable Code
Testability-first design rules for modular, deterministic, and verifiable systems. Use when this capability is needed.
tomevault-io
Updated Coder System Design Testable Code by tomevault-io · 75f7ed4
npx skillmds@latest add tomevault-io/coder-system-design-testable-code File contents
---name: coder-system-design-testable-codedescription: Testability-first design rules for modular, deterministic, and verifiable systems. Use when this capability is needed.---<when_to_use> <trigger>Designing modules, services, or boundaries that must stay easy to test</trigger> <trigger>Refactoring hard-to-test legacy code paths</trigger> <trigger>Establishing test strategy for new architecture components</trigger></when_to_use><input_requirements> <required>Critical business paths and failure modes</required> <required>Current test stack and CI constraints</required> <required>External dependencies and integration boundaries</required> <required>Determinism risks (time, randomness, concurrency, network)</required></input_requirements><design_principles> <principle priority="P0">Use dependency inversion and dependency injection for replaceable collaborators</principle> <principle priority="P0">Create explicit seams at IO, time, random, and external service boundaries</principle> <principle priority="P0">Favor deterministic execution in tests with controllable clocks and inputs</principle> <principle priority="P1">Prefer many fast unit and component tests with targeted integration coverage</principle> <principle priority="P1">Use contract tests for service boundaries to prevent integration drift</principle> <principle priority="P1">Make failures diagnosable with structured test logs and trace correlation</principle></design_principles><testability_checklist> <item>Business logic can run without network or real infrastructure in core tests</item> <item>External calls are abstracted through interfaces/ports</item> <item>Tests do not depend on execution order or shared mutable state</item> <item>Flaky signals are tracked and have explicit remediation ownership</item> <item>Boundary contracts are validated in CI before deployment</item></testability_checklist><quality_rules> <rule importance="critical">No critical change is complete without tests that prove behavior</rule> <rule importance="critical">No unstable test should be silently ignored; quarantine requires owner and timeline</rule> <rule importance="high">No hidden dependency should bypass injection seam on critical path</rule> <rule importance="high">No long-running broad test should replace missing fast deterministic tests</rule></quality_rules><do_not> <item importance="critical">Do not hardcode infrastructure clients in business logic</item> <item importance="high">Do not use sleep-based timing guesses when deterministic sync is possible</item> <item importance="high">Do not over-mock internals instead of validating behavior contracts</item> <item importance="high">Do not hide flaky failures by indiscriminate retries</item></do_not><output_requirements> <requirement>Design boundaries and seams introduced or validated</requirement> <requirement>Test strategy per layer (unit/component/integration/contract)</requirement> <requirement>Determinism controls and flaky-risk mitigation</requirement> <requirement>Evidence from CI/local checks and remaining risks</requirement></output_requirements><references> <source url="https://martinfowler.com/bliki/TestPyramid.html">Martin Fowler Test Pyramid</source> <source url="https://martinfowler.com/articles/practical-test-pyramid.html">Practical Test Pyramid</source> <source url="https://martinfowler.com/bliki/LegacySeam.html">Legacy Seam</source> <source url="https://martinfowler.com/articles/nonDeterminism.html">Eradicating Non-Determinism in Tests</source> <source url="https://martinfowler.com/bliki/ContractTest.html">Contract Test</source> <source url="https://docs.pact.io/pact_broker">Pact Broker</source> <source url="https://abseil.io/resources/swe-book/html/ch11.html">Software Engineering at Google: Testing Overview</source> <source url="https://opentelemetry.io/docs/concepts/instrumentation/">OpenTelemetry Instrumentation</source></references>---> Converted and distributed by [TomeVault](https://tomevault.io/claim/ozerohax) — claim your Tome and manage your conversions.<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io/skills-registry/tree/main/ozerohax--assistagents--testable-code commit 75f7ed474c
Frequently asked questions
Run npx skillmds@latest add tomevault-io/coder-system-design-testable-code in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Testability-first design rules for modular, deterministic, and verifiable systems. Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.