create-plan

Generate structured Markdown implementation plans with validation steps.

7.5k|1.4k|Updated Dec 8, 2024
One-click install
npx skills add https://github.com/antinomyhq/forge --skill create-plan-antinomyhq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-plan
Source: https://github.com/antinomyhq/forge/tree/main/.forge/skills/create-plan
Command: npx skills add https://github.com/antinomyhq/forge --skill create-plan-antinomyhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a clear, repeatable framework to plan and validate complex software tasks without writing code, saving time and reducing rework by producing structured, checkable plans.

Core Features & Use Cases

  • Structured Planning: Generates Markdown plans in plans/ with an objective, detailed implementation tasks (checkbox format), verification criteria, risks, and alternative approaches.
  • Source Citing & Validation: Integrates with the included validation scripts to ensure plans meet the required structure and quality standards and to cite sources using filepath:line references.
  • Use Case: When starting a new feature or refactor, the skill creates a plan that decomposes the work into concrete steps, enabling teams to review before coding.

Quick Start

Create a new plan by describing the task to the agent; the tool will generate a plan scaffold in the plans directory. After creating the plan, run the validator to ensure it conforms to expectations: the validator script is located at .forge/skills/create-plan/validate-plan.sh and will verify plan structure and quality.

Frequently Asked Questions about create-plan

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

FAQPage Schema
How do I generate a structured implementation plan for a complex software task?

To generate a structured implementation plan, describe the task to the agent. It analyzes the codebase and outputs a Markdown plan with objectives, checkbox-based steps, verification criteria, and risks to guide your software implementation.

What is the best way to create a roadmap with validation criteria before coding?

Creating a roadmap with validation criteria is done by generating a structured Markdown plan before coding. The plan includes verification criteria, task checkboxes, and risks, ensuring you review the architectural decisions before implementation begins.

Does the generated plan include risk management and alternative approaches?

Yes, the generated plan includes risk management and alternative approaches. It produces structured Markdown roadmaps containing explicit risks, alternative implementation methods, and verification criteria to ensure comprehensive task planning.

How do I validate a Markdown plan structure after generation?

To validate a Markdown plan structure, run the validator script located at .forge/skills/create-plan/validate-plan.sh. This script verifies that your plan conforms to the required structural expectations and quality standards.

Can I use this planning approach for architectural decisions and refactoring?

Yes, you can use this planning approach for architectural decisions and refactoring. It decomposes complex software tasks into concrete, checkable steps, enabling teams to review roadmaps and validate codebase analysis before writing code.