Imported from rmValdez/soveriegn-brain-app (
AGENTS.md). Install upstream withnpx skills add rmValdez/soveriegn-brain-app. Copyright stays with the author.
Agent Instructions for Next.js App (soveriegn-brain-app)
See full architecture handbook in docs/ENGINEERING_HANDBOOK.md.
Critical Enforcement Rules
- Package Manager: Strictly
pnpm. Never executenpm,npx, oryarn. - Three-Tier Architecture:
src/app: Dumb routing & layout composition only. No raw API fetches or@tanstack/react-query.src/features/*: Strictly isolated. Feature A cannot import from Feature B.src/shared/*: Pure generic infrastructure. Cannot import fromfeaturesorapp.
- Data Fetching:
- Server state in
@tanstack/react-queryusing key factories (no raw string keys). - UI state in
zustand. - Zod runtime schema contracts in
features/<feature>/contracts/.
- Server state in
- Validation Pipeline:
Always run and ensure these pass:
pnpm validatepnpm type-checkpnpm lint