这是一篇由原始材料转换而来的阅读页，保留了源文件的主要结构，并补充了可追溯的来源说明与链接。

Framework 3 — Bug Reproduction / Fix / Regression Factory

Use this when the main workload is diagnosing and fixing bugs rapidly.

Intent

Give the agent a strong closed loop for: reproduce -> inspect -> fix -> verify -> guard against regressions.

Core components

• reproducible bug reports in plans/active/
• scripts/repro.sh or issue-specific repro scripts
• screenshot / DOM capture / browser automation for UI bugs
• logs / metrics / traces for runtime bugs
• regression test or smoke step added before closing the task

Recommended folders

• docs/runbooks/debugging.md
• artifacts/bugs/<id>/
• plans/active/bug-<id>.md
• scripts/repro/
• scripts/regression/

Typical loop

1. Reproduce the bug reliably
2. Capture artifacts (screenshot, logs, traces, failing tests)
3. Implement the narrowest fix
4. Add a regression guard
5. Re-run repro + regression
6. Document root cause and fix path

Best fit

• flaky UI bugs
• runtime failures
• perf regressions
• issue-driven maintenance