Skip to main content

FAQ (No More Confusion)

Where should I start?​

Start from Start Here (No Confusion) and follow the 4 steps.

What should I write first: code or PRD?​

Always start with PRD (docs/PRODUCT_REQUIREMENTS.md).

What is FR?​

FR = Functional Requirement. One FR represents one specific requirement/feature, for example:

  • FR-001 Login
  • FR-002 Profile
  • FR-003 Role Management

FR format makes implementation + testing + review clear.

What are the minimum docs I must update?​

In this process, AI agents update these technical docs during implementation:

  • OpenAPI
  • DBML
  • Business Flow
  • requirement changelog if scope changes.

Your job: review & approve doc updates, not manually write everything.

When can I say "feature done"?​

When php artisan starter:quality-gate is PASS and docs are synced.

What if the project gets more complex?​

Use modular structure:

  • ai/agents/{core,api,admin,data,qa}
  • ai/prompts/{prd,implementation,review}

What if I just want to test quickly?​

Use Docker Compose:

docker compose up -d --build