| name | setup-project |
| description | Onboards a new developer - explains the project, runs setup steps, verifies everything works |
| user-invocable | true |
| allowed-tools | Bash Read Glob |
| effort | medium |
Project Setup & Onboarding
- Read the project:
cat README.md 2>/dev/null | head -60
cat package.json | grep -E '"name"|"description"|"scripts"' -A 10
ls src/ 2>/dev/null
- Run the setup sequence:
npm install 2>&1 || bun install 2>&1
ls .env* 2>/dev/null
- Env vars check - if
.env is missing, copy from .env.example and list what needs filling:
cp .env.example .env 2>/dev/null && echo "Created .env from example"
- Database setup:
npx prisma migrate dev 2>/dev/null || echo "No Prisma detected"
- Run the dev server:
npm run dev 2>&1 | head -20 &
sleep 3
curl -s http://localhost:3000/health 2>/dev/null || echo "Check manually"
- Run tests:
npm test 2>&1 | tail -10
- Produce a summary report:
Project: [name]
Stack: [detected tech]
Setup: ✅ complete / ❌ issues found
Next steps for new developer:
1. Fill in .env: STRIPE_SECRET_KEY, SENDGRID_API_KEY
2. Run: npm run db:seed
3. Read: docs/architecture.md