| { |
| "name": "Bug hunting", |
| "objective": "Find, validate, and report likely bugs with reproducible evidence instead of filing speculative agent-generated issues.", |
| "trigger": { |
| "type": "scheduled", |
| "cadence_or_event": "Weekly on modules with recent churn, and when error logs spike or flaky tests cluster." |
| }, |
| "intake": { |
| "sources": ["error logs", "flaky tests", "issue labels", "support snippets", "recent diffs", "traces"], |
| "selection_rule": "Start only from concrete signals, search for duplicate issues first, and pursue candidates that reproduce in a safe environment." |
| }, |
| "workspace": { |
| "isolation": "Branch, worktree, sandbox, or read-only mode depending on the target.", |
| "allowed_actions": ["run tests and local fixtures", "static search", "non-production reproduction", "file evidence-backed issues or small PRs"], |
| "disallowed_actions": ["production data access", "destructive fuzzing", "speculative mass issue creation", "broad refactors"] |
| }, |
| "context": { |
| "required_files": ["module ownership docs", "safe reproduction commands"], |
| "runtime_sources": ["existing bug reports", "prior bug-hunt state and false positives"] |
| }, |
| "agents": [ |
| { |
| "role": "Scout", |
| "responsibility": "Discover suspicious signals and likely affected code paths." |
| }, |
| { |
| "role": "Reproducer", |
| "responsibility": "Attempt minimal reproduction in a safe environment." |
| }, |
| { |
| "role": "Minimizer", |
| "responsibility": "Reduce the reproduction to the smallest failing case." |
| }, |
| { |
| "role": "Reporter", |
| "responsibility": "File evidence-backed issues, or a small PR with tests when the cause is clear." |
| } |
| ], |
| "verification": { |
| "gates": ["reports include reproducible steps or a clear trace link", "patches include a failing test or deterministic reproduction", "duplicate search is recorded", "expected vs actual behavior is grounded in docs or tests"], |
| "receipts": ["modules checked", "signals inspected", "reproduction commands", "expected and actual behavior", "final disposition"] |
| }, |
| "state": { |
| "artifacts": ["bug-hunt log", "false-positive ledger"], |
| "update_rule": "Persist checked areas, reproductions, false positives, and dispositions so future runs do not repeat work." |
| }, |
| "budget": { |
| "max_retries": 3, |
| "max_runtime_minutes": 90 |
| }, |
| "escalation": { |
| "conditions": ["production-only bug", "privacy-sensitive logs", "security-sensitive finding", "possible data loss", "fix needs architectural judgment"], |
| "destination": "Module owner via issue; private channel for security-sensitive findings" |
| }, |
| "exit": { |
| "success": "A bug is reproduced and reported with evidence, or a small verified patch is opened.", |
| "stop_without_success": "The signal is classified as non-bug, retries are exhausted, or owner judgment is needed." |
| } |
| } |
|
|
