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

  • 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

[![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.