Better Codebase v0.1.0 — Initial Release

Better codebase, not bigger codebase

Better Codebase is an evidence-first collection of agent skills for improving existing software without overengineering it.

Instead of mechanically applying SOLID, DRY, Clean Architecture, or the latest dependency versions, it requires every recommendation to show its evidence, impact, smallest safe change, and verification method.

What’s included

This release introduces one orchestrator and seven focused skills:

• better-codebase — holistic review and safe implementation
• better-architecture — boundaries and dependency direction
• better-simplicity — KISS, YAGNI, and unnecessary complexity
• better-duplication — repeated knowledge without forced DRY
• better-maintainability — clarity, control flow, and changeability
• better-dependencies — package health and migration risk
• better-testing — critical behavior and trustworthy tests
• better-performance — measured bottlenecks and complexity issues

Core principles

• Preserve intended behavior.
• Group symptoms by root cause.
• Cite exact files and lines.
• Prefer the smallest safe change.
• Separate review, planning, and implementation.
• Verify changes with relevant tests and checks.
• Record improvements that were considered but deliberately rejected.
• Avoid unnecessary rewrites.

Install

npx skills add NicolasYusim/better-codebase --skill '*'