planz

Organize hierarchical project plans with stable IDs and multi-format exports.

Updated Jan 2, 2026
One-click install
npx skills add https://github.com/manmal/planz --skill planz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planz
Source: https://github.com/manmal/planz/tree/main
Command: npx skills add https://github.com/manmal/planz --skill planz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

planz simplifies building and maintaining complex project plans by organizing work into a clean, hierarchical structure with stable IDs and flexible exports.

Core Features & Use Cases

  • Hierarchical plans: up to four nesting levels (phases → tasks → subtasks → details)
  • Stable node IDs: reference nodes by ID or by path, and track progress
  • Cascading updates: done status cascades to descendants; undone propagates to ancestors
  • Multiple formats: text, JSON, XML, Markdown output
  • SQLite backend: WAL mode with per-project plan storage for isolation

Quick Start

Create a new plan with planz, add phases and tasks, then view the plan in your preferred format.

Frequently Asked Questions about planz

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize hierarchical project plans with stable IDs?

Hierarchical project plans use up to four nesting levels (phases, tasks, subtasks, details) with stable node IDs. You can reference nodes by ID or path, enabling precise tracking and cascading updates across the entire project structure.

Can I export task management data to multiple formats like JSON and Markdown?

Yes, task management data exports to text, JSON, XML, and Markdown formats. Multiple output formats allow flexible integration with downstream tools and reporting workflows directly from the SQLite backend.

How do cascading updates work when tracking task progress?

Cascading updates automate progress tracking by propagating done status down to descendants and undone status up to ancestors. This ensures plan progress remains consistent across all hierarchical levels without manual synchronization.

Does SQLite with WAL mode support isolated per-project plan storage?

Yes, per-project SQLite storage uses WAL mode to isolate plan data. This ensures concurrent read access and reliable transactional integrity for managing hierarchical project plans independently.

What are the limitations when creating hierarchical task titles?

Hierarchical task titles cannot contain slashes and sibling nodes must have unique names. These constraints ensure stable path-based node referencing and prevent ambiguity within the project plan structure.

What is the best way to refine leaf nodes in a project roadmap?

Refining leaf nodes involves updating the deepest nesting level (details) within the project roadmap. Progress tracking and cascading status updates automatically reflect these leaf changes across parent tasks and phases.