skills.rest
whatwecando
whatwecandoCOMMUNITY
Explore all skills by this author →
GitHub

forge-plan

Read BLUEPRINT.md and ROADMAP.md to generate milestone plans and task XML files.

Updated Mar 17, 2026
Search Tags:#automation#planning#verification#roadmap#milestones#blueprint#dag
One-click install
npx skills add https://github.com/whatwecando/tombola --skill forge-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: forge-plan
Source: https://github.com/whatwecando/tombola/tree/main/.claude/skills/forge-planner
Command: npx skills add https://github.com/whatwecando/tombola --skill forge-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan or re-plan a milestone efficiently by reading BLUEPRINT.md and ROADMAP.md, preserving completed tasks when replanning, and generating a clear task DAG and task detail files for execution.

Core Features & Use Cases

  • Read BLUEPRINT.md and ROADMAP.md to understand scope and goals.
  • If replanning, read current PLAN.md and preserve completed tasks to avoid regressing progress.
  • Invoke the forge-planner agent to create or update: .planning/PLAN.md (task DAG) and .planning/tasks/*.xml (task details).
  • Run verification with the verify.sh script and display a plan summary for confirmation.
  • If ARGUMENTS is "next", plan the next milestone from ROADMAP.md; if "revise", re-plan remaining tasks in the current milestone.

Quick Start

Plan the current milestone or a new one by providing ARGUMENTS such as "next" or "revise" to guide replanning.

Frequently Asked Questions about forge-plan

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

FAQPage Schema
How do I automate milestone planning from a project roadmap and blueprint?▼

Automate milestone planning by reading BLUEPRINT.md and ROADMAP.md to generate a structured task DAG in PLAN.md and detailed task files in .planning/tasks/*.xml. This ensures correct structure and compatibility with verify.sh.

Can I replan project milestones without losing completed task progress?▼

Replanning project milestones preserves completed tasks by reading the current PLAN.md and integrating existing progress into the updated task DAG. Use the "revise" argument to re-plan remaining tasks without regressing completed work.

What is a task DAG and how does it help with project milestone verification?▼

A task DAG structures project tasks as a directed acyclic graph in PLAN.md, mapping dependencies between milestones. It enables structured execution and allows verify.sh to validate the plan's correctness and compatibility before development begins.

How do I plan the next milestone when my project roadmap changes?▼

Plan the next milestone by passing the "next" argument to read ROADMAP.md and automatically generate the subsequent plan. This adapts to changing roadmaps by updating the task DAG and outputting new task detail files.

Do I need BLUEPRINT.md and ROADMAP.md files to generate a task plan?▼

Yes, BLUEPRINT.md and ROADMAP.md are required to understand project scope and goals before generating the task plan. The planner reads these files to produce the structured PLAN.md and task XML files.

Related Skills

Explore More Product & Management Skills→
electroheadfxelectroheadfx
4

gsd-new-milestone

Start a new milestone cycle by updating GSD planning files.

Community
Advanced
saleorsaleor
29

validating-pre-commit

Automate pre-commit quality checks with lint fixes, TypeScript compilation, tests, and CI validation.

Official
Advanced
whatwecandowhatwecando

forge-metrics

Compute plan health metrics from Forge PLAN.md and tasks.

Community
Intermediate
Brite-NitesBrite-Nites

refine-plan

Refine v1 project plans into task-level Markdown with dependencies and acceptance criteria.

Official
Advanced