One-click install
npx skills add https://github.com/dwaynimay/IoTProject --skill pathfinder-dwaynimay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pathfinder
Source: https://github.com/dwaynimay/IoTProject/tree/main/.agents/skills/pathfinder
Command: npx skills add https://github.com/dwaynimay/IoTProject --skill pathfinder-dwaynimay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the challenge of understanding and refactoring a complex codebase by converting scattered logic into feature-grouped flowcharts, then surfacing duplicated concerns with concrete file-and-line evidence.

Core Features & Use Cases

  • Evidence-backed architecture mapping: Produces per-feature Mermaid flowcharts that trace primary happy paths, side effects, and error/fallback branches with file:line nodes.
  • Duplication detection across features: Generates a cross-feature duplication report that identifies repeated concerns, explains how/why they diverged, and validates each claim with multiple file:line citations.
  • Unified architectural proposal and refactor handoff: Proposes a simplest unified design and creates copy-pasteable /make-plan prompts for each consolidated system.

Quick Start

Use the pathfinder skill to map the repository into feature-grouped flowcharts and generate a unified architecture proposal with per-system refactor handoff prompts.

Frequently Asked Questions about pathfinder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map a multi-module codebase for a refactor without losing feature-specific logic?

To map a codebase for a refactor without losing logic, you need feature-scoped control and data flow mapping. This process traces primary paths, side effects, and error branches to consolidate systems while preserving legitimate specializations.

What is the best way to identify duplicated concerns across features in a complex codebase?

Identifying duplicated concerns across features requires a cross-feature duplication analysis that validates repeated logic with concrete file and line citations. This explains how and why repeated concerns diverged, enabling safe architectural consolidation.

How do I generate Mermaid flowcharts from an existing codebase for architectural review?

Generating Mermaid flowcharts from a codebase for architectural review involves tracing feature-scoped control flows and citing file:line nodes. This produces evidence-backed visual maps of primary happy paths and fallback branches.

Can I automate unified architecture proposals and refactor planning for multiple systems?

You can automate unified architecture proposals by generating actionable per-system handoff prompts. This proposes a simplest unified design and creates copy-pasteable planning instructions to drive subsequent consolidation tasks.

Does codebase duplication detection work without integrating external dependencies?

Codebase duplication detection works without external dependencies by auditing internal multi-module logic directly. It validates each repeated concern claim using multiple file:line citations extracted directly from the source code.