Plans — Documentation skill for Claude Code
A markdown convention for tracking what you are building.
How to install Plans
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open yrangana/Plans and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Plans does
A markdown convention for tracking what you are building. Plain files in your repo, one source of truth for what is active, shipped, and next.
Alternatives in Documentation
- Claude Code Changelog — Tracking prompts, feature flags and metadata of Claude Code releases 783 ★
- Napkin — You maintain a per-repo markdown runbook, not a chronological log 420 ★
- Docs Impact — Show which documentation files may need updating based on changed source files 387 ★
README
Plans
[](https://github.com/yrangana/Plans/actions/workflows/pages/pages-build-deployment) [](https://github.com/yrangana/Plans/actions/workflows/test-init.yml) [](https://www.claudepluginhub.com/plugins/yrangana-plans?ref=badge)

A markdown convention for tracking what you're building. Plain files in your repo, one source of truth for what's active, shipped, and next. AI assistants read it natively as a bonus.
[Home](https://yrangana.github.io/Plans/) · [Roadmap demo](https://yrangana.github.io/Plans/roadmap.html) · [Status demo](https://yrangana.github.io/Plans/status.html) · [Slides](https://yrangana.github.io/Plans/presentation.html) · [Docs](https://yrangana.github.io/Plans/docs.html) · [Blog post](https://github.com/yrangana/Plans/blob/main/docs/blog-post.md) · [Reference spec](https://github.com/yrangana/Plans/blob/main/docs/reference.md)
Created by [Yasiru Rangana](https://yasirurangana.com), AI Architect and AI Engineer, Sydney.
What this is
A planning convention for solo devs and small teams. Every feature is a markdown file with structured frontmatter and a status banner. One `STATUS.md` answers "what's in flight, what's next, what just shipped". A static `roadmap.html` renders an interactive Gantt and dependency graph from the same data.
The primary audience is **you**, the person doing the work. The structure exists so you stop losing track of what you've shipped vs. what's still in flight. The fact that AI coding assistants (Claude Code, Cursor, Antigravity, Windsurf) can read your roadmap natively, because it's plain markdown with predictable shape, is a side effect, and a useful one.
Related Skills
Claude Agent OS
Agent operating system for Claude Code: a CEO agent plans, five roles execute, you get 15-minute tasks and dec
Maintainer Work
Take a reported issue through the maintenance loop — confirm, verify against source-of-truth, fix, PR into dev
Baton
Baton — clean session handoffs: pass in-progress work to the next agent with a single verified markdown file.
Consulting CRM
HIVE: local-first knowledge-graph CRM for consulting. Markdown/Obsidian vault as a typed property graph, PageR
Fec Doc Sync
Sync README, docs, environment variables, scripts, API/routing/component descriptions and deployment instructi
Refresh Docs
Regenerate documentation from code sources of truth
Related Agents
Beads Guru
Use this agent for general beads (bd) expertise — the three-layer mirror (bd to GitHub to Plane via bd-sync),
Scope Ingest
Bounded subagent that turns raw source material (markdown files, plain-text files, pasted text) into a normali
Clickup Sync
Pushes a local Markdown file to a ClickUp Doc page, overwriting it. Receives a file path, workspace ID, doc ID