[chubes4]

Summary

The AGENTS.md Homeboy section routed runner health to homeboy runner status, which only shows persisted tunnel status, and described Cook recovery generically without naming any command. It now points health checks at homeboy status plus homeboy runner doctor, adds homeboy agent-task capacity for judging the provider-rotation budget, and names the dedicated recovery verbs: agent-task diagnose <run> for root cause and next actions, agent-task recover for the next recovery step of a stopped Cook, and agent-task doctor --runner <runner> for runner provider/runtime readiness and repair.

What changed

• Default routing: component and runner health now uses homeboy status and homeboy runner doctor instead of homeboy runner status.
• Recovery step 1 notes that homeboy agent-task cook --preview also lists the ready backend routes.
• Recovery step 2 adds homeboy agent-task capacity (live capacity and reset times per route) and swaps runner status for runner doctor; the --help-full sentence is kept.
• Recovery step 3 names the real verbs agent-task diagnose <run>, agent-task recover, and agent-task doctor --runner <runner> (argument shapes verified against homeboy 0.434.30 --help), keeping the retry-within-budget rule.
• docs/changelog.md left untouched: repo convention adds entries only in release commits.
• Additive — guidance markdown only; the PHP wrapper, binary resolution, and all test-pinned phrases (e.g. the direct-fallback authorization line) are unchanged, and composed AGENTS.md simply recomposes to the new text on the next sync.

Verification

• bash tests/agents-md-guidance.sh passed on 3e66677. Base main@1f0adde unchanged.

• bash tests/verify.sh passed on 3e66677. Base main@1f0adde unchanged.

• homeboy --placement local review lint wp-coding-agents --path . passed on 3e66677. Base main@1f0adde unchanged.

• CI: pending

Cook run

• Gate 1: tree fa4a33a419c00d482f0a4742479244a0b1416e0d, fingerprint ca854ccc28312bb4744472c765a0e5ee160f4b577915cf8b765492e748d6a6fe
• Gate 2: tree fa4a33a419c00d482f0a4742479244a0b1416e0d, fingerprint ca854ccc28312bb4744472c765a0e5ee160f4b577915cf8b765492e748d6a6fe
• Gate 3: tree fa4a33a419c00d482f0a4742479244a0b1416e0d, fingerprint ca854ccc28312bb4744472c765a0e5ee160f4b577915cf8b765492e748d6a6fe
• Publication identity: ambient_gh

AI assistance

Tool: Homeboy (pi) · Model: glm-5.3-flash (tier roadie/subagent) · Used for: The AI read issue #833, verified every cited verb against the live homeboy CLI help, updated only the heredoc markdown in _guidance_homeboy_live_block, and ran the three Homeboy gates until all passed.

Closes #833