Skip to content

docs: add subagent resilience protocol#4

Merged
psklarkins merged 3 commits intomainfrom
feature/subagent-resilience-protocol
Feb 14, 2026
Merged

docs: add subagent resilience protocol#4
psklarkins merged 3 commits intomainfrom
feature/subagent-resilience-protocol

Conversation

@psklarkins
Copy link
Owner

Summary

  • Add Subagent Resilience Protocol section to AGENTS.md with max_turns budgets, resume protocol, and task decomposition guidelines
  • Add Subagent Context Exhaustion discovery to DISCOVERIES.md documenting the root cause and solution
  • Prevents two observed failure modes: agents stopping abruptly mid-task and agents shifting to summary mode instead of doing work

Changes

  • AGENTS.md — New section after "Sub-Agent Optimization Strategy" with turn budget table, 5-step resume protocol, and task sizing rules
  • DISCOVERIES.md — New entry documenting context exhaustion issue, root cause, and prevention

Test plan

  • Observe subagent behavior over 2 weeks with max_turns applied
  • Track resume success rate and turn budget adequacy by role
  • Tune max_turns values based on observed completion rates

🤖 Generated with Amplifier

psklarkins and others added 2 commits February 14, 2026 17:26
Add max_turns budgets, resume protocol, and task decomposition
guidelines to prevent subagents from exhausting their context
windows. Addresses two observed failure modes: abrupt stops and
summary-mode fallback under token pressure.

🤖 Generated with [Amplifier](https://github.com/microsoft/amplifier)

Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Clarify Task tool resume parameter syntax and add context that
referenced skills are from the superpowers plugin.

🤖 Generated with [Amplifier](https://github.com/microsoft/amplifier)

Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
@psklarkins psklarkins merged commit b14bb65 into main Feb 14, 2026
@psklarkins psklarkins deleted the feature/subagent-resilience-protocol branch February 15, 2026 17:24
psklarkins added a commit that referenced this pull request Feb 16, 2026
Rewrites the /fix-bugs command addressing all failure modes from Bug #4:

- Windows platform hardening: C:/ paths (not /c/), single-line curl,
  PowerShell Base64 decode, tmp/ directory for temp files
- Status-only API endpoint: uses PUT /api/bugs/{id}/status instead of
  full PUT that destroyed screenshot data
- Agent resilience: Explore agent (built-in, always available) replaces
  agentic-search (custom, may not be loaded). Increased max_turns to 15
  for investigation, 20 for bug-hunter
- Graceful fallback: if agents fail, explicit fallback instructions to
  investigate/fix directly in main context instead of retrying

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
psklarkins pushed a commit that referenced this pull request Feb 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant