[getappz]

Design-spec for the systematic-debugging enforcement gate (item #168's greenlit candidate), authored in-session per PM-mode convention -- no code change. Mirrors the shipped verification-evidence gate (#169/PR #581): same SessionRecord/PostToolUse capture pattern, new DiagnosisEvidence tracking investigative git commands, gated behind metadata.task_type == "bugfix" via a backend DB lookup precedented by hook.rs's session_start_message. Full doc: crates/skill-registry/SYSTEMATIC_DEBUGGING_GATE_DESIGN.md. Implementation will be dispatched as a separate item per this project's design-spec-authorship convention.

---

Opened by claude-code on flared:51bb8de6c33b for item #203 via agentflare.

Summary by CodeRabbit

• Documentation
  • Added a design specification for a systematic-debugging completion gate.
  • Documents requirements for recording diagnostic evidence and verification evidence before completing bug-fix work.
  • Covers evidence preservation during changes, diagnostic command detection, task-type handling, and planned testing.
  • Clarifies scenarios that remain out of scope, including non-bug-fix work and retrospective history scans.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Essentials

Run ID: c5b96c31-ea37-4573-8fe3-b144366268a2

📥 Commits

Reviewing files that changed from the base of the PR and between faa6e09 and 2e4d529.

📒 Files selected for processing (1)

• crates/skill-registry/SYSTEMATIC_DEBUGGING_GATE_DESIGN.md

---

📝 Walkthrough

Walkthrough

The pull request adds a design specification for bugfix-specific systematic-debugging enforcement. It defines diagnosis evidence detection, session storage, hook capture, task-type lookup, completion-gate integration, fail-open behavior, tests, and explicit scope exclusions.

Changes

Systematic debugging gate

Layer / File(s)	Summary
Gate scope and detection rules crates/skill-registry/SYSTEMATIC_DEBUGGING_GATE_DESIGN.md	The design limits diagnosis enforcement to bugfix items and selects investigative Git commands for diagnosis detection.
Diagnosis evidence storage and capture crates/skill-registry/SYSTEMATIC_DEBUGGING_GATE_DESIGN.md	The specification adds DiagnosisEvidence, session diagnosis state, freshness rules, mutation retention, and PostToolUse capture.
Completion integration and validation crates/skill-registry/SYSTEMATIC_DEBUGGING_GATE_DESIGN.md	The design extends completion gating, resolves task type in pre_tool_use, fails open on lookup errors, and defines tests and scope exclusions.

Estimated code review effort: 1 (Trivial) | ~3 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch task/203-systematic-debugging-enforcement-gate-go

---

_{Comment @coderabbitai help to get the list of available commands.}