Skip to main content

First 1-Hour Checklist (New Programmer)

Goal: within 1 hour, you understand the starter kit flow and can deliver one clean small change.

Minute 0–10: Run the project​

cd projects/vibe-starterkit
docker compose up -d --build

Check:

  • App: http://localhost:8000
  • Docs portal: http://localhost:3000

Minute 10–20: Understand the source of truth​

Quick-read:

  1. docs/PRODUCT_REQUIREMENTS.md
  2. docs/VIBE_CODING_FLOW.md
  3. docs/STARTERKIT.md

Minute 20–30: Create 1 mini PRD​

Add one small FR in docs/PRODUCT_REQUIREMENTS.md. Example: add endpoint GET /api/v1/auth/me for profile detail.

Minute 30–45: Implement + update docs​

  • Implement code
  • Update docs/api/openapi.yaml (with examples)
  • Update docs/BUSINESS_FLOW.md (if flow changes)

Minute 45–60: Final validation​

php artisan starter:quality-gate
php artisan starter:docs-regenerate v1
php artisan starter:smoke-test

If everything is green ✅, your change is ready for review.