// Pre-release checklist. Runs all 4 agents plus snapshot regression test, TypeScript check, and semver confirmation. Run before publishing a new package version.
Guide for creating a new UI component in @gridland/ui. Covers file structure, focus integration, keyboard handling, theme usage, JSDoc, export registration, and documentation.
Review a component for production readiness as a UI framework. Assesses code quality, patterns, tests, docs, and API design. Produces a prioritized fix plan. Use before shipping a new or updated component to users.
Update context files to reflect current codebase state — new components, changed APIs, new patterns, and reasoning behind non-obvious decisions. Routes updates to the correct file based on what changed. Run after any significant design change before committing.
Audit the browser rendering pipeline for scissor/clipping bypass bugs. Use when touching browser-buffer.ts, canvas-painter.ts, or adding new visual features.
Diagnose layout issues in Gridland components. Spawns the layout-debugger agent with the relevant component. Use when a component renders incorrectly or layout looks wrong.
Documentation-focused review. Runs docs-mirror and dependency-auditor in parallel. Use after writing or updating documentation, demo components, or MDX pages.
| name | release-check |
| description | Pre-release checklist. Runs all 4 agents plus snapshot regression test, TypeScript check, and semver confirmation. Run before publishing a new package version. |
Pre-release checklist before publishing a new package version.
git diff --name-only $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~10") HEAD
Get current versions:
grep '"version"' packages/ui/package.json packages/utils/package.json
Spawn simultaneously as background agents:
contract-guardian — API changes and semver recommendationframework-compliance — patterns, anti-patterns, vendor boundarydocs-mirror — documentation accuracydependency-auditor — external library usagebun run --cwd packages/ui build 2>&1 | tail -30
bun run --cwd packages/utils build 2>&1 | tail -20
Flag any TypeScript errors as release blockers.
bun run --cwd packages/ui test 2>&1 | tail -40
bun run --cwd packages/web test 2>&1 | tail -40
Report which snapshots changed. Ask for explicit confirmation before updating.
git diff HEAD -- CLAUDE.md packages/ui/CLAUDE.md packages/docs/CLAUDE.md .claude/rules/
If context files are out of date, warn and suggest running /sync-context.
## Release Check Report
### Release Blockers
- [list of critical issues from all agents]
- [TypeScript errors]
- [Unexpected snapshot changes]
### Warnings
- [non-critical issues]
### TypeScript Status
- packages/ui: PASS/FAIL
- packages/utils: PASS/FAIL
### Snapshot Status
- Changed: [list] — need explicit confirmation
- Unchanged: [count]
### Semver Recommendation
**[MAJOR | MINOR | PATCH]** — based on contract-guardian findings
Current: X.X.X → Suggested: X.X.X
### Agent Summary
- contract-guardian: [pass/fail]
- framework-compliance: [pass/fail]
- docs-mirror: [pass/fail]
- dependency-auditor: [pass/fail]
Do not publish or update versions without explicit user confirmation.