create-codebase-analysis

Analyze existing code and architecture to assess changeability before feature design.

11|1|Updated Jul 25, 2025
Ready to run
npx skills add https://github.com/tomzx/agents --skill create-codebase-analysis-tomzx
💬 Prompt for ChatGPT / Claude Chat▼
Please help me install this Agent Skill.
Skill: create-codebase-analysis
Source: https://github.com/tomzx/agents/tree/main/skills/create-codebase-analysis
Command: npx skills add https://github.com/tomzx/agents --skill create-codebase-analysis-tomzx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before committing to a feature design, teams need to understand the existing code they will touch, extend, or replace. This Skill maps the relevant internal components, their coupling, and blast radius, then assigns each part a change disposition (reuse, extend, refactor, or replace) with migration impact and risk rationale. ## Core Features & Use Cases - Component and Coupling Mapping: Traces requirements to concrete modules, services, and interfaces, rendering dependencies as a Mermaid flowchart with change-disposition classes. - Change Disposition Decisions: Justifies reuse-as-is, extend, refactor, or replace for each component, with migration paths, backward compatibility, and de-risking strategies for refactors and replacements. - Use Case: When requirements call for real-time Kubernetes state instead of polling reconciliation, the analysis locates the reconciliation loop and its consumers, recommends replacing the polling loop with an event-driven consumer behind a feature flag, and keeps the output contract stable. ## Quick Start Run the create-codebase-analysis skill against the approved requirements document for the current feature to produce a codebase-analysis.md artifact.

Frequently Asked Questions about create-codebase-analysis

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

FAQPage Schema
How do I analyze existing code before designing a new feature?▼

Trace the requirements to concrete modules, services, and interfaces, then map dependencies and coupling between components. Assign each part a change disposition (reuse, extend, refactor, or replace) with migration impact and risk rationale before committing to a design.

What is a change disposition in codebase analysis?▼

A change disposition is a decision about how to treat each existing component: reuse as-is, extend along existing seams, refactor internals while preserving behavior, or replace with a new implementation. Refactor and replace dispositions require migration and de-risking plans.

How does codebase analysis differ from an existing solutions survey?▼

An existing solutions survey examines external prior art such as libraries, open source, and products, plus cheap internal reuse. Codebase analysis goes deeper into the internal architecture being modified, mapping components, coupling, and blast radius.

What happens when a feature has no existing code to analyze?▼

The analysis records a short greenfield note naming the integration boundary where the new subsystem will attach to existing systems, then stops. A one-paragraph no-relevant-existing-code record is a valid, complete output.

When should I run codebase analysis in the SDLC pipeline?▼

Run it after the requirements document has passed review with an approved verdict and before feasibility assessment. The output feeds into the feasibility step, which consumes the analysis alongside requirements to judge viability and cost.