forge

A stage-by-stage workflow skill set (fg-*). A development loop that takes one task through a single cycle of ask·plan → execute → retro → done. Consists of fg-ask (inquiry/triage + grill-with-docs-style conversational grilling), fg-run (backlog selection menu · Run all, Dynamic Workflow execution), fg-learn (retro · doc promotion), and fg-done (done · seal · re-run guard), plus fg-map — an on-demand utility outside the loop that maps the codebase into .forge/codebase/ with parallel subagents so grilling reads a map instead of re-exploring the code (cuts context rot), and fg-quick — a lightweight lane outside the loop for trivial tasks that still grills lightly but skips formal artifacts (no ADR/plan/retro), records one line to .forge/quick/LOG.md, runs directly, and bails to fg-ask if the task turns out non-trivial, fg-status — a read-only reporter that surveys .forge/ and prints where every task stands plus the single next step you need (writes nothing, never auto-runs), fg-next — derives that same next step and runs it, announcing the step then invoking the skill rather than only reporting it (one-shot; fg-status reports, fg-next acts), with an 'all' mode (fg-next all) that drives backlog tasks to completion until empty, auto-progressing mechanical steps and halting at conversational walls, and fg-tdd — toggles persistent TDD mode in .forge/config.json (fg-ask then defaults to asking, fg-run runs test-first), and fg-eco — toggles eco mode in .forge/config.json (when on, fg-run caps its delegated workflow subagents at sonnet; lower only, the session model is untouched — ADR-0014), and fg-loop — a goal-driven momentum loop with bounded replan: an initial conversational inquiry pins a machine-verifiable stop condition, an authorized fix-forward replan scope, and a replan cap (default 3 rounds) into .forge/loop.md, then it drives tasks unattended (run → UAT → auto-skip retro → seal, auto-selecting recommended defaults at every soft decision and asking the user nothing) until the checks pass, generating in-scope fix-forward tasks within the cap and halting only at the walls (unverifiable UAT, genuine fork, cap exhausted, no progress — ADR-0016). On a non-default git branch the whole forge state moves under .forge/branch/<branch>/ (git-tracked, namespaced so parallel branches never collide on .forge state — ADR-0011), and fg-merge — an outside-the-loop utility that, after you git merge a branch, integrates that branch's .forge/branch/<branch>/ into .forge/ (renumbering ADRs and rewriting cross-references, merging CONTEXT terms, folding done history, removing the branch folder; halts on genuine conflicts), and fg-cleanup — an outside-the-loop utility that retires stale or superseded ADRs to .forge/adr/retired/ on your approval, keeping the active decision set current without deleting the why (ADR-0012), and fg-statusline — an outside-the-loop setup utility that installs a bash fragment script reading .forge/ and wires it into settings.json so your terminal statusline shows the current loop progress (active task·stage, goal-loop indicator, or backlog count); since Claude Code allows only one statusLine it auto-wraps your existing one as an extra row rather than replacing it (ADR-0017), and fg-adversarial-review — an outside-the-loop utility that runs an optional adversarial review between fg-run and fg-learn: it assumes the result is wrong and fans out six lenses (failure points, hidden assumptions, misread requirements, security/performance/data-loss, unexpected misuse, weak decisions) as parallel workflow subagents, records findings to .forge/review.md, and on your approval turns fix-needed findings into a fix-forward plan to run again — optional, never a seal gate, always auto-skipped in unattended drives (ADR-0018), and fg-doctor — a read-only integrity health check (outside the loop) that surveys the .forge/ state contract and the docs/manifests and reports inconsistencies with a severity and an actionable fix hint each (orphaned run.md, broken/missing STATUS fields, slug-pairing mismatches, half-sealed done/, manifest version drift across the 3 places, README bilingual drift, skills missing from CLAUDE.md); it writes nothing and never auto-fixes — fg-status reports where you are, fg-doctor reports whether the state is healthy (ADR-0019), and fg-drop — an outside-the-loop utility that discards incomplete work you no longer want (a backlog plan, the active slot, an awaiting-retro task in executed/, or a halted goal loop): it lists the items with a per-item risk level (a checkbox dialog for ≤4, a numbered text list for ≥5), then a separate question to hard-delete (default, no trace) or archive to .forge/dropped/, behind a confirmation gate that warns already-run code is not reverted; it removes forge state only — never git, never your code — and a halted goal loop is dropped whole with its member tasks excluded from individual drop (ADR-0021). Use in contexts like 'start a new task', 'start with forge', 'let's work on this', 'refine the plan', 'map the codebase', 'forge quick', 'forge status', 'forge next', 'forge loop', 'forge tdd', 'forge eco', 'forge merge', 'forge cleanup', 'forge statusline', 'adversarial review', '적대적 리뷰', 'forge doctor', '무결성 검사', '상태 점검', 'forge drop', '작업 버리기', '계획 지워'.