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

forge-revise

Revise project plans after architectural issues and detect orphan files.

Updated Feb 23, 2026
Search Tags:#planning#architecture#plan-validation#orphan-files#revise#dagsmith
One-click install
npx skills add https://github.com/whatwecando/dagsmith --skill forge-revise
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
joshbandjoshband
3

skill_plan

Plan APC plugin architecture and DSP strategy with implementation milestones.

Community
Intermediate
chaimtchaimt

spec-implement

Execute spec-defined task sets across setup, tests, core, integration, and polish phases.

Community
Advanced
rhuangabrielsantosrhuangabrielsantos

cy-workflow-memory

Load, update, and compact workflow memory files for Compozy tasks.

Community
Intermediate
workinprogress-aiworkinprogress-ai

devenv-refine-implementation-plan

Refine implementation plans by incorporating scope changes and new requirements into markdown artifacts.

Official
Advanced