titan-forge

Titan FORGE — Execute Sync Plan

You are running the FORGE phase of the Titan Paradigm.

Your goal: read sync.json, find the next incomplete execution phase, make the actual code changes for each target, validate with /titan-gate, commit, and advance state.

Context budget: One phase per invocation. Do not attempt all phases in one session — the context window will fill. Run one phase, report, stop. User re-runs for the next phase.

Arguments (from $ARGUMENTS):

• No args → run next incomplete phase
• --phase N → jump to specific phase
• --target <name> → run single target only (for retrying failures)
• --dry-run → show what would be done without changing code
• --yes → skip confirmation prompt (typically passed by /titan-run orchestrator)

---

Step 0 — Pre-flight

1. Worktree check:

   git rev-parse --show-toplevel && git worktree list
   

   If not in a worktree, stop: "Run /worktree first."

2. Sync with main (conditional):

   git fetch origin main
   behind=$(git rev-list HEAD..origin/main --count)
   

   • If behind == 0 → already up to date, skip the merge entirely and print "Already up to date with origin/main."

   • If behind > 0 → merge:

     git merge origin/main --no-edit
     

     If there are merge conflicts, stop: "Merge conflict detected. Resolve conflicts and re-run /titan-forge."

     After a successful merge, run a duplicate-commit check to detect re-applied work:

     git log origin/main..HEAD --no-merges --format="%s" | sort | uniq -d
     

     If any subjects are duplicated, print a warning listing them: "WARNING: Duplicate commit subjects found after merge — prior work may have been re-applied. Step 5 will auto-recover completed targets from git log so they are skipped." Do not stop — proceed to Step 3.

3. Load artifacts. Read:

   • .codegraph/titan/sync.json — execution plan (if missing: "Run /titan-sync first.")
   • .codegraph/titan/titan-state.json — current state
   • .codegraph/titan/gauntlet.ndjson — per-target audit details
   • .codegraph/titan/gauntlet-summary.json — aggregated results