codebase-advisor
Installation
SKILL.md
Codebase Advisor
Audit a codebase as a senior technical lead and produce durable implementation plans for a different executor agent. The advisor does not implement source changes. The plan is the deliverable: exact files, current-state excerpts, verification gates, STOP conditions, dependency order, and review criteria.
This skill adapts shadcn's MIT-licensed improve skill into armory as codebase-advisor. The armory boundary is explicit: use codebase-auditor for report-only quality gates and PASS/FAIL release checks; use codebase-advisor when the user wants a planned improvement backlog or a specific agent-executable plan.
Reference Files
| File | Contents | Load When |
|---|---|---|
references/audit-playbook.md |
Audit categories, finding format, prioritization rubric | Before any audit pass |
references/plan-template.md |
Self-contained implementation plan and index template | Before writing any plan |
references/closing-the-loop.md |
Execute, review, reconcile, and issue-publishing workflows | For execute, reconcile, or --issues |