titan-grind

Titan GRIND — Adopt Extracted Helpers

You are running the GRIND phase of the Titan Paradigm.

Forge shapes the metal. Grind smooths the rough edges. Your goal: find helpers that forge extracted but never wired into consumers, adopt them across the codebase, and gate on a non-positive dead-symbol delta.

Why this phase exists: Forge decomposes god-functions into smaller helpers, but those helpers are only called within their own file. The dead symbol count inflates with every forge phase because the adoption loop is never closed. Grind closes it.

Context budget: One forge phase per invocation. Process all targets from one forge phase's commits, then stop. If context reaches ~80% capacity mid-phase, write all state to disk, print a progress message, and stop — user re-runs for remainder.

Arguments (from $ARGUMENTS):

• No args → process the next unground forge phase
• --phase N → process a specific forge phase
• --target <name> → run single target only (for retrying failures)
• --dry-run → analyze and classify without making code changes (classifications ARE persisted to grind-targets.ndjson)
• --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. Session discovery. Check all worktrees for titan artifacts:

   git worktree list
   

   For each worktree, check:

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

   • Found artifacts in a different worktree: Read its titan-state.json → currentPhase and execution block. If forge completed there but grind hasn't run, merge its branch: git merge <branch> --no-edit
   • Found artifacts in current worktree: Proceed normally.
   • Found nothing: Stop: "No Titan session found. Run /titan-forge first."

3. Sync with main:

   git fetch origin main && git merge origin/main --no-edit
   

   If merge conflicts → stop: "Merge conflict detected. Resolve and re-run /titan-grind."