yrangana

Plans — Documentation skill for Claude Code

Documentation community

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

会话管理（Session Manager）需求文档（PRD / Markdown） — 目标：对 Codex / Claude Code 的本地会话记录进行可视化管理，并提供“一键复制 / 一键终端恢复”能力 31.7k ★
Repo Recap — Generate a structured recap of the repository state: open PRs, open issues, recent releases, and executive sum 11.9k ★
Ars Format Convert — ARS academic-paper format-convert mode — convert to LaTeX / DOCX / PDF / Markdown 4.5k ★

README

Plans

[![Deploy](https://github.com/yrangana/Plans/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/yrangana/Plans/actions/workflows/pages/pages-build-deployment) [![Tests](https://github.com/yrangana/Plans/actions/workflows/test-init.yml/badge.svg)](https://github.com/yrangana/Plans/actions/workflows/test-init.yml) [![Listed on ClaudePluginHub](https://www.claudepluginhub.com/badge/yrangana-plans)](https://www.claudepluginhub.com/plugins/yrangana-plans?ref=badge)

![Plans demo](https://raw.githubusercontent.com/yrangana/Plans/main/examples/demo.svg)

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.