What it is
improve-codebase-architecture is a skill for finding deeper structural opportunities in a repository. Its source guidance points the agent toward local context, ADRs, consolidation, and refactoring opportunities.
Why it is useful
Architecture work is risky when an agent refactors without context. This skill makes the agent inspect project history and existing decisions before proposing or applying changes.
Best uses
- Audit a mature codebase for duplication and unclear boundaries.
- Prepare a focused architecture refactor.
- Review whether a new abstraction is justified.
Notes
Use it as an audit and planning tool first. Implementation should still be scoped, reviewed, and covered by tests where behavior changes are possible.