codebase-assessment
Use when starting open-ended tasks in unfamiliar codebases, before following existing patterns
When & Why to Use This Skill
The Codebase Assessment skill is a strategic diagnostic tool designed for developers and AI agents to evaluate the maturity, architectural patterns, and technical health of unfamiliar repositories. By systematically analyzing configuration files, dependency signals, and structural consistency, it prevents the propagation of outdated or 'chaotic' coding patterns. This skill ensures that every new contribution is context-aware, aligning perfectly with the project's current state—whether it is a strictly disciplined environment, a transitional legacy system, or a modern greenfield project.
Use Cases
- Project Onboarding: Rapidly identify the 'source of truth' for coding standards and architectural conventions when entering a new or unfamiliar codebase.
- Technical Debt Evaluation: Detect missing or outdated configurations in linters, formatters, and type-checking tools to assess project maintenance quality.
- Pattern Alignment: Sample existing files to determine if the project follows modern best practices or requires adherence to specific legacy patterns to maintain consistency.
- Strategic Refactoring: Classify the codebase state (Disciplined, Transitional, or Legacy) to decide whether to propose modern improvements or follow existing conventions.
- Pre-development Verification: Ensure that assumptions about project structure and dependencies are validated before implementing open-ended tasks.
| name | codebase-assessment |
|---|---|
| description | Use when starting open-ended tasks in unfamiliar codebases, before following existing patterns |
Codebase Assessment
Assess codebase maturity before implementing. Don't blindly follow patterns that may be outdated or inconsistent.
Quick Assessment Checklist
- Check config files: linter, formatter, type config present?
- Sample 2-3 similar files: Are patterns consistent?
- Note project age signals: Dependencies current? Patterns modern?
State Classification
| State | Signals | Your Behavior |
|---|---|---|
| Disciplined | Consistent patterns, configs present, tests exist | Follow existing style strictly |
| Transitional | Mixed patterns, some structure | Ask: "I see X and Y patterns. Which to follow?" |
| Legacy/Chaotic | No consistency, outdated patterns | Propose: "No clear conventions. I suggest [X]. OK?" |
| Greenfield | New/empty project | Apply modern best practices |
Verification Before Assuming
If codebase appears undisciplined, verify before assuming:
- Different patterns may serve different purposes (intentional)
- Migration might be in progress
- You might be looking at the wrong reference files
What To Check
| Area | Check For |
|---|---|
| Style | ESLint/Prettier/Biome config, consistent formatting |
| Types | tsconfig.json strictness, type coverage |
| Testing | Test framework, coverage expectations, test file patterns |
| Structure | Folder conventions, naming patterns, module boundaries |
| Dependencies | Package age, maintenance status, duplicate functionality |
Output Format
After assessment, state:
Codebase state: [Disciplined/Transitional/Legacy/Greenfield]
Key patterns to follow: [list 2-3]
Concerns noted: [any issues observed]
Proceeding with: [your approach]