=================================================================== --- a/AGENTS.md +++ b/AGENTS.md @@ -1,14 +1,21 @@ -# Chat — Agent Guide +# App — Agent Guide -Chat is the minimal chat-first agent-native app. `/` redirects to shared sign-in, then `/home`, the editable Get started page. Chat lives at `/chat`; new chats start there. Actions carry capabilities; screens exist only for durable workflows. +This starter ships as a blank Agent-Native app canvas — that describes its +initial state, not necessarily its current one. See `DEVELOPING.md` before +making any source code change. ## Skills Search with `rg --hidden --follow`; read the exact linked guide before deeper work. `.agents/skills/build-an-app/SKILL.md` — start here for vague requests to create a domain app. `.agents/skills/adding-a-feature/SKILL.md` — cross-area feature checklist. Data/integrations: `.agents/skills/actions/SKILL.md`, `.agents/skills/storing-data/SKILL.md`, `.agents/skills/security/SKILL.md`, `.agents/skills/secrets/SKILL.md`, `.agents/skills/sharing/SKILL.md`. UI: `.agents/skills/frontend-design/SKILL.md`, `.agents/skills/shadcn-ui/SKILL.md`, `.agents/skills/client-side-routing/SKILL.md`. Agent context/workflows: `.agents/skills/context-awareness/SKILL.md`, `.agents/skills/real-time-sync/SKILL.md`, `.agents/skills/reliable-mutations/SKILL.md`, `.agents/skills/performance/SKILL.md`, `.agents/skills/delegate-to-agent/SKILL.md`. Framework: `.agents/skills/agent-native-docs/SKILL.md`, `.agents/skills/agent-native-toolkit/SKILL.md`, `.agents/skills/customizing-agent-native/SKILL.md`. Use local docs only (no web research): `pnpm action docs-search --query ""`, `pnpm action docs-search --slug ""`, `pnpm action docs-search --list`, `pnpm action source-search --query ""`, `pnpm action source-search --path `, or `pnpm action source-search --list`. For external-agent integrations, read `pnpm action docs-search --slug "external-agents"`. +This repo is a single standalone app (`agent-native.scaffold.shape: +"standalone"`), not a workspace root. If the user asks for a workspace, a +platform or suite of apps, a second app, an app shell or launcher, or Dispatch, +read the `multi-app-workspace` skill before touching the repo layout. + ## Core rules - UI feedback: target 100 ms, never exceed 400 ms; acknowledge before network work. - Normal app data must flow through actions. Keep actions deterministic and focused; use agent chat/AgentSidebar for AI work and follow-ups in the same thread. Keep structured state in SQL and large files in configured storage; persist references only. @@ -18,14 +25,18 @@ For custom branding, keep `server/plugins/agent-native-email-branding.ts` aligned: `app.name` appears in transactional email and optional `app.logoUrl` must be an absolute HTTPS URL. ## Application state -- `navigation` describes the view and selected ids. Chat is `chat` at `/chat` and `/chat/`; the Get started page is `home` at `/home`; `/` opens shared sign-in/signup. +- `navigation` describes the view and selected ids. The default home view is + `home` at `/` (blank app canvas). No agent rail or chat is mounted by + default; add one only when the user asks. - Use `navigate` when supported and `view-screen` for a fresh read of visible details; basic navigation is already in ``. ## Building a domain app -Choose the primary workflow and route before editing. Add a domain route under `app/routes/` and set `app.homePath` in `server/plugins/agent-native-email-branding.ts` with `defineAppConfig`. The default Get started page lives at `/home`, and Chat stays at `/chat`; edit `app/routes/home.tsx` when replacing that page with a domain-specific home. Add a static link in `app/components/layout/Sidebar.tsx` before `ChatThreadsSection`; `Header.tsx` uses `APP_TITLE` elsewhere. Shared sidebar and AgentInspector remain. +Choose the primary workflow and route before editing. Build on the blank canvas in `app/routes/_index.tsx` or add domain routes under `app/routes/`. This starter has no Chat route, sidebar, header, or agent rail; add only the navigation the product needs. Set `app.homePath` in the existing `defineAppConfig` in `server/plugins/config.ts` as `DEVELOPING.md` describes. -Use `adding-a-feature` for functional parity and `frontend-design` for a user-facing screen. Keep feature guidance here; do not rewrite `README.md` or `DESIGN.md`. After all edits, run one typecheck, one doctor check, and one browser smoke of the primary workflow, including overlap rejection, cancellation freeing the slot, and authenticated landing. Skip production build and extra test suites. +Use `adding-a-feature` for functional parity and `frontend-design` for a user-facing screen. Keep feature guidance here and update `README.md` as `DEVELOPING.md` describes. After all edits, run one typecheck, one doctor check, and one browser smoke of the primary workflow and its authenticated landing. Skip production build and extra test suites. Before building common workspace or agent UI, read `agent-native-toolkit`; for supported customization, read `customizing-agent-native`. + +- Guarded verification: run `pnpm agent-native:doctor`; fix findings before done.