|
| 1 | +# AGENTS.md |
| 2 | + |
| 3 | +## Repo Snapshot |
| 4 | +- This is a single-module Vite + React + TypeScript app. |
| 5 | +- Most product code lives in `src/`; deployment lives in `.github/workflows/deploy.yml`; release notes and process docs live in `docs/`. |
| 6 | +- Pushes to `main` trigger the live Firebase Hosting deploy, so prefer feature branches and PRs unless the user explicitly wants a live `main` update. |
| 7 | + |
| 8 | +## Read First |
| 9 | +- Start with `README.md` for setup, scripts, and env vars. |
| 10 | +- Read `docs/deployment.md` and `docs/release-checklist.md` before changing CI or release behavior. |
| 11 | +- When touching the new layout/mobile flow, read `docs/ux-effects-plan.md`. |
| 12 | + |
| 13 | +## Working Rules |
| 14 | +- Read the existing code and docs before changing behavior. |
| 15 | +- Prefer minimal, local changes over broad rewrites. |
| 16 | +- If a task spans multiple files, the most likely hotspots are `src/App.tsx`, `src/GraphManager.ts`, `src/components/*`, `src/hooks/useGraphState.ts`, and matching tests under `src/`. |
| 17 | +- Do not commit generated local artifacts such as `.preview.*` or `.playwright-cli/`. |
| 18 | +- If instructions or release steps seem stale, call that out explicitly in the handoff. |
| 19 | + |
| 20 | +## Verification |
| 21 | +- Install dependencies with `npm ci`. |
| 22 | +- Core local checks are `npm run lint`, `npm run test`, and `npm run build`. |
| 23 | +- Use `npm run check` as the default pre-merge gate. |
| 24 | +- If UI, search, or mobile interaction behavior changes, also run `npm run smoke`. |
| 25 | + |
| 26 | +## Done Means |
| 27 | +- The requested behavior is implemented on the intended branch. |
| 28 | +- `npm run check` passes locally. |
| 29 | +- `npm run smoke` passes when UI/search/mobile behavior changed. |
| 30 | +- Any required docs or workflow notes were updated alongside the code change. |
0 commit comments