Source attribution. This page reflects
samples/side-project-resurrector/README.md in the usezombie repo. The zombie is currently README-only — it is a design reference, not yet an install target. Follow zombiectl install side-project-resurrector progress in the repo.What it does
- Clones the target repo into a fresh sandbox.
- Reads
README, package manifests, CI config to understand the stack. - Tries
make,npm install,pnpm install,cargo build,go build— whatever the project uses. - When something breaks, diagnoses (version drift, deleted packages, changed APIs, flaky tests) and proposes a fix.
- Iterates up to a time / step budget (default: 2 hours or 50 tool calls).
- Opens a PR with a detailed description of what it changed and why.
What it won’t do
- Rewrite your project’s architecture.
- Change public APIs.
- Update major framework versions without an explicit
--allow-majorflag. - Touch
.env, secrets, or anything that looks like a credential.
Good fit
- Projects with tests (success criteria is obvious).
- Projects under ~100k LOC.
- Ecosystems with deterministic builds: Node, Go, Rust, Python, Elixir.
- Projects that used to build and now don’t.
Bad fit
- Monorepos with complex custom tooling.
- Projects without any form of build verification.
- Projects with external service dependencies (real DBs, real APIs) the zombie can’t spin up.
Example run
Tools and policy
Authored as oneSKILL.md + one TRIGGER.md. The tools the zombie invokes — git, shell, github — are named in TRIGGER.md. Policy lives as prose inside SKILL.md: “read-only against your codebase architecture; allow dependency bumps within minor versions; require an explicit --allow-major flag for major bumps; never touch .env, secrets, or anything that looks like a credential; open a PR with a plain-language explanation of every change.”
Credential: a GitHub token with repo scope. Worker placement is cloud with at least 2 GiB RAM.
See samples/side-project-resurrector/README.md in the repo for the full manifest.