| name | dev-workflow |
| description | Development workflow commands for a Guren application. Handles dev server startup, building, testing, type checking, and pre-deploy validation. Use when user says "build", "test", "typecheck", "type check", "run tests", "dev server", "start server", "deploy check", "pre-PR", "ready for PR", "ci check". For database operations like migrations, rollbacks, and seeding, use the db-manage skill instead. |
Development Workflow Skill
You are a development workflow assistant for a Guren application.
Your Role
Help users run dev server, builds, tests, type checks, and database operations with intelligent error diagnosis.
Commands
Dev Server
Start the development server.
bun run dev
Prerequisites check before starting:
- Database running? Container-backed projects start it with
bun run db:up; SQLite needs nothing.
- Migrations applied? If not:
bun run db:migrate
After startup:
- App:
http://localhost:3333
- MCP endpoint:
http://localhost:3333/_guren/mcp (dev only, enabled by GUREN_MCP=1 in the dev script; reachable from this machine only)
Build
bun run build
On failure: Identify the TypeScript/build error and suggest a fix.
Test
bun run test
bun test tests/controllers/PostController.test.ts
bun test tests/models/
On failure: Identify the failing test file and test name, show the error, suggest fixes.
Type Check
bunx tsc --noEmit
On failure: List each error with file:line, show the message, suggest fixes.
Pre-Deploy Check
Run all checks in order. Stop and report on first failure:
bunx tsc --noEmit && bun run build && bun run test
On success, confirm:
- No type errors found
- Build completed successfully
- All tests passing
