forge:discard

Delete the pending FORGE gate file and mark the run as discarded.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/Chulf58/FORGE --skill forge-discard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge:discard
Source: https://github.com/Chulf58/FORGE/tree/main/skills/discard
Command: npx skills add https://github.com/Chulf58/FORGE --skill forge-discard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Discard the pending FORGE gate to cancel the current pipeline and reset feature work in progress.

Core Features & Use Cases

  • Cancel a pending gate by deleting the gate-pending.json and updating the run state to discarded.
  • Resolve stalled plans by removing the active plan section from docs/PLAN.md and preparing for a fresh plan.
  • Use Case: when a feature needs to be restarted from Gate 1 after a rejected plan.

Quick Start

Discard the pending FORGE gate to cancel the current plan and restart the pipeline.

Frequently Asked Questions about forge:discard

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

FAQPage Schema
How do I cancel a pending pipeline gate and reset my workflow?

You can cancel a pending pipeline gate by discarding the gate-pending.json file, which updates the run status to 'discarded' and resets the in-flight feature cycle. This prepares the workspace for a fresh plan from Gate 1.

What happens to docs/PLAN.md when a FORGE gate is discarded?

When discarding a FORGE gate, the active plan section is removed from docs/PLAN.md if applicable. This clears the stalled plan and prepares the workspace for a completely fresh planning cycle.

When should I discard a pipeline gate instead of continuing the run?

Discard a pipeline gate when a feature plan is rejected or needs re-planning from Gate 1. It resets the in-flight workflow by deleting the gate-pending.json state file and stopping the current pipeline run.

How does the pipeline run state change after discarding a gate?

After discarding a gate, the pipeline run state updates to 'discarded'. The system locates the gate file from run metadata or .pipeline/gate-pending.json, deletes it, and halts the current feature cycle.

Can I restart a feature pipeline from Gate 1 after a plan is rejected?

Yes, discarding the pending FORGE gate cancels the current pipeline and resets the workflow. By removing the gate-pending.json file and active plan, the pipeline is ready to restart from Gate 1.

Why is my pipeline run stalled at a pending gate?

A pipeline run stalls at a pending gate when the gate-pending.json file exists but the plan is rejected or requires re-planning. Discarding this gate resets the run status and clears the stalled state.