claude-planz

Automate Beads CLI workflow organization with YAML frontmatter conventions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

claude-planz provides a structured, Beads CLI-based framework to orchestrate research and planning workflows for scientific and exploratory projects. It encapsulates conventions, file structure guidance, and a clear task hierarchy to accelerate setup and execution.

Core Features & Use Cases

  • Beads CLI integration: facilitates project initialization, task creation, research capture, and planning within Beads.
  • File structure guidance: defines where to store research notes, phase plans, and metadata for traceability.
  • Workflow clarity: enforces consistent task hierarchies (epics/phases and tasks) to streamline progress tracking and reporting.

Quick Start

Initialize claude-planz, then create an initial phase and a set of tasks using the Beads CLI to kick off research and planning.

Frequently Asked Questions about claude-planz

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

FAQPage Schema
How do I structure research and planning workflows using the Beads CLI?

To structure research and planning workflows with the Beads CLI, you define project phases, epics, and tasks using claude-planz conventions, which provide a standardized directory structure for storing research notes, plans, and metadata.

What is the best way to organize scientific research tasks and phases for traceability?

Organizing scientific research tasks for traceability requires a structured hierarchy of phases and tasks with dedicated file paths for research capture. This approach enforces consistent progress tracking and clear documentation throughout the project lifecycle.

Do I need a specific file structure to manage Beads project planning?

Yes, managing Beads project planning requires a specific file structure. You need a YAML frontmatter with name and description, along with optional directories for scripts, references, and assets to maintain clear project metadata and traceability.

Can I use standard CLI commands to automate research capture and initial project setup?

Yes, you can automate research capture and initial project setup using Beads CLI commands. The framework provides structured conventions to initialize your project, create initial phases, and generate a set of tasks to kick off execution.

What limitations exist when enforcing task hierarchies for exploratory research projects?

Limitations of enforcing task hierarchies for exploratory research include the rigid structure required for phases and epics, which may constrain highly dynamic investigations while ensuring consistent progress tracking and reporting across the project.