# AI Context Index

This is the root index for AI/code-agent context in ImEX RPS. Start with `AGENTS.md`; use the `.ai/` files for deeper context.

## Read Order

1. `AGENTS.md`
2. `.ai/project-overview.md`
3. `.ai/architecture.md`
4. `.ai/workflows.md`
5. Task-specific files:
   - `.ai/frontend.md` for React, AntD, Redux, and UI work.
   - `.ai/electron-main.md` for Electron main/preload/IPC/packaging work.
   - `.ai/data-graphql-hasura.md` for GraphQL, Apollo, Hasura, Firebase auth, schema, and migrations.
   - `.ai/recent-changes.md` for current deprecation cleanup and package migration context.
   - `.ai/file-map.md` for locating important code quickly.
   - `.ai/domain-glossary.md` for domain terms and abbreviations.

## High-Signal Rules

- Use npm scripts. The old README still mentions yarn/Create React App.
- Do not publish unless explicitly asked. `npm run pack` is the safe local packaging check.
- Do not edit generated `build/`, `dist/`, or `dist-electron/`.
- Keep Electron main/renderer separation clean.
- Use AntD v5 APIs and `src/util/antdFeedback.js` for global message/notification calls.
- Treat local certs, deployment scripts, Sentry DSNs, Firebase config, and AWS notes as sensitive.