forge-revise

Name: forge-revise
Availability: InStock
Author: whatwecando

Revise project plans after architectural issues and detect orphan files.

Updated Feb 23, 2026

Search Tags:#planning #architecture #plan-validation #orphan-files #revise #dagsmith

Ready to run

npx skills add https://github.com/whatwecando/dagsmith --skill forge-revise

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: forge-revise
Source: https://github.com/whatwecando/dagsmith/tree/main/templates/skills/forge-revise
Command: npx skills add https://github.com/whatwecando/dagsmith --skill forge-revise

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Revise the current plan after encountering an architectural issue to re-plan remaining tasks and surface orphan files.

Core Features & Use Cases

Replans remaining tasks after an architectural issue.
Detects orphan files introduced by removed tasks and surfaces them for action.
Updates planning and architecture artifacts (PLAN.md, ARCHITECTURE.md, DECISIONS.md) as needed.

Quick Start

Run the forge agent in revise mode to update the current plan and surface orphan files.

Frequently Asked Questions about forge-revise

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

FAQPage Schema

How do I revise a project plan after encountering an architectural issue?▼

An architectural issue requires plan revision to re-plan remaining tasks, update DECISIONS.md, and identify orphan files. This ensures project artifacts reflect new architectural decisions while preserving completed tasks.

How do I detect orphan files introduced by removed tasks in project planning?▼

To detect orphan files from removed tasks, enforce plan validation during revisions. This surfaces orphaned files for review and action, ensuring the updated PLAN.md remains clean and accurate.

Do I need existing planning artifacts to run plan validation and revisions?▼

Yes, plan validation and revision require existing PLAN.md, ARCHITECTURE.md, and DECISIONS.md files. The process updates these artifacts rather than generating them from scratch.

What is the best way to update ARCHITECTURE.md when replanning remaining tasks?▼

The best way to update ARCHITECTURE.md during replanning is to run a plan revision mode that adjusts DECISIONS.md and supporting rules simultaneously, ensuring all planning artifacts stay synchronized after architectural changes.

Can I preserve completed tasks when replanning remaining project tasks?▼

Yes, replanning remaining tasks preserves completed tasks. The revision process targets only outstanding work, updating task XMLs and architecture documents without overwriting progress already made.