Margi — AI agent guide

For Team NovaDrive and judges using Cursor (or similar) on this repo.

Repository focus

Priority	Path	Work here when…
P0	`novadrive-mobile/`	Mobile UX, journey safety, triage, GHP
P1	`docs/`	Plans, submission, brief site
Optional	`novadrive/`	Web prototype mirror

Canonical drive flow: Home → Trip (Plan Corridor) → Start Driving → Calibration → Live SOS HUD → Complete → Home.

Safety-critical logic in novadrive-mobile/src/lib/ — use TDD: failing test first, minimal fix, green suite.
Do not change START triage FSM outcomes or GHP wire format without updating tests.
Never commit .env, API keys, or data/*.db.
Before claiming “done” on mobile: npm run typecheck, npm test, npm run verify:docs, and npm run verify:branding in novadrive-mobile.
Optional device check: DEVICE_SMOKE_MATRIX.md.

Search and install with the Skills CLI:

npx skills find react native testing
npx skills find github actions
npx skills find expo

Example installs (verify package names from search output):

npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y