rad-plans

Create and manage Plan COBs for implementation plans in Radicle repositories.

1|1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/deanh/rad-skill --skill rad-plans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rad-plans
Source: https://github.com/deanh/rad-skill/tree/main/skills/rad-plans
Command: npx skills add https://github.com/deanh/rad-skill --skill rad-plans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Radicle Plan COBs centralize and standardize the way implementation plans are stored, shared, and tracked inside Radicle repositories, reducing coordination overhead and ensuring durable records of planning work.

Core Features & Use Cases

  • Structured Plan COBs storing title, description, status, tasks, related issues, related patches, and discussion for traceability.
  • Task management with per-task fields (subject, description, estimate, affectedFiles, linkedCommit, blocked_by, linked_issue) to enable incremental progress and clear dependencies.
  • Linking and traceability between plans, issues, and patches, with network-style replication and plan lifecycle support.
  • Interactive CLI-driven workflow (rad-plan) for creating, listing, showing, editing tasks, linking commits and comments, and exporting plans.
  • Multi-agent orchestration integration to coordinate worktrees and distributed contributors while preserving plan state.

Quick Start

Use the rad-plan CLI to create a new Plan COB and begin detailing tasks, links, and discussion in the plan.

Frequently Asked Questions about rad-plans

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

FAQPage Schema
How do I track implementation plans and tasks inside Radicle repositories?

You can track implementation plans inside Radicle repositories by creating Plan COBs that store titles, descriptions, statuses, and tasks. This centralizes planning data directly in the repository for network replication and traceability.

How do I manage task dependencies and link commits in a Radicle plan?

Managing task dependencies in a Radicle plan involves using the rad-plan CLI to edit tasks and link commits. You can set blocked_by fields, add estimates, and attach linked_issue references for clear incremental progress tracking.

What is a Radicle Plan COB and when do I need it for project coordination?

A Radicle Plan COB is a structured record that standardizes how implementation plans are stored and shared across Radicle networks. You need it to reduce coordination overhead and maintain durable links between issues, patches, and tasks.

Can I use rad-plan commands to coordinate distributed contributors across multiple worktrees?

Yes, rad-plan supports multi-agent orchestration to coordinate worktrees and distributed contributors. It preserves plan state across the network, ensuring all participants share the same task tracking and execution coordination updates.

What's the best way to export and share Radicle planning data with external tools?

The best way to export Radicle planning data is using the rad-plan export command. This extracts the structured Plan COB fields, tasks, and discussion threads from your repository into a shareable format for external task-management workflows.

Does the rad-plan CLI support short IDs when referencing issues and patches?

Yes, the rad-plan CLI fully supports short IDs. This allows you to quickly reference related issues, patches, and specific plan tasks without needing to copy entire hashes during your interactive command-line workflows.