What document types does the Planning skill support?

It supports Architecture Decision Records (ADR), Feature Design Proposals (FDP), Action Plans (AP), Reports (RPT), and a centralized project Roadmap.

Where are the planning documents stored by default?

Documents are typically stored in the docs/planning/ directory, with dedicated subdirectories for decisions, designs, action-plans, and reports, all of which are configurable.

Can I edit a document once it is accepted or published?

Documents in 'Locked' statuses (like Accepted or Published) are read-only by default to preserve history. You should use the addenda script to add notes or the supersedes script to replace them with a newer version.

How does the document numbering system work?

The skill automatically tracks and assigns the next available unique ID (e.g., ADR-001, FDP-002) using provided Python scripts to ensure consistency and prevent manual errors.

Planning & Project Documentation

Name: Planning & Project Documentation
Author: mjrskiles

bymjrskiles

0•

Productivity & Workflow

Orchestrates project planning and architectural decision records with structured lifecycles and automated documentation management.

The Planning skill provides a robust framework for managing the lifecycle of essential project documentation, including Architecture Decision Records (ADRs), Feature Design Proposals (FDPs), and Action Plans. It enforces standardized formatting using YAML frontmatter, automates document numbering, and facilitates complex workflows like superseding old decisions or adding non-destructive addenda. By integrating these processes directly into Claude Code, it ensures that technical debt, design decisions, and roadmaps are captured, versioned, and searchable without the manual overhead of manual file creation.

Key Features

01Standardized ADR, FDP, and Action Plan templates with YAML metadata

02Automated document numbering and lifecycle status management

03Non-destructive 'Addenda' system for updating locked or finalized documents

04Intelligent superseding logic that automatically links and archives retired docs

050 GitHub stars

06Integrated project roadmap tracking for immediate and long-term goals

Use Cases

01Drafting and refining feature designs with stakeholders before implementation begins

02Recording critical architectural decisions to maintain a permanent, searchable project history

03Maintaining a dynamic project roadmap that updates automatically during development cycles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mjrskiles/vibe-hacker planning

For use in Claude.ai and ChatGPT

Download Skill