Choose a guide for what you want to do. Command details and contributor contracts are separate from the app-building walkthrough.
- Get started: check prerequisites, install assistant guidance, create a project and select container, Azure SQL or last-resort Express.
- Build your app: describe an idea, build a first version and make it yours.
- Run locally: choose a startup path, stop and resume.
- Sharing your app: assess App Service first, Container Apps second and qualifying SWA Free last; approve the exact cloud plan.
- Costs and growth: understand local costs and route Azure estimates/analysis to the Azure Cost plugin.
To try something already implemented, use the Todo reference app.
- Independent projects: project manifest, packaged tooling and foundation boundaries.
- Progressive creation: early localhost, capability checks, stable origin, acceptance evidence and owned recovery.
- Local runtime: the role-based-data startup stages, workspace ports, diagnostics and recovery.
- Setup coordinator: connected first-run planning, approved tool installation and safe continuation.
- Remember local permissions: one setup approval covering restore, build, workspace, startup and SQL terms, reusable grants and revocation.
- Manage projects: create independent application repositories under the user-level SQL Apps project root.
- Authentication and application access: account states, local preview, real Entra opt-in, access permissions and current/future hosting boundaries.
- Design acceptance: design intent, the render-critique-improve loop, rendered coverage versus design quality, and final verdicts.
- Application read performance: bounded reads, redundant requests, safe cache proposals and comparable user-action measurements.
- Role-based-data profile: SQL/DAB/browser startup, application-role authorization and private SQL Azure deployment.
- SQL Apps plugin: assistant support, installation, explicit project selection and native loader verification.
- Guide command: saved brief and checkpoint format.
- Monitor usage and growth: free Database Hub preview setup, read-only SQL diagnostics and capacity decisions.
- App Service-first, free-first planning: App Service, Container Apps and complete-free-setup SWA fallback, proposed defaults, consent and Azure handoff.
- Personal-free Azure deployment: existing publisher and qualifying SWA Free fallback, with managed Functions and the Azure SQL Database free tier.
- Contributing: development checks and pull requests.
- Agent guidance evaluations: behavior scenarios for prompt, skill and workflow-boundary changes.
- Application boundaries: keep reference examples out of delivered applications.
- Naming transition: migration notes for existing development checkouts.
Temporary implementation plans and session notes belong in ignored docs/superpowers/ or session storage. They are not product guidance and must not be committed as authoritative documentation.