forge-adjusting

Replan forge projects mid-execution by updating feature priorities and scope.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Forge projects often drift when priorities shift, POCs fail, or stakeholders request changes mid-execution. This skill helps replan the feature plan without breaking completed work, enabling controlled pivots.

Core Features & Use Cases

  • Read current state files (features.json, forge.toml, context/, feedback/) to surface progress, dependencies, and risks.
  • Propose practical alternatives when a POC fails and update DESIGN.md with pivot notes and rationale.
  • Apply changes with governance: never touch done features, modify or replace blocked/pending items, and add new features with proper verify commands and scopes.

Quick Start

Run forge adjust to modify the current plan and re-align priorities during an active development session.

Frequently Asked Questions about forge-adjusting

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

FAQPage Schema
How do I replan a forge project mid-execution to adjust feature priorities?

Run forge adjust to replan a forge project mid-execution. It reads current state files like features.json and forge.toml to safely modify pending or blocked items while preserving completed work.

What happens to completed features when adjusting a forge plan mid-flight?

Adjusting a forge plan mid-flight enforces governance rules that never touch done features. It strictly modifies or replaces blocked and pending items to preserve existing work without breaking progress.

Can I update DESIGN.md with architecture pivot notes when a POC fails?

Yes, when a POC fails, forge adjusting proposes practical alternatives and requires DESIGN.md unknowns to be updated with pivot notes and rationale to reflect the new architecture direction.

How do I add new features to a forge plan during an active development session?

To add new features during an active development session, forge adjusting applies changes by defining proper verify commands and scopes, ensuring the new additions integrate safely with the existing project.

Does replanning a forge feature scope require updating context and state files?

Yes, replanning a forge feature scope requires re-evaluating context and state files like features.json and forge.toml to surface progress, dependencies, and risks before applying any scope adjustments.

What are the limitations of modifying a forge plan mid-flight?

Limitations of modifying a forge plan mid-flight include being unable to alter completed features and being required to update DESIGN.md unknowns while ensuring verify scripts exist for any new features added.