{"id":50704377,"url":"https://github.com/endlessblink/master-plan","last_synced_at":"2026-06-09T10:32:05.937Z","repository":{"id":340418544,"uuid":"1164994398","full_name":"endlessblink/master-plan","owner":"endlessblink","description":"AI-native task management for Claude Code. Track tasks in MASTER_PLAN.md — pick, save, ship.","archived":false,"fork":false,"pushed_at":"2026-02-24T18:57:13.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-24T22:57:33.681Z","etag":null,"topics":["agent-skills","ai-workflow","claude-code","claude-code-plugin","master-plan","productivity","task-management"],"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/endlessblink.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-02-23T17:57:58.000Z","updated_at":"2026-02-24T18:57:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/endlessblink/master-plan","commit_stats":null,"previous_names":["endlessblink/master-plan"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/endlessblink/master-plan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessblink%2Fmaster-plan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessblink%2Fmaster-plan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessblink%2Fmaster-plan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessblink%2Fmaster-plan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/endlessblink","download_url":"https://codeload.github.com/endlessblink/master-plan/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessblink%2Fmaster-plan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34103355,"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-06-09T02:00:06.510Z","response_time":63,"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","ai-workflow","claude-code","claude-code-plugin","master-plan","productivity","task-management"],"created_at":"2026-06-09T10:32:02.994Z","updated_at":"2026-06-09T10:32:05.933Z","avatar_url":"https://github.com/endlessblink.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# master-plan\n\n![master-plan cover](cover.png)\n\nAI-native task management for [Claude Code](https://claude.com/claude-code). Track tasks in a `MASTER_PLAN.md` file, pick what to work on, save progress, and ship — all through agent skills.\n\n```\n/master-plan:task  →  create  →  /master-plan:next  →  pick  →  /master-plan:save  →  pause  →  /master-plan:done  →  ship\n```\n\n## Quick Start\n\n**Step 1** — Install the plugin (run these two lines inside Claude Code):\n\n```\n/plugin marketplace add endlessblink/master-plan\n/plugin install master-plan\n```\n\n**Step 2** — Create your first task:\n\n```\n/master-plan:task\n```\n\nThat's it. If your project doesn't have a `MASTER_PLAN.md` yet, the plugin creates one automatically in `docs/MASTER_PLAN.md`.\n\n**Step 3** — Work the loop:\n\n```\n/master-plan:next     Pick what to work on\n                      ... write code ...\n/master-plan:save     End of session? Save WIP + push\n                      ... next day, different machine ...\n/master-plan:next     Pick up where you left off\n                      ... finish the task ...\n/master-plan:done     Test + commit + push + mark complete\n```\n\n\u003e **Already have tasks in a MASTER_PLAN.md?** The plugin works with any existing file as long as tasks use `### TASK-123: Title (STATUS)` headers. Run `/master-plan:next` to start picking from your existing backlog.\n\n## Why?\n\n- **Zero infrastructure** — Just a markdown file + git. No Jira, no Linear, no database.\n- **AI-native** — Claude reads the plan, scores priorities, picks tasks, updates status, runs tests, commits. You just approve.\n- **Session-resilient** — `/save` your work, switch machines, come back tomorrow, `/next` picks up where you left off.\n- **Self-documenting** — The MASTER_PLAN.md IS the project history. Nothing to keep in sync.\n- **Any language, any framework** — Works with Node, Python, Rust, Go, or anything else. Auto-detects your test runner.\n- **Cross-platform** — Built on the [Agent Skills open standard](https://agentskills.io). Core functionality works in Claude Code, Cursor, GitHub Copilot, Windsurf, and other compatible tools. Interactive task picking is best in Claude Code.\n\n## Skills\n\n### `/master-plan:task` — Create a Task\n\nCreates a new task with an auto-generated sequential ID. If no `MASTER_PLAN.md` exists, creates one from a starter template.\n\n```\n\u003e /master-plan:task\n\nUsing task number: 42\n\n? Type: TASK / BUG / FEATURE / INQUIRY\n? Priority: P0 (critical) → P3 (backlog)\n? Title: Add user authentication\n\nTask added to MASTER_PLAN.md:\n- ID: TASK-42\n- Title: Add user authentication\n- Priority: P1\n- Status: PLANNED\n```\n\n### `/master-plan:next` — Pick What to Work On\n\nReads your MASTER_PLAN.md, scores tasks by priority and status, shows an interactive picker. Highlights in-progress tasks so you finish what you started.\n\n```\n\u003e /master-plan:next\n\nYou have 1 task in progress.\n\n? Which task would you like to work on?\n  ● TASK-42: Add user authentication    P1 · PLANNED\n    BUG-38: Fix login redirect          P0 · PLANNED\n    TASK-40: Refactor API layer         P2 · IN PROGRESS\n    Show more tasks...\n\n\u003e [Selects TASK-42, shows full details, offers to start working]\n```\n\n**Filters:** `/master-plan:next bugs` · `/master-plan:next planned` · `/master-plan:next active` · `/master-plan:next review`\n\n### `/master-plan:save` — Save Work-in-Progress\n\nCommits and pushes without marking the task done. No tests, no ceremony — just save and go. Perfect for switching machines or ending a session.\n\n```\n\u003e /master-plan:save\n\n## Progress Saved\n- Task: TASK-42\n- Summary: Added login form and validation\n- Commit: a1b2c3d — wip(TASK-42): Added login form and validation\n- Status: Still IN PROGRESS\n\nReady to continue on another machine:\n  git pull → /master-plan:next\n```\n\n### `/master-plan:done` — Ship It\n\nThe full completion workflow: run tests, commit, push, and mark the task done in all locations within MASTER_PLAN.md.\n\n```\n\u003e /master-plan:done\n\n## Task Complete\n- Task: TASK-42\n- Tests: ✅ Passed\n- Commit: d4e5f6g — feat(TASK-42): Add user authentication\n- Push: ✅ Pushed to origin\n- MASTER_PLAN.md: ✅ Updated (table + header + bullets)\n```\n\n**Test auto-detection:** `npm test` · `pytest` · `cargo test` · `go test ./...` · `make test`\n\n**Commit format:** `feat(TASK-XXX):` for features, `fix(BUG-XXX):` for bugs, `wip(TASK-XXX):` for saves.\n\n## The Workflow\n\n```\nStart session\n    │\n    ▼\n/master-plan:next          ← Pick a task (scored by priority)\n    │\n    ▼\n  Work on it               ← Write code, debug, iterate\n    │\n    ├──► Need to stop?     → /master-plan:save (WIP commit + push)\n    │                         Come back later, git pull, /next\n    │\n    ├──► Found a bug?      → /master-plan:task (log it, keep working)\n    │\n    └──► Done!             → /master-plan:done (test + commit + push + mark complete)\n         │\n         ▼\n    /master-plan:next      ← Pick the next task\n```\n\n## MASTER_PLAN.md Format\n\nThe plugin reads and writes tasks in this format:\n\n```markdown\n### TASK-42: Add user authentication (IN PROGRESS)\n**Priority**: P1\n**Status**: IN PROGRESS (2026-02-23)\n\nDescription of the task...\n\n**Tasks**:\n- [ ] Create login form\n- [x] Set up auth provider\n```\n\n**Statuses:** `PLANNED` · `IN PROGRESS` · `REVIEW` · `PAUSED` · `✅ DONE`\n\n**When a task is marked done**, it gets strikethrough on the ID and a status update:\n\n```markdown\n### ~~TASK-42~~: Add user authentication (✅ DONE)\n```\n\nTasks can also appear in a roadmap table — the plugin updates both locations automatically.\n\n\u003e **Starting fresh?** Run `/master-plan:task` and the plugin creates the file for you. A starter template is also available at [`templates/MASTER_PLAN.md`](templates/MASTER_PLAN.md).\n\n## Task ID Format\n\n| Prefix | Usage |\n|--------|-------|\n| `TASK-XXX` | Features and improvements |\n| `BUG-XXX` | Bug fixes |\n| `FEATURE-XXX` | Major features |\n| `ROAD-XXX` | Roadmap items |\n| `IDEA-XXX` | Ideas for later |\n| `ISSUE-XXX` | Known issues |\n| `INQUIRY-XXX` | Investigations |\n\nIDs are **globally sequential** across all types. If TASK-42 and BUG-43 exist, the next ID is 44.\n\n## Team Install\n\nCommit this to your project's `.claude/settings.json` and teammates are prompted to install automatically:\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"endlessblink-tools\": {\n      \"source\": { \"source\": \"github\", \"repo\": \"endlessblink/master-plan\" }\n    }\n  },\n  \"enabledPlugins\": {\n    \"master-plan@endlessblink-tools\": true\n  }\n}\n```\n\n## Requirements\n\n- [Claude Code](https://claude.com/claude-code) (or any [Agent Skills](https://agentskills.io)-compatible tool)\n- Git\n\nNo npm install, no build step, no external dependencies. The skills are pure markdown — Claude does the parsing.\n\n## Contributing\n\nIssues and PRs welcome at [github.com/endlessblink/master-plan](https://github.com/endlessblink/master-plan/issues).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fendlessblink%2Fmaster-plan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fendlessblink%2Fmaster-plan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fendlessblink%2Fmaster-plan/lists"}