OpenParable
Skip to content
← Back to skills

Gen Plan

Productivity
gen-plan

Gen Plan is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate iterative `plan-N.md` files in the repo root (max N=5). Use only when asked; clarify before `plan-1.md`; stop at `plan-5.md`.

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/majiayu000/claude-skill-registry/blob/HEAD/skills/planning/gen-plan/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gen-plan, 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.

Gen-Plan

Contract

  • Scope: operate in the repo root; manage files named plan-N.md where N is an integer.
  • Define N as the maximum numeric suffix among files matching plan-(\d+).md (ignore non-matching filenames, including legacy plan-N-E.md / plan-N-R.md).
  • If any matching file has N > 5: do nothing; reply exactly: "Plan is ready."
  • If plan-5.md exists (case-insensitive): do nothing; reply exactly: "Plan is ready."
  • If no matching plan-(\d+).md exists: run the clarification flow, then create plan-1.md.
  • Otherwise: create plan-(N+1).md. Source plan markdown: plan-N.md.
  • When loading plan markdown from a source file, insert the full contents of plan-N.md at the <INCLUDE CONTENTS OF PLAN FILE> placeholder in the plan template.
  • Never overwrite an existing target file; stop and report the conflict.
  • Ask questions only when unresolved judgment calls block the next iteration.

Clarification flow (when needed)

  • Research first; ask only judgment-call questions.
  • Use the CLARIFICATION EXPERT: HUMAN INPUT REQUIRED block with numbered questions.
  • After questions are answered, determined if another round of questions is needed; if so continue asking questions until there are no more then write the next plan file.

Iterate on the plan

Use the following to generate a plan

---
Carefully review this entire plan for me and come up with your best revisions in terms of better architecture, new features, changed features, etc. to make it better, more robust/reliable, more performant, more compelling/useful, etc.

For each proposed change, give me your detailed analysis and rationale/justification for why it would make the project better along with the git-diff style changes relative to the original markdown plan shown below:

<INCLUDE CONTENTS OF PLAN FILE>
---