Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

codebase-analysis

/codebase-analysis

Dostarcza wzorce i techniki analizy istniejących baz kodu (brownfield) przy wdrażaniu do nieznanego kodu, przygotowaniu refaktoryzacji, przeglądach architektury i wykrywaniu długu technicznego.

Licencja
MIT
Ostatnia zmiana repozytorium
21.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 21.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dostarcza wzorce i techniki analizy istniejących baz kodu (brownfield) przy wdrażaniu do nieznanego kodu, przygotowaniu refaktoryzacji, przeglądach architektury i wykrywaniu długu technicznego.

Oryginalny opis (EN)

Patterns and techniques for analyzing brownfield codebases. Use when onboarding to unfamiliar code, preparing for refactoring, conducting architecture reviews, or identifying technical debt.

Jak działa

  1. Variables
  2. Instructions
  3. Red Flags - STOP and Reconsider
  4. Workflow
  5. Cookbook
  6. Quick Reference
  7. Output
Sekcje z nagłówków SKILL.md, w oryginale · 116 linii, 481 słów
Podgląd SKILL.md
---
name: codebase-analysis
description: "Patterns and techniques for analyzing brownfield codebases. Use when onboarding to unfamiliar code, preparing for refactoring, conducting architecture reviews, or identifying technical debt."
---

# Codebase Analysis Skill

Systematically explore and understand existing codebases, including entry point discovery, dependency tracing, pattern detection, and technical debt identification.

## Variables

| Variable | Default | Description |
|----------|---------|-------------|
| ANALYSIS_DEPTH | standard | `quick` (5min), `standard` (30min), `deep` (1hr+) |
| OUTPUT_FORMAT | markdown | `markdown`, `json`, `c4` |
| INCLUDE_DEBT | true | Include technical debt assessment |
| INCLUDE_DIAGRAMS | true | Generate C4 diagrams |

## Instructions

**MANDATORY** - Follow the Workflow steps below in order. Do not skip steps.

- Start with entry points, not random files
- Trace dependencies before analyzing patterns
- Document findings as you go

## Red Flags - STOP and Reconsider

If you're about to:
- Analyze random files without finding entry points first
- Make architectural claims without tracing dependencies
- Skip pattern detection before identifying anti-patterns
- Report technical debt without severity classification

**STOP** -> Read the appropriate cookbook file -> Follow the workflow -> Then proceed

## Workflow

1. [ ] Quick Assessment: Project size, structure, config files
2. [ ] **CHECKPOINT**: Identify entry points (read `cookbook/entry-point-discovery.md`)
3. [ ] Trace dependencies from entry points
4. [ ] Detect architectural patterns
5. [ ] **CHECKPOINT**: Verify pattern detection before anti-pattern search
6. [ ] Identify anti-patterns and technical debt
7. [ ] Document findings with C4 diagrams (if INCLUDE_DIAGRAMS)

## Cookbook

### Entry Point Discovery
- IF: Starting analysis of unfamiliar codebase
- THEN: Read `cookbook/entry-point-discovery.md`
- RESULT: List of main entry points by framework

### Dependency Tracing
- IF: Need to understand how modules connect
- THEN: Read `cookbook/dependency-tracing.md`
- RESULT: Import chains, dependency graph

### Pattern Detection
- IF: Need to identify architectural style
- THEN: Read `cookbook/pattern-detection.md`
- RESULT: Identified patterns (MVC, Layered, etc.)

### Technical Debt Identification
- IF: Assessing code quality and debt
- THEN: Read `cookbook/debt-identification.md`
- RESULT: Prioritized debt inventory

## Quick Reference

### Entry Points by Stack

| Stack | Look For |
|-------|----------|
| Node.js | `package.json` main/bin, `index.js`, `server.js` |
| TypeScript | `tsconfig.json`, `src/index.ts` |
| Python | `__main__.py`, `app.py`, `wsgi.py` |
| Go | `main.go`, `cmd/*/main.go` |
| React | `src/index.tsx`, `pages/_app.tsx` |

See `reference/framework-patterns.md` for complete list.

### Common Patterns

| Pattern | Directory Signs |
|---------|-----------------|
| MVC | `models/`, `views/`, `controllers/` |
| Layered | `presentation/`, `business/`, `data/` |
| Hexagonal | `domain/`, `ports/`, `adapters/` |
| Microservices | `services/*/`, `packages/*/` |

## Output

### Standard Report Format

```markdown
# Codebase Analysis: [Project Name]

## Overview
- **Size**: X files, Y lines
- **Primary Language**: TypeScript
- **Framework**: Next.js
- **Architecture**: [Pattern]

## Entry Points
1. `src/pages/_app.tsx` - Application root
2. `src/api/` - API routes

## Key Dependencies
- [External deps list]

## Architecture Diagram
[C4 diagram if INCLUDE_DIAGRAMS]

## Technical Debt (if INCLUDE_DEBT)
| Issue | Severity | Location |
|-------|----------|----------|
| ... | High | ... |
```
Pliki w paczce (6)
  • SKILL.md 4 KB
  • cookbook/debt-identification.md 4 KB
  • cookbook/dependency-tracing.md 4 KB
  • cookbook/entry-point-discovery.md 4 KB
  • cookbook/pattern-detection.md 4 KB
  • reference/framework-patterns.md 5 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · Consiliency/treesitter-chunker100MIT
hellblazer/nexus100AGPL-3.0
7as0nch/mimo2codex100MIT
sequenzia/agent-alchemy100MIT
sequenzia/agent-alchemy100MIT
sequenzia/agent-alchemy100MIT
sequenzia/agent-alchemy95MIT
sequenzia/agent-alchemy95MIT
sequenzia/agent-alchemy90MIT

Migawka bazy z 13.11.2026 · wersja paczki 5e3fc0dc7750 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100qe-refactoring-patterns
    Stosuje bezpieczne wzorce refaktoryzacji, które poprawiają strukturę kodu bez zmiany zachowania, przy porządkowaniu kodu i redukcji długu technicznego.
  • 100code-analysis
    Pomaga analizować nieznane moduły kodu, rozumieć architekturę systemu i przygotować się do refaktoryzacji.
  • 95repository-analyzer
    Analizuje bazy kodu i generuje dokumentację: struktura, języki, frameworki, zależności, wzorce projektowe i dług techniczny, przy poznawaniu nieznanego kodu.
  • 100tech-debt-analyzer
    Analizuje dług techniczny w bazie kodu i dokumentuje problemy jakości: code smells, problemy architektury i zależności, braki w dokumentacji, podatności oraz rejestr długu technicznego.
  • 100tech-debt
    Skanuje kod pod kątem wskaźników długu technicznego, kategoryzuje i priorytetyzuje ustalenia oraz prowadzi rejestr długu z rekomendacjami spłaty.
  • 100refactoring
    Zawiera opis 89 technik refaktoryzacji i 22 code smells z mechaniką i przykładami przed i po, do wykrywania smells i spłacania długu technicznego.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.