speckit-brownfield-scan

What problem does it solve?

It solves the problem of having to manually inventory an existing (brownfield) codebase to understand its tech stack, architecture patterns, module boundaries, and coding conventions before planning documentation or implementation work.

Core Features & Use Cases

• Technology Stack Discovery: Detects languages, frameworks, package managers, build tools, CI/CD signals, and testing practices by scanning repository artifacts.
• Architecture Pattern Analysis: Classifies architectural styles (e.g., monolith vs monorepo vs microservices, frontend+backend separation, layered/MVC indicators) based on directory structure and entry points.
• Conventions & Governance Extraction: Identifies naming conventions, branch/commit style signals, documentation patterns, and any existing standards (e.g., lint configs, CONTRIBUTING, ADRs, or spec-kit setup).
• Project Profile Output: Produces a structured profile that can be used by bootstrap commands to generate tailored configuration.

Quick Start

Ask to scan the repository (or a subfolder) to produce a project profile including detected tech stack, architecture, module map, conventions, and any existing governance files.