{"id":50291912,"url":"https://github.com/spikeon/caveman-plan","last_synced_at":"2026-05-28T06:15:20.585Z","repository":{"id":358837129,"uuid":"1243291396","full_name":"spikeon/caveman-plan","owner":"spikeon","description":"Epic → Plans → Hunts → Inventory. Large-project agent skill with Boss checkpoints. Built on caveman + superpowers-plan.","archived":false,"fork":false,"pushed_at":"2026-05-19T08:19:54.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T10:53:12.219Z","etag":null,"topics":["agent-skills","claude-code","claude-skills","cursor","planning","skills"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spikeon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-19T07:58:01.000Z","updated_at":"2026-05-19T09:04:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/spikeon/caveman-plan","commit_stats":null,"previous_names":["spikeon/caveman-plan"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/spikeon/caveman-plan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spikeon%2Fcaveman-plan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spikeon%2Fcaveman-plan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spikeon%2Fcaveman-plan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spikeon%2Fcaveman-plan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spikeon","download_url":"https://codeload.github.com/spikeon/caveman-plan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spikeon%2Fcaveman-plan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33596523,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","claude-skills","cursor","planning","skills"],"created_at":"2026-05-28T06:15:19.724Z","updated_at":"2026-05-28T06:15:20.570Z","avatar_url":"https://github.com/spikeon.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# caveman-plan\n\nBig project? Epic first. Plans split. Hunt one file. Boss say go. Then next hunt.\n\nAgent skill for **large-project planning and execution**: Epic checklist → multiple hunt plans → one plan per hunt (hard stops) → inventory pass against original Goal. Talks to Boss in [caveman](https://github.com/JuliusBrussee/caveman) voice; plan tasks use [superpowers-plan](https://github.com/obra/superpowers) step shape (files, change, verify).\n\n## What it does\n\nFour phases. Boss checkpoints between each. Planning artifacts live in `.plans/` (gitignored — local only).\n\n| Phase | Output | Boss checkpoint |\n|-------|--------|-----------------|\n| **Epic** | `.plans/epic_\u003cslug\u003e.md` — Goal (verbatim prompt) + Steps (S/M/L hints) | Changes before planning? |\n| **Plans** | `.plans/epic_\u003cslug\u003e/plan_*.md` — **one plan file per Epic step minimum** + `plans-manifest.md` | Time to go hunting? |\n| **Hunts** | Kill tasks in **one** `plan_*.md`, then **end turn** | Follow Ups? → Time for next hunt? |\n| **Inventory** | Compare kills to Epic Goal + Steps | Hunting complete (only when Epic satisfied) |\n\n**Hunt rules:** Mark tasks `- [x]` only when sure. Doubt → `## Follow Ups` in same plan, not checked off. **Never** chain multiple plans in one turn. **Never** collapse a multi-step Epic into one plan file.\n\n**Layout:**\n\n```\n.plans/\n├── epic_auth-refactor.md\n└── epic_auth-refactor/\n    ├── plans-manifest.md      # step → plan mapping + hunt status\n    ├── plan_jwt-middleware.md\n    ├── plan_migration.md\n    └── plan_rollout-flag.md\n```\n\n## How to invoke\n\n```\n/caveman-plan              # start Epic from current prompt\n/caveman-plan hunt         # resume current hunt (one plan only)\n/caveman-plan inventory    # Phase 4 only\n```\n\n**Claude + `/goal` enabled:** set goal at start, Boss says **`NEXT HUNT!`** between plans:\n\n```\n/goal Epic file created. All plan files created. Every checkbox in epic and every plan checked off.\n```\n\nNatural triggers: \"epic plan\", \"go hunting\", **`NEXT HUNT!`**, large multi-file / multi-session work.\n\n**Hunt turn limit:** one plan = max **3 agent turns**. Still open on turn 3 → stop, report blockers, wait for Boss (no silent grind).\n\n## Install\n\nRequires **`caveman`** and **`superpowers-plan`** (or **`writing-plans`** from obra/superpowers) installed — see [Credits](#credits).\n\n**Recommended — [Skills CLI](https://skills.sh/):**\n\n```bash\n# Dependencies (global, once)\nnpx skills add juliusbrussee/caveman --skill caveman -g -y\nnpx skills add obra/superpowers --skill writing-plans -g -y\n\n# This skill\nnpx skills add spikeon/caveman-plan -g -y\n```\n\nProject-local instead of global: drop `-g`.\n\nBrowse: [skills.sh/spikeon/caveman-plan](https://skills.sh/spikeon/caveman-plan)\n\n**Manual — git clone (`~/.agents/skills`):**\n\n```bash\ngit clone https://github.com/spikeon/caveman-plan.git ~/.agents/skills/caveman-plan\n# then copy or symlink skills/caveman-plan/ → ~/.agents/skills/caveman-plan\n```\n\n**Cursor project skill (optional):**\n\n```bash\nnpx skills add spikeon/caveman-plan -y\n# or: ln -sfn /path/to/caveman-plan/skills/caveman-plan .cursor/skills/caveman-plan\n```\n\nAttach the skill or mention `/caveman-plan` in chat.\n\n## Example flow\n\n**Boss:** \"Refactor auth to JWT. No forced logout on deploy.\"\n\n**Epic** (caveman to Boss): writes `epic_auth-refactor.md` with Goal + 4 Steps → *\"Boss: change Epic before planning?\"*\n\n**Plans:** 4+ `plan_*.md` files + manifest → *\"Boss: time go hunting?\"*\n\n**Hunt 1:** only `plan_jwt-middleware.md` → end turn → *\"Follow Ups? Next hunt?\"*\n\n**Hunt 2+:** Boss says yes → next plan only.\n\n**Inventory:** re-read Goal, check every Epic step → *\"Hunting complete.\"*\n\n## See also\n\n- [`skills/caveman-plan/SKILL.md`](./skills/caveman-plan/SKILL.md) — full agent instructions\n- [`skills/caveman-plan/reference.md`](./skills/caveman-plan/reference.md) — templates, manifest examples, anti-patterns\n\n## Credits\n\nThis skill **builds on** (install separately):\n\n| Project | Author | Used for |\n|---------|--------|----------|\n| [**caveman**](https://github.com/JuliusBrussee/caveman) | [Julius Brussee](https://github.com/JuliusBrussee) | Terse caveman voice when talking to Boss during the workflow |\n| [**superpowers**](https://github.com/obra/superpowers) (`superpowers-plan`) | [Jesse Vincent (obra)](https://github.com/obra) | Per-task plan format: small steps, files to touch, verify commands |\n\n**caveman-plan** combines those patterns into Epic → Plans → Hunts → Inventory with mandatory Boss checkpoints. It is not affiliated with or maintained by the upstream projects.\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspikeon%2Fcaveman-plan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspikeon%2Fcaveman-plan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspikeon%2Fcaveman-plan/lists"}