cc-quality-practices

cc-quality-practices

Improving quality reduces development cost. No single defect-detection technique exceeds ~75% effectiveness, so combine techniques — combining nearly doubles detection rates. Mature suites run about 5 dirty tests (error paths, bad data, edge cases) for every 1 clean test (happy path).

For active bug diagnosis (an actual failing test or repro to chase down), hand off: Read(${CLAUDE_PLUGIN_ROOT}/​skills/​cc-debugging/​SKILL.md). This skill is for QA planning and process design.

Shared CC vocabulary and thresholds (cohesion spectrum, coupling, key metrics): Read(${CLAUDE_PLUGIN_ROOT}/​references/​cc-foundations.md).

External vs internal quality

• External (users care): correctness, usability, efficiency, reliability, integrity, robustness.
• Internal (developers care): maintainability, flexibility, portability, reusability, readability, testability.

Internal quality enables external quality: poor maintainability blocks fixing defects, which degrades reliability.

Defect-detection techniques (detection rate)

Modes

CHECKER

Execute the quality, review, and testing checklists against the code or process. Checklists:

• Read(${CLAUDE_SKILL_DIR}/​checklists/​qa-and-testing.md) — QA plan, inspections, test cases, data-flow.
• Read(${CLAUDE_SKILL_DIR}/​checklists/​debugging.md) — finding, fixing, brute-force, general approach.

Output one row per item: | Item | Status | Evidence | Location |, status ∈ VIOLATION (fails item) / WARNING (partial) / PASS.

APPLIER

Produce test cases, review procedures, and quality plans.

Test-case generation (output: test-case list):

1. Identify requirements → one test per requirement.
2. Compute minimum tests: 1 + count(if/​while/​for/​and/​or) + case branches (add 1 if no default case).
3. Add data-flow tests covering all defined-used paths.
4. Add boundary tests: below, at, above each boundary.
5. Add dirty tests at ~5:1 — bad data, wrong size/​kind, uninitialized.
6. Add nominal tests: middle-of-road expected values.
7. Run with a coverage monitor — compare actual vs believed coverage.

Choosing a review method

When advising a human team's review process

Inspection roles and meeting mechanics apply when designing a review process for a human team (not for solo or agent work):

1. PLANNING — moderator distributes materials with line numbers + checklist.
2. PREPARATION — each reviewer works alone using the checklist (where ~90% of defects are found).
3. MEETING — reader paraphrases the code; scribe records defects.
4. REPORT — moderator lists each defect with type and severity.
5. REWORK — author fixes defects.
6. FOLLOW-UP — moderator verifies all fixes complete.

Chain