speckit-brownfield-scan

Scan git-backed repositories to produce structured project profiles with tech stack and architecture.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-brownfield-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-brownfield-scan
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-brownfield-scan
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-brownfield-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about speckit-brownfield-scan

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

FAQPage Schema
How do I discover the tech stack and architecture of an existing codebase?

To discover a tech stack and architecture, a brownfield scan performs read-only scanning of a git-backed source tree to detect languages, frameworks, module boundaries, and architectural patterns, producing a structured project profile output.

What is a brownfield scan for project profiling?

A brownfield scan for project profiling automatically inventories an existing codebase to identify its technology stack, architecture style, module map, and coding conventions, replacing the need for manual codebase exploration and documentation.

Can I map a monorepo with mixed frontend and backend modules?

Yes, you can map a monorepo with mixed frontend-backend systems. The scan analyzes directory structures and entry points to classify architectural styles and generate a proportional module map for multi-module services.

How do I extract coding conventions from a repository?

To extract coding conventions, the scan identifies naming patterns, commit style signals, documentation formats, and existing standards like lint configs or ADRs by directly reading actual files within the repository.

Do I need to configure anything before scanning my source tree?

No configuration is required before scanning your source tree. The process requires only read-only access to a git-backed repository to perform proportional detection using actual files and generate the project profile.