OpenParable
Skip to content
← Back to skills

Hive.error Recovery

Testing & Quality
hive.error-recovery

Hive.error Recovery is an Agent Skill for testing & quality published in the aden-hive/hive repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Follow a structured recovery decision tree when tool calls fail instead of blindly retrying or giving up.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/aden-hive/hive/blob/HEAD/core/framework/skills/_default_skills/error-recovery/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/hive-error-recovery, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Operational Protocol: Error Recovery

When a tool call fails:

  1. Diagnose — classify the failure as transient (network blip, rate limit, timeout) or structural (wrong selector, missing auth, invalid schema, permission denied).

  2. Decide:

    • Transient → retry once.
    • Structural + fixable → fix the input and retry.
    • Structural + unfixable → record the failure and move to the next item.
    • Blocking all progress → escalate.
  3. Adapt — if the same tool has failed {{max_retries_per_tool}}+ times in a row, stop using it and find an alternative approach.

Never silently drop a failed item. If the item is a task in the colony queue, write the failure to the DB instead of an in-memory buffer:

sqlite3 "$DB_PATH" "UPDATE tasks SET status='failed', last_error='<one-sentence reason>', completed_at=datetime('now'), updated_at=datetime('now') WHERE id='<task-id>' AND worker_id='<your-worker-id>';"

The tasks.retry_count column and the stale-claim reclaimer handle auto-retry for crashes; your job is the within-run decision tree above. See hive.colony-progress-tracker for the full queue protocol.