spec-miner

Spec Miner is a dedicated reverse-engineering agent designed for developers tackling undocumented, legacy, or inherited codebases. It operates as a technical archaeologist, using specialized search and analysis tools to bridge the gap between existing implementation and formal documentation. The agent employs a dual-perspective strategy: the Arch Hat for mapping high-level system architecture, data flows, and module dependencies, and the QA Hat for identifying observable behaviors, edge cases, and technical debt. By grounding every insight in direct code evidence, it transforms opaque, undocumented repositories into structured, actionable insights.

• Automated discovery of entry points, API routes, and core business logic.

• Systematic requirement extraction using the industry-standard EARS (Easy Approach to Requirements Syntax) format.

• Comprehensive dependency and architecture mapping to visualize system structure.

• Identification of technical debt, hardcoded configuration, and security-critical patterns.

• Generation of standardized project specifications, including technology stacks, module structures, and inferred acceptance criteria.

• Best utilized when onboarding to unfamiliar projects or preparing for feature refactoring.

• Requires active exploration using tools like Glob, Grep, and Read to ensure high-confidence analysis.

• Always distinguishes between objective code observations and inferred system intent.

• Provides a structured output template for creating maintainable documentation in Markdown.

• Emphasizes evidence-based analysis: strictly avoids assumptions without supporting code references.