Relationships
#1219 Guide agents to inspect reports after failed model and workflow runs
Opened by evrardjp · 7/17/2026· Shipped 7/20/2026
Problem
Reports run after model methods and workflow steps and receive failure-specific context such as executionStatus, errorMessage, workflow status, and failed/skipped step details. However, the generated AGENTS.md guidance only mentions reports for reusable analysis pipelines, while the troubleshooting guide routes failed commands through stderr, --json, tracing, and source inspection without directing agents to inspect generated reports. As a result, agents do not naturally use available report artifacts when diagnosing failed model or workflow runs.
Proposed solution
- Add a rule to the swamp-managed
AGENTS.mdsection instructing agents to inspect generated reports after a model method or workflow failure, before retrying or changing definitions. - Add report inspection to Tier 2 of the troubleshooting skill, after reading stderr and structured command output and before escalating to tracing or source inspection.
- Include the supported discovery/retrieval commands, preferably directing agents to
swamp help report getfor current syntax andswamp report get ... --jsonfor structured diagnostics.
Suggested guidance:
Inspect reports after failures. When a model method or workflow run fails, inspect its generated reports before retrying or changing definitions. Reports may contain structured diagnostics derived from execution status, error messages, outputs, and failed steps. Use
swamp help report getto confirm retrieval syntax.
Alternatives considered
Users can add repository-local instructions manually, but the relevant AGENTS.md section is swamp-managed and this diagnostic behavior should be consistent across swamp repositories. The report and troubleshooting skill documentation could be updated alone, but agents rely heavily on the generated top-level rules, so updating both locations should make the behavior reliable.
Shipped
Click a lifecycle step above to view its details.