Improve Codebase Architecture
Skill Verified ActiveFind deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
To help developers systematically improve the architecture of their codebase by identifying and addressing architectural friction points, making code more testable and easier for AI to navigate.
Features
- Identifies deepening opportunities in codebases
- Leverages domain language (CONTEXT.md) and ADRs
- Focuses on improving testability and AI-navigability
- Guides user through exploration, candidate presentation, and decision refinement
- Promotes consistent architectural vocabulary (LANGUAGE.md)
Use Cases
- Improving the architecture of a complex or aging codebase
- Finding refactoring opportunities to consolidate tightly-coupled modules
- Making modules deeper by increasing leverage at their interfaces
- Enhancing the testability of critical codebase sections
Non-Goals
- Performing the refactoring automatically
- Suggesting architectural changes that contradict existing ADRs without clear justification
- Generating code or interfaces without user input
- Replacing developer judgment in architectural decisions
Practical Utility
- info:Usage examplesWhile the README provides a general installation and setup guide, explicit, ready-to-use examples demonstrating the 'improve-codebase-architecture' skill's input, invocation, and observable output are not present.
Installation
/plugin install skills@mattpocock-skillsQuality Score
VerifiedTrust Signals
Similar Extensions
Pathfinder
100Map a codebase into feature-grouped flowcharts, identify duplicated concerns across features, and propose a unified architecture. Use when asked to "find the ideal path," unify duplicated systems, or audit architecture before a refactor. Emits a proposed unified flowchart plus per-system /make-plan prompts.
Moyu (摸鱼)
100과잉 엔지니어링 패턴이 감지되면 자동으로 활성화됩니다: (1) 사용자가 명시적으로 변경을 요청하지 않은 코드나 파일을 수정하는 경우 (2) 요청되지 않은 새로운 추상화 레이어(class, interface, factory, wrapper)를 생성하는 경우 (3) 요청되지 않은 주석, 문서, JSDoc, 타입 어노테이션을 추가하는 경우 (4) 요청되지 않은 새로운 의존성을 도입하는 경우 (5) 최소한의 편집 대신 파일 전체를 다시 작성하는 경우 (6) diff 범위가 사용자의 요청을 명백히 초과하는 경우 (7) 사용자가 "너무 많아", "거기는 건드리지 마", "X만 변경해", "간단하게", "그만" 등의 신호를 보내는 경우 (8) 발생할 수 없는 시나리오에 대한 에러 처리, 유효성 검사, 방어적 코드를 추가하는 경우 (9) 요청되지 않은 테스트, 설정 스캐폴딩, 문서를 생성하는 경우
V3 Ddd Architecture
100Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern.
Understand
100Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
Lean Ctx
100Context Runtime for AI Agents — 59 MCP tools, 10 read modes, 95+ shell patterns, tree-sitter AST for 18 languages. Compresses LLM context by up to 99%. Use when reading files, running shell commands, searching code, or exploring directories. Auto-installs if not present.
Migrate Validate
100Validate pending migrations for foreign key consistency, rollback safety, and best practices