Grilling
ClawPatch Bug Discovery Grill Status
ClawPatch Bug Discovery Grill Status
| Branch | Closure | Locked Direction | Remaining Work |
|---|---|---|---|
Existing $debugging-phase role | 100% | Manual one-bug runtime/E2E evidence loop for concrete failures, reproductions, logs, recordings, and focused fixes. | None. |
| New discovery primitive | 100% | Create $bug-discovery-phase for AFK ClawPatch discovery/report/triage. | Define implementation artifact paths. |
| Discovery mutation boundary | 100% | Discovery stops at report/triage by default; no automatic fix --finding or open-pr. | Encode in skill/docs. |
| Provider and Claude cost posture | 100% | Claude is allowed, but configured Claude/Anthropic routes must be reported with clear AFK cost/billing warning. Provider should be explicit in generated goal/command. | Encode warning wording. |
| Tech-debt creation boundary | 100% | Discovery does not create repo debt docs; resolution creates debt docs after selected-finding classification. | Define debt artifact shape. |
| New resolution primitive | 100% | Create $bug-resolution-phase for selected ClawPatch finding resolution. | Write skill contract. |
| Resolution classification | 100% | Classify as resolve-now, needs-runtime-debugging, tech-debt, false-positive, or blocked. | Encode output contract. |
| Resolution patching engine | 100% | Normal Harness/Codex edits by default; ClawPatch for state, context, triage, and revalidation. | Encode command guidance. |
| Batch and parallel resolution | 100% | Default one finding; bounded batches allowed; parallel: true resolves batch findings in parallel with explicit ownership. Use $create-plan / $implement-spec-style hierarchy when decomposition is needed. | Define parallel worker contract. |
| Revalidation | 100% | Revalidate or update ClawPatch status after resolution or false-positive classification. | Encode validation gate. |
| Wiki framing | 100% | Present manual lifecycle: discover, inspect, choose, resolve. Do not advertise all-in-one discover-and-resolve as default. | Add wiki content later. |
| Skill placement | 80% | Recommended: source skills under apps/cli/skills/agnostic/debug/, mirrored into .agents/skills/. | Needs user lock. |
| Pack placement | 80% | Recommended: extend existing debug pack and add clawpatch as a required debug-pack tool. | Needs user lock. |
| Report naming | 80% | Recommended: .clawpatch/reports/bug-discovery-<YYYY-MM-DD>-<short-run-id>.md. | Needs user lock. |
| Debt artifact shape | 80% | Recommended: selected larger findings become docs debt entries under docs/reference/tech-debt/ with ClawPatch links and human-review questions. | Needs user lock. |
| Provider warning surface | 80% | Recommended: warning rules in both phase skills and CLI scaffold/runbook docs. | Needs user lock. |
| Dry-run fix inspection | 80% | Recommended: allow clawpatch fix --finding <id> --dry-run as optional inspection only. | Needs user lock. |
Current State
implemented in the wiki and CLI skill/catalog surfaces for $bug-discovery-phase and $bug-resolution-phase.
- Spec:
apps/wiki/content/docs/project/specs/cli/IP-170-clawpatch-bug-lifecycle/SPEC.md - Plan:
apps/wiki/content/docs/project/specs/cli/IP-170-clawpatch-bug-lifecycle/PLAN.md - Implementation notes:
apps/wiki/content/docs/project/specs/cli/IP-170-clawpatch-bug-lifecycle/IMPLEMENTATION-NOTES.md - Previous state:
spec-createdin the wiki.
Linear Backlog
Module: Harness Intelligence lifecycle.
Epic:
Stories:
- IP-171 Operator runs AFK ClawPatch bug discovery
- IP-172 Operator reviews and routes ClawPatch findings
- IP-173 Operator resolves selected bounded ClawPatch findings
- IP-174 Operator resolves bounded finding batches in parallel
- IP-175 Larger ClawPatch findings become durable tech-debt context
- IP-176 Scaffold distributes ClawPatch bug lifecycle phases
Native ordering:
- IP-172 is blocked by IP-171.
- IP-173 is blocked by IP-172.
- IP-174 is blocked by IP-173.
- IP-175 is blocked by IP-173.
- IP-176 is blocked by IP-171 and IP-173.
Closed Axioms
- ClawPatch findings are not proven runtime root causes.
$bug-discovery-phaseproduces a durable finding ledger.$bug-resolution-phaseowns selected finding classification and bounded resolution.$debugging-phaseis invoked when runtime/E2E evidence is needed.$docs-ingest-phasesurfaces larger selected findings as durable tech-debt/docs context after resolution classification.- ClawPatch patching is not the default Harness patching engine.
Open Questions
- Lock skill placement recommendation.
- Lock pack/tool placement recommendation.
- Lock report naming recommendation.
- Lock debt artifact recommendation.
- Lock provider warning surface recommendation.
- Lock dry-run fix inspection recommendation.