forge-planning

Extract goals, constraints, and unknowns to scaffold DESIGN.md and features.json.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Forge planning solves the challenge of turning vague project goals into a concrete design by outlining goals, constraints, and unknowns, and by scaffolding DESIGN.md and features.json with verify scripts.

Core Features & Use Cases

  • Detects planning phase and determines whether to perform Phase 0 Research, Phase 1 POC, or Phase 2 Full planning.
  • Scaffolds DESIGN.md with all eight sections and initializes references/context for design decisions.
  • Generates a baseline features.json and verify scripts to validate implementation later in the workflow.

Quick Start

Initiate planning by outlining goals, constraints, and unknowns and scaffold DESIGN.md with all eight sections.

Frequently Asked Questions about forge-planning

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

FAQPage Schema
How do I scaffold a DESIGN.md file and initialize project planning from scratch?

Scaffold a DESIGN.md file by extracting project goals, constraints, and unknowns to automatically generate all eight standard documentation sections alongside a baseline features.json for reproducible project planning workflows.

What is the best way to structure architecture documentation for phased project planning?

Structure architecture documentation by detecting the current planning phase—Phase 0 Research, Phase 1 POC, or Phase 2 Full planning—and distilling reference context to populate DESIGN.md sections for your specific project stage.

How do I generate verify scripts to validate implementation against features.json?

Generate verify scripts by defining a baseline features.json during the design phase, creating automated validation checks that ensure later implementation aligns with the initial project constraints and documented goals.

Can I use automated scaffolding for context distillation and design decisions without manual setup?

Automated scaffolding supports context distillation by initializing references and extracting constraints directly from user input, requiring no manual setup to populate design decisions within the DESIGN.md architecture documentation.

When should I use automated design scaffolding instead of manually writing architecture documentation?

Use automated design scaffolding when projects need architecture documentation, phased planning, and reproducible workflows, whereas manual documentation suits smaller projects without strict requirements for verify scripts or features.json validation.