Files
boshu2__agentops/docs/contracts/scope-escape-report.md
T
Boden Fuller b7f62faed2 fix(cli): address swarm post-mortem findings — all 7 items
1. Unify chdirTemp/setupTempWorkdir + fix cov3W2CaptureStdout buffer (testutil)
2. Create agent-footguns.md for dispatch prompt pre-seeding
3. Add shell hygiene checks to preflight + create merge-worktrees.sh
4. Create post-merge-check.sh for integration validation
5. Start projectDir refactor — 5 production files use resolveProjectDir()
6. Create scope-escape-report.md template in docs/contracts
7. (Items 3+4 overlap: sanitize shell + integration checklist)
2026-02-26 19:25:16 -05:00

964 B

Scope Escape Report Template

When an agent determines a task cannot be completed within its given constraints, it should produce a structured report instead of forcing a partial or incorrect fix.

Template

Task

[Original task description]

Finding

[What the agent discovered that prevents completion]

Audit Summary

Metric Value
Sites examined [count]
Fixable within scope [count]
Requires scope expansion [count]
Blocking dependency [description or "none"]

Root Cause

[Why the task exceeds the given scope -- 2-3 sentences]

[What WOULD fix it, at what effort level -- 2-3 sentences]

Scope Expansion Required

  • Production code changes (list files)
  • API/interface changes
  • Cross-package refactor
  • External dependency update
  • Human decision needed

Evidence

[Key data points, grep outputs, or code references supporting the finding]