Guides

Getting started

This guide walks one loop end to end, from opening a project to validated execution.

1. Open a project

Sidebar → Open folder. DevAware OS inspects package.json, the lockfile, framework configs, Supabase, Playwright, and .claude/, and lists .env* files with secret-shaped values masked.

2. Write intent

Type what you want in natural language. No template, no structured fields. A P0 filter flags low-signal intents before they proceed.

3. Analyze

A local open-source model (or the offline heuristic analyzer) classifies objective, scope, inspection areas, P0 constraints, token mode, risk, and validation gates.

4. Apply governance blocks

Recommended blocks light up. Toggle them, add custom blocks, persist a per-project set.

5. Compile the clean prompt

The prompt weaver produces the final prompt with objective, scope, inspection requirements, P0 constraints, active blocks, detected validation commands, and a final-report contract. Inspect it in the context modal before sending.

6. Execute, then validate

Send the prompt to the embedded terminal or run a governed chat turn. Detected typecheck, lint, test, and build:renderer commands feed the validation section; the agent allowlist can invoke that fixed subset. Full builds stay in the terminal under your control.