Troubleshooting: agent errors, partial runs, and how to recover

[Rishiidev]

If something goes wrong mid-run, here is how to recover without starting over.

---

The agent stopped partway through Phase 1

Phase 1 runs 4 agents in parallel. If one errors:

• The synthesis step will have partial data
• Re-run the specific trigger phrase — the agent checks what already exists and skips steps that completed
• Files that were already written (CHANGELOG, LICENSE etc.) are NOT overwritten on re-run

"I already have a README and the agent overwrote it"

This is expected — the agent generates a new README. To preserve yours:

1. Before running, rename it: git mv README.md README.old.md
2. Run the agent
3. Cherry-pick the sections you want from the generated README

Alternatively, run with improve in the trigger phrase instead of launch — the improve flow reads your existing README and patches it rather than replacing.

GitHub Pages is not showing up

1. Check that docs/index.html was created in the repo
2. Go to repo Settings → Pages → set Source to main branch, /docs folder
3. Wait 2-3 minutes for the first build

The .skill file was not attached to the release

The Package skill workflow creates the .skill file automatically on push. Check:

• Actions tab → Package skill workflow → did it run and succeed?
• If not: re-trigger it manually from the Actions tab

Topics were not set (only 0-3 topics showing)

The agent uses gh repo edit --add-topic. If you hit the 20-topic cap:

gh api repos/OWNER/REPO/topics --method PUT --field "names[]=topic1" ...

This replaces all topics at once instead of adding incrementally.

---

Post your specific error below and I will help diagnose it.