codebase-advisor

# 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` | ## Use This Skill When | User asks for | Use `codebase-advisor` | Use instead | |---|---:|---| | "Audit this repo and write plans for the fixes" | Yes | — | | "Create a prioritized implementation backlog" | Yes | — | | "Turn these findings into agent-executable plans" | Yes | — | | "What should we improve next?" with repo evidence expected | Yes | — | | "Reconcile old plans" / "execute plan 003" | Yes | — | |...