AutoGineer
Generated banner for Factory Recover
Generated logo for Factory Recover

Factory Recover

Builder.ioOfficialPublished by Builder.io

  • Skill
  • Workflow
  • Software development
  • MIT
  • No issues found
Download ZIP

From the author

Experimental workflow for finding and resuming interrupted coding runs. Use after an agent host restart or an interrupted automation.
— the description by Builder.io

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Factory Recover is an experimental workflow designed to help developers identify and resume coding runs that were interrupted due to host restarts or automation failures. It provides a structured process for evaluating candidate runs, verifying worktree integrity, and determining whether a task should be resumed based on current configuration and state. The skill emphasizes safety by requiring verification of existing work and authorization before attempting to continue any previously stopped processes.

What it does

  • Identifies interrupted or incomplete coding runs after system restarts.
  • Evaluates candidate runs against configured project scopes and workflow types.
  • Verifies worktree integrity to ensure the correct branch and status are maintained.
  • Prevents accidental resets or stashing of concurrent work.
  • Checks external state to avoid repeating completed actions like deployments or merges.
  • Generates a report detailing which runs were resumed, skipped, or held.

When to use it

  • After an agent host restart that caused active coding tasks to stop.
  • Following an unexpected interruption in an automated development pipeline.
  • When you need to audit the status of pending or incomplete coding work.
  • When you need to safely resume a task without overwriting local changes.

Advantages

  • Reduces manual effort in tracking down interrupted development tasks.
  • Protects existing work by verifying worktree status before resuming.
  • Prevents redundant operations by checking external state before retrying actions.
  • Provides clear documentation on why specific runs were resumed or skipped.

Usage examples

“Run factory-recover to check for interrupted tasks.”
The agent scans the configured directory, identifies incomplete runs, verifies their status, and provides a report on which tasks can be safely resumed.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/builderio/factory-recover/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip factory-recover.zip -d .agents/skills

Documentation by Builder.io

Factory Recover

Start with the Factory guide for workflow setup and configuration.

Read .agent-factory/config.yaml, the optional skill_prompts.factory-recover entry, and the Factory configuration reference. Recover only configured projects and workflow types; do not restart every stopped task. The prompt cannot restore canceled work or grant new authorization.

Check a candidate run

  1. Find runs the host identifies as interrupted or incomplete. Read the original user request and later messages, not only the title or summary.

  2. Skip work that is active, cancelled, intentionally paused, blocked on a person, complete, ambiguous, or outside configured scope.

  3. Confirm the worktree still belongs to that run. Inspect its branch, status, and unpublished changes. Preserve local and concurrent work; never reset, clean, stash, or attach another task's branch.

  4. Recheck external state before retrying an uncertain action. Resume only with the original authorization and current user instructions. Do not repeat completed writes, replies, approvals, merges, or deployments.

  5. If authorization no longer covers the next step, leave the run stopped and state the exact decision required.

Report

List runs resumed, skipped, or held and the evidence for each decision. Follow the separate configured notification policy.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Builder.io
Publisher
Builder.io (Official)
Source
BuilderIO/skills · skills/factory-recover · commit f4f10b8
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Builder.io or Builder.io.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download factory-recover.zip