brownfield

Analyze existing codebases to infer structure, tech stack, and migration plans.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/dhamija/claude-workflow-agents --skill brownfield
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brownfield
Source: https://github.com/dhamija/claude-workflow-agents/tree/main/templates/skills/brownfield
Command: npx skills add https://github.com/dhamija/claude-workflow-agents --skill brownfield

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes an existing codebase to infer its structure, features, and the underlying tech stack, helping teams onboard and plan changes without guessing.

Core Features & Use Cases

  • Project Structure Scan: Inspects repository layout, detects languages, frameworks, and entry points.
  • Tech Stack Inference: Identifies indicators like package.json, requirements.txt, Cargo.toml, and pom.xml to determine the tech landscape.
  • Feature & Promise Inference: Extracts observed components (APIs, modules, tests) and generates a high-level migration or refactor plan.

Quick Start

Start a Brownfield Analysis on your repository to map structure and tech stack. Begin with a repository-wide scan to identify language indicators (package.json, requirements.txt, Cargo.toml, pom.xml) and key components.

Frequently Asked Questions about brownfield

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

FAQPage Schema
How do I analyze an existing codebase to understand its structure and tech stack?

Codebase analysis scans your repository layout, detects programming languages and frameworks, and identifies key indicators like package.json, requirements.txt, Cargo.toml, and pom.xml to map the tech stack. This approach works across Node.js, Python, Rust, Java, and other languages to reveal the underlying architecture without manual inspection.

Can I use codebase analysis to onboard new team members faster?

Yes. Analyzing an existing codebase generates a high-level feature map and structure overview, helping new developers understand components, APIs, and modules without guessing. This accelerates onboarding by providing a documented snapshot of the project's architecture and observed functionality.

What indicators does codebase analysis use to detect the tech stack?

The analysis scans for manifest and configuration files—package.json for Node.js, requirements.txt for Python, Cargo.toml for Rust, and pom.xml for Java—to identify languages, frameworks, and dependencies. These files serve as the primary signals for inferring the complete tech landscape.

How can codebase analysis help plan a migration or refactor?

After mapping structure and features, the analysis generates an initial migration or refactor plan based on observed components and dependencies. This proposal provides a starting point for planning changes without requiring deep manual code review.

Does codebase analysis work with legacy codebases?

Yes. Legacy codebases benefit most from structure and tech stack inference, since documentation is often outdated or missing. The analysis surfaces actual components, entry points, and dependencies to support brownfield projects and ongoing maintenance.

What does codebase analysis output for feature mapping?

Feature mapping extracts observed APIs, modules, tests, and other components to generate a high-level inventory of functionality. This output helps teams understand what the codebase does and identify dependencies between features for refactoring or migration planning.