plan

Guide structured interviews, brainstorming, and design reviews to produce specs and diagrams.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/ckallum/calsuite --skill plan-ckallum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/ckallum/calsuite/tree/main/skills/plan
Command: npx skills add https://github.com/ckallum/calsuite --skill plan-ckallum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning engineering work across projects is often inconsistent and time-consuming; this skill provides a structured, repeatable approach to discovery, design, and alignment that feeds into actionable specs and diagrams.

Core Features & Use Cases

  • Mode-driven planning: INTERVIEW, BRAINSTORM, REVIEW, and VISUALIZE to cover discovery, design, validation, and visualization.
  • Output artifacts: generates and guides production of specs in .claude/specs-like structure (requirements.md, design.md, tasks.md) and supports ADRs and diagrams.
  • Operational guidance: step-by-step prompts and lifecycle awareness to surface edge cases, decisions, and trade-offs.

Quick Start

Run /plan interview to begin a deep spec discovery session.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I create structured software engineering specs from an initial idea?

To create structured software engineering specs, run a guided interview or brainstorming session to produce concrete artifacts like requirements.md, design.md, and tasks.md. This approach enforces lifecycle awareness and surfaces edge cases during discovery.

What is the best way to conduct an architectural design review for a new feature?

The best way to conduct an architectural design review is using a structured review mode that validates existing patterns, generates ADRs, and produces diagrams. This ensures alignment and surfaces trade-offs across engineering projects.

Can I generate architecture diagrams and ADRs directly from a planning session?

Yes, you can generate architecture diagrams and ADRs directly from a planning session. The visualization mode produces diagrams alongside design documents to coordinate with existing codebase patterns and architectural decisions.

How does structured spec discovery improve software project planning?

Structured spec discovery improves software project planning by applying repeatable interviews and brainstorming modes to identify requirements, enforce lifecycle awareness, and output actionable specifications that feed into development tasks.

What formats do the generated planning documents use for task tracking?

The generated planning documents use standard markdown formats like requirements.md, design.md, and tasks.md. These structured specs ensure actionable task tracking and clear architectural alignment across engineering projects.