plan-first

Convert design documents into dependency-ordered task plans with checklists.

319|74|Updated May 17, 2025
One-click install
npx skills add https://github.com/m-xlsea/ruoyi-plus-soybean --skill plan-first-m-xlsea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-first
Source: https://github.com/m-xlsea/ruoyi-plus-soybean/tree/main/.claude/skills/plan-first
Command: npx skills add https://github.com/m-xlsea/ruoyi-plus-soybean --skill plan-first-m-xlsea

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a project design into a concrete, executable task plan by decomposing design content into tangible tasks with clear acceptance criteria, enabling deterministic execution.

Core Features & Use Cases

  • Automated task decomposition: Reads the design from .ai_state/design.md and breaks it into granular, testable tasks with format "- [ ] T-001: {action} + {goal} + {acceptance criteria}" and records involved files and pre-requisites.
  • Dependency-aware scheduling: Orders tasks topologically based on dependencies and prioritizes high-risk items.
  • Plan delivery: Writes the resulting plan to .ai_state/plan.md, ready for execution and tracking.

Quick Start

Read the design stored in .ai_state/design.md and generate a topologically sorted plan in .ai_state/plan.md.

Frequently Asked Questions about plan-first

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

FAQPage Schema
How do I generate an executable task plan from a design document?

To generate an executable task plan from a design document, the system reads your design file and applies deterministic task decomposition to break it down into granular, testable tasks with clear acceptance criteria. The final topologically sorted plan is then written directly into a plan markdown file.

What is dependency-based task ordering in project planning?

Dependency-based task ordering in project planning organizes tasks topologically based on their prerequisites and prioritizes high-risk items. This scheduling mechanism ensures that foundational tasks are completed before dependent ones, enabling deterministic execution and preventing workflow bottlenecks.

How do I break down a project design into a checklist with acceptance criteria?

To break down a project design into a checklist with acceptance criteria, automated task decomposition parses the design content and maps each item into a structured format. This format combines the action, goal, and acceptance criteria while recording involved files and prerequisites.

Do I need a specific design file format to use automated task decomposition?

Yes, you need a specific design file format to use automated task decomposition. The system requires the project design to be available as a markdown file stored at the designated dot ai state design path, which it reads to extract and schedule the tasks.

Can I validate a generated project plan before execution?

Yes, you can validate a generated project plan before execution. The system implements plan validation as part of its core processing logic to ensure the dependency-based ordering and task decomposition are structurally sound before writing the final output.

What is the best way to schedule high-risk project tasks using design documents?

The best way to schedule high-risk project tasks using design documents is through dependency-aware scheduling. This approach topologically orders tasks based on their dependencies and explicitly prioritizes high-risk items early in the generated plan.