devcheck
Lint, format, typecheck, and verify the project is clean. Use after making changes, before committing, or when the user asks to verify quality.
What It Runs
bun run devcheck runs a broader check suite than just lint + types. By default it includes local hygiene checks, MCP definition linting, Biome, TypeScript, and slow dependency/security checks unless --fast is passed. Tests are opt-in via --test.
| Check | Tool | Notes |
|---|---|---|
| TODOs / FIXMEs | git grep | Fails on tracked TODO/FIXME markers outside excluded files |
| Tracked secrets | git ls-files | Flags tracked .env, keys, credentials, and similar sensitive files |
| MCP definitions | bun run scripts/lint-mcp.ts | Validates tool/resource/prompt definitions against framework rules |
| Biome | biome check | Unified lint + format — read-only by default |
| TypeScript | tsc --noEmit | Full project type check |
| Unused dependencies | depcheck | Runs by default; network-free but slower on large repos |
| Security audit | bun audit | Runs by default unless --fast or --no-audit |
| Outdated dependencies | bun outdated | Runs by default unless --fast or --no-deps |
| Tests | vitest run | Off by default; enable with bun run devcheck --test |
To auto-fix lint/format issues, run bun run format.
Steps
- Run
bun run devcheck - Read the failing checks in the summary and per-check output
- Fix the reported issues
- Re-run
bun run devcheckuntil clean - If the change touches runtime behavior, also run
bun run devcheck --testorbun run test - Do not consider this skill complete until the required commands exit successfully with no errors
Common Issues
| Check | Error Type | Typical Fix |
|---|---|---|
| TODOs / FIXMEs | Tracked work markers | Resolve or remove the marker before committing |
| Tracked secrets | Sensitive files in git | Add to .gitignore and remove from the index |
| MCP definitions | Definition lint errors | Fix schema/name/annotation issues reported by lint-mcp |
| Biome | Lint/format errors | Run bun run format to auto-fix, or address the flagged rule manually |
| TypeScript | Type errors | Fix type mismatches, missing properties, incorrect generics |
| Security audit | Vulnerabilities in direct deps | Update or replace the affected dependency |
| Outdated deps | Stale package versions | Run bun update or allowlist intentionally pinned packages |
Checklist
-
bun run devcheckexits with no errors - Tests run when needed (
bun run devcheck --testorbun run test)