Skip to main content

CAR-NNNN: Short defect title

Status​

Open | Resolved | Prevented | Accepted — YYYY-MM-DD

References​

  • Issue: #
  • Introducing change: Unknown | #
  • Corrective pull request: #
  • Related ADRs: None | ADR-XXXX

Defect​

Describe the violated expectation, the structural, architectural, behavioral, or code-quality drift, its scope, and the observable evidence.

Detection​

  • Stage: Code review | Tests/CI | Post-merge | Production
  • Detection mechanism:
  • Why it was not detected earlier:

Causal analysis​

Faulty approach​

Describe the approach taken by the AI-generated or AI-assisted change and the concrete part that was inadequate.

Contributing assumptions​

List incorrect or unsupported assumptions that materially contributed to the defect.

Missed signals​

Identify repository instructions, established patterns, tests, review evidence, or architectural boundaries that should have exposed the defect.

Safeguard gap​

Explain why existing tests, automation, review, or documentation did not prevent or detect the defect earlier.

Resolution​

Describe the implemented correction and why it restores the expected structure or behavior.

Prevention​

Document the durable safeguard added to prevent recurrence, such as a focused test, architecture rule, agent instruction, validation script, or clarified ADR. If no additional safeguard is justified, explain why.

Validation​

List only the checks actually performed and their results.

Last updated on