pathfinder

Pathfinder is an orchestrator skill for auditing a codebase's architecture before a refactor. It maps the code into feature-grouped flowcharts, identifies concerns that are duplicated across features, and proposes the simplest unified architecture, without writing implementation code itself.

It runs a phased workflow: feature discovery (establishing boundaries first), per-feature Mermaid flowcharts with nodes labeled by file:line, a duplication hunt (both within-feature and cross-feature), an orchestrator-authored unified proposal, and copy-pasteable /make-plan handoff prompts per unified system. Discovery and extraction (reading files, tracing flow, diagramming) are delegated to subagents under a strict reporting contract requiring cited sources, concrete findings, Mermaid diagrams, and confidence notes, while synthesis decisions stay with the orchestrator. All artifacts are written to a dated PATHFINDER-<date>/ directory.

It is most useful for engineers who want to unify duplicated systems or understand a codebase's ideal path before a large refactor, emphasizing evidence over intuition and preferring deletion and simplification over new abstraction layers.