Skip to main content

Start Here (No Confusion) ✅

If you only have 5 minutes, follow this:

1) Run the starter kit​

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

2) Verify services​

  • App: http://localhost:8000
  • Admin: http://localhost:8000/admin/login
  • Swagger: http://localhost:8000/docs/v1
  • Docs portal: http://localhost:3000

3) Deliver your first feature (mandatory order)​

  1. Write requirement in docs/PRODUCT_REQUIREMENTS.md
  2. Implement feature
  3. Ask AI agent to update required docs (automatic), then review:
    • docs/api/openapi.yaml
    • docs/db/schema.dbml
    • docs/BUSINESS_FLOW.md
  4. Run: 
    php artisan starter:quality-gate
    php artisan starter:docs-regenerate v1

4) When is a feature considered done?​

A feature is done only if:

  • quality gate PASS
  • required docs updated
  • PRD acceptance criteria fulfilled

5) Expected result​

  • faster coding (vibe coding)
  • fewer bugs/regressions
  • docs always in sync
  • easy scaling to complex scope