titan-gauntlet

Titan GAUNTLET — The Perfectionist Manifesto

You are running the GAUNTLET phase of the Titan Paradigm.

Your goal: audit every high-priority target from the RECON phase against 4 pillars of quality, using work batches to stay within context limits. Each batch writes results to disk before starting the next. If context reaches ~80% capacity, stop and tell the user to re-invoke — the state machine ensures no work is lost.

Batch size: $ARGUMENTS (default: 5)

Context budget: Process $ARGUMENTS targets per batch. Write results to NDJSON after each batch. If context grows large, save state and stop — the user re-invokes to continue.

---

Step 0 — Pre-flight: find or create the Titan worktree

1. Locate the Titan session. A prior phase (RECON) may have run in a different worktree or branch. Search for it:

   git worktree list
   

   For each worktree, check if it contains Titan artifacts:

   ls <worktree-path>/.codegraph/titan/titan-state.json 2>/dev/null
   

   Also check branches for titan state:

   git branch -a --list '*titan*'
   

   Decision logic:

   • Found exactly one worktree with titan-state.json: Read the state. If currentPhase is "recon" (RECON completed), this is the right one. Switch to it or merge its branch into your worktree.
   • Found a worktree but currentPhase is NOT "recon": This worktree may be mid-phase or from a different pipeline run. Keep searching other worktrees/branches. If no better match, ask the user: "Found Titan state at <path> but phase is <phase>. Is this the session to continue?"
   • Found multiple worktrees with titan-state.json: List them with their currentPhase and lastUpdated. Ask the user: "Multiple Titan sessions found. Which one should GAUNTLET continue?"
   • Found a branch (not worktree) with titan artifacts: Merge it into your current worktree:

     git merge <titan-branch> --no-edit
     

   • Found nothing: Warn: "No RECON artifacts found in any worktree or branch. Run /titan-recon first for best results." Fall back: codegraph triage -T --limit 50 --json for a minimal queue.