Will the analyzer delete my existing documentation?

No, the analyzer is designed to scan, classify, and map existing documents to the SpecWeave structure without deleting your original files.

Does this skill work with very large codebases?

Yes, it includes a 'Quick Start' path specifically optimized for projects over 50k-200k lines of code to ensure you can start working immediately while documentation grows organically.

What is a brownfield project?

A brownfield project refers to an existing codebase or software system that is already in development or production, requiring integration with new tools rather than starting from scratch.

Which project management tools can it detect?

The Brownfield Analyzer automatically scans for references and configurations related to Jira, Azure DevOps, and GitHub Issues.

Brownfield Project Analyzer

Name: Brownfield Project Analyzer
Author: anton-abyzov

byanton-abyzov

•

Learning & Documentation

Analyzes existing codebases to create structured documentation and migration plans for AI-native development workflows.

The Brownfield Analyzer is a specialized SpecWeave skill designed to onboard legacy or existing projects into an AI-enhanced development environment. It intelligently scans directories to classify documentation, detects external project management tools like Jira or GitHub Issues, and recommends tailored migration paths based on codebase size. By mapping existing files to the SpecWeave PRD/HLD/Spec pattern, it ensures developers can maintain high-quality context and documentation without halting active production or suffering from analysis paralysis.

Key Features

01Intelligent document classification for PRDs, HLDs, ADRs, and Runbooks

02Automatic discovery of coding standards and architectural patterns

03External tool detection for Jira, Azure DevOps, and GitHub integration

04Custom migration path recommendations (Quick Start vs. Comprehensive)

05Automated project assessment for LOC, file counts, and module mapping

0613 GitHub stars

Use Cases

01Auditing existing project structures to identify documentation gaps and technical debt

02Migrating large legacy applications to a spec-driven AI development workflow

03Synchronizing external project management tools with local architectural documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add anton-abyzov/specweave brownfield-analyzer

For use in Claude.ai and ChatGPT

Download Skill