improve-project
Installation
SKILL.md
Goal
Realign an established project with applicable stack preferences in small verified stages, or return its staged plan. Use init-project to start a new project instead.
Definition of Done
- Alignment, preserved contracts, package/runtime choices, and stage boundary are explicit.
- A plan contains stages, acceptance, recovery, and gaps without execution or data changes.
- An authorized stage has configuration and behavior evidence or a labeled platform gap.
- Data transitions have required recovery and authorization evidence.
- Current validation accepts the selected mode; an unmet required criterion remains REVISE or BLOCKED.
Workflow
- Resolve target alignment, current state, rules, authority, preserved contracts, replacement scope, criteria, and proof.
- When alignment or package choices are in scope, use Project alignment and Stack packages with the mode, scope, candidate, and evidence. For a selected TypeScript, ESLint, workspace, Convex, CI, or performance concern, use that reference; in planning, inspect criteria and propose checks only. Otherwise compare consumer evidence, exports, peers, data owners, and compatibility directly. Define the smallest stage.
- In change mode, capture an authorized baseline, then apply one authorized stage with exact dependency and configuration checks. Structured logging in Node/Next.js server code, Convex actions, and CLIs defaults to
@vllnt/loggerper default packages; replaceconsoleor a per-app pino setup only as a named stage. Product analytics and event tracking in web apps on the @vllnt stack default to@vllnt/analytics. - In change mode, verify data or backend mapping, authorization, reconciliation, recovery, and cutover ownership before dependent work.
- In change mode, verify affected consumers, entry points, platforms, failures, and data invariants. In planning mode, return stages, acceptance, recovery, and gaps only. For substantive work, use Quality validation with the mode, scope, candidate, and evidence; otherwise apply its feedback loop directly. Renew affected verdicts after each repair.