← ClaudeAtlas

forge-reconcilelisted

This skill should be used to detect and adopt work done OUTSIDE the Context Forge process — phrases like "forge-reconcile", "someone committed without the process", "changes bypassed the workflow", "adopt these manual changes", "there are commits not in the tracker", or "bring out-of-band work back into the process". It finds commits with no unit/spec trail, analyzes them via the forge-scout agent, and — with approval — adopts each group as a retroactive spec plus tracker entry, so no work stays invisible to future sessions. Distinct from forge-audit (docs vs code content drift): this reconciles the PROCESS trail (git history vs tracker/specs).
yerros/context-forge · ★ 0 · AI & Automation · score 75
Install: claude install-skill yerros/context-forge
# forge-reconcile Work sometimes lands outside the forge loop: a manual hotfix, a teammate's commit, a Claude session that skipped `forge-build`. The code moves, but the tracker, specs, and context files never hear about it — and every later session works from a map that's missing roads. This skill closes that gap: detect the out-of-band (OOB) commits, understand them, and **adopt them back into the process** as first-class history (retro-spec + tracker entry), or consciously dismiss them. Division of labor with the neighbors: `forge-audit` fixes what the context files *say* (docs vs code). `forge-reconcile` fixes what the process *knows* (git history vs tracker/specs). A reconcile often ends by recommending a narrow `forge-audit` pass when the adopted work changed architecture or scope. ## Argument Text after the command narrows the scope (e.g. `/forge-reconcile last 5 commits` or `/forge-reconcile abc1234`) — restrict analysis to the matching commits. No argument → everything the detector reports. ## First: detect Run the deterministic detector (read-only): ```bash bash "${CLAUDE_PLUGIN_ROOT}/skills/forge-reconcile/scripts/detect-oob.sh" ``` Interpret the verdict: - `NO_CONTEXT` — no tracker; nothing to reconcile against. Point the user to `forge-init`. - `NO_EPOCH` — the tracker exists but was never committed, so there is no adoption baseline. Recommend committing the context dir first; offer to do it. - `CLEAN` with `dirty_tree: no` — the process trail is com