skills.rest
anton-abyzov
anton-abyzovCOMMUNITY
Explore all skills by this author →
Website𝕏@aabyzovGitHub

brownfield-analyzer

Analyze brownfield projects and map documentation to SpecWeave PRD/HLD/Spec/Runbook patterns.

156|21|Updated Oct 25, 2025
Search Tags:#migration#PRD#brownfield#runbook#documentation-mapping#HLD
One-click install
npx skills add https://github.com/anton-abyzov/specweave --skill brownfield-analyzer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brownfield-analyzer
Source: https://github.com/anton-abyzov/specweave/tree/main/plugins/specweave/skills/brownfield-analyzer
Command: npx skills add https://github.com/anton-abyzov/specweave --skill brownfield-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes existing brownfield projects to map documentation structure to SpecWeave's PRD/HLD/Spec/Runbook pattern and creates a just-in-time migration plan.

Core Features & Use Cases

  • Quick Start analysis of existing repo to map docs to SW patterns
  • Path options: Quick Start (incremental) or Comprehensive upfront migration
  • External tool detection (Jira, Azure DevOps, GitHub) for mapping

Quick Start

Run quick-start analysis to generate a migration plan and mapping for your brownfield project.

Frequently Asked Questions about brownfield-analyzer

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

FAQPage Schema
How do I migrate legacy documentation to SpecWeave's PRD and HLD structure?▼

Brownfield analyzer scans your existing project folders, classifies documents by SpecWeave patterns (PRD, HLD, Spec, Runbook, ADR), and generates a migration plan. It maps your current docs to SpecWeave's structure, offering Quick Start (incremental) or Comprehensive (upfront) migration paths.

Can brownfield analyzer detect documentation in external tools like Jira and GitHub?▼

Yes. The analyzer detects external tool integrations including Jira, Azure DevOps, and GitHub, then maps that documentation into your SpecWeave migration plan so no docs are left unmapped.

What's the difference between Quick Start and Comprehensive migration paths?▼

Quick Start runs incremental analysis to generate an initial migration plan and mapping for your repo. Comprehensive performs upfront full migration, analyzing all docs at once for complete structure mapping before you begin manual migration work.

Do I need to reorganize my project before running the analyzer?▼

No. Brownfield analyzer works on existing project structure as-is. It scans folders to classify and map current documentation without requiring pre-reorganization, then provides a migration plan you execute incrementally.

What documentation artifacts does the analyzer recognize and map?▼

The analyzer classifies documents as PRD (Product Requirements), HLD (High-Level Design), ADR (Architecture Decision Records), Runbook (operational procedures), or Spec (detailed specifications), then maps each to SpecWeave's standard pattern.

Related Skills

Explore More Software Engineering Skills→
anderson-0anderson-0
4

document-project

Analyze codebases to generate structured technical documentation for existing software projects.

Community
Advanced
bahayonghangbahayonghang
16

tech-design-doc

Generate technical design documents using standardized ADR/RFC templates.

Community
Advanced
mcj-codermcj-coder
1

requirements-gathering

Gather requirements through interactive questioning and create structured tickets.

Community
Advanced
anton-abyzovanton-abyzov
156

project-kickstarter

Detect product descriptions and route them to SpecWeave increment planning workflows.

Community
Advanced