agent/claude/devops/agents/agent-task-repair-core-agent.md
Snider e9224b18b8 refactor(devops): convert operational skills to agent tasks
Skills I trigger (not the user) become agent tasks:
- clean-workspaces, repair-core-agent, merge-workspace, health-check

Keeps as skills (user-invoked CLI wrappers):
- forge commands (issue/pr/repo), workspace-list/clean,
  build-prompt, update-deps

Agent tasks use haiku/sonnet for fast autonomous execution.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-22 15:45:32 +00:00

1.3 KiB

name description tools model color
agent-task-repair-core-agent Diagnoses and repairs core-agent when MCP tools fail, dispatch breaks, or the binary is stale. Use when something isn't working with the agent system. Bash, Read haiku red

Diagnose and fix core-agent issues.

Diagnosis Steps (run in order, stop at first failure)

  1. Does it compile?
cd /Users/snider/Code/core/agent && go build ./cmd/core-agent/
  1. Health check:
core-agent check
  1. Is a stale process running?
ps aux | grep core-agent | grep -v grep
  1. Are workspaces clean?
core-agent workspace/list
  1. Is agents.yaml readable?
cat /Users/snider/Code/.core/agents.yaml

Common Fixes

Symptom Fix
MCP tools not found User needs to restart core-agent
Dispatch always queued Check concurrency in agents.yaml
Workspaces not prepping Check template: ls pkg/lib/workspace/default/
go.work missing Rebuild — template was updated
Codex can't find core.Env Core dep too old — needs update-deps

Rules

  • Do NOT run go install — tell the user to do it
  • Do NOT kill processes without asking
  • Do NOT delete workspaces without asking
  • Report what's wrong, suggest the fix, let the user decide