psp_api/Agents.md

AGENTS.md

Stack

• NestJS
• Prisma
• TypeScript
• pnpm
• RTK enabled

---

Core Rules

• Keep changes minimal.
• Do not touch unrelated files.
• Prefer existing patterns over new abstractions.
• Preserve API behavior unless requested otherwise.
• Prefer forward Prisma migrations.
• Never edit applied migrations in shared environments.

---

EXECUTION RULES

• Keep responses short.
• Do not narrate thoughts.
• Do not explain obvious steps.
• Do not create plans for simple tasks.
• Prefer implementation over exploration.

Avoid:

• “I think…”
• “Let me check…”
• “I should inspect…”
• “I’m going to…”

---

RTK Rules

Always prefer RTK commands.

Use:

• rtk ls
• rtk grep
• rtk smart
• rtk read
• rtk git diff
• rtk git status

Avoid raw:

• cat
• grep
• rg
• git diff
• recursive repository scans

---

Reading Strategy

1. rtk grep
2. rtk smart
3. rtk read

Rules:

• Read only necessary files.
• Do not read sibling files unless needed.
• Do not reread unchanged files.
• Stop searching once target location is found.
• Edit quickly after locating target.

Avoid:

• opening entire modules
• multi-file chained reads
• large diff dumps
• exploratory scans

---

Forbidden Paths

Do not inspect unless required:

• node_modules/
• dist/
• coverage/
• .prisma/
• prisma/migrations/

---

Prisma Rules

• Use transactions for multi-step writes.
• Prefer explicit select/include.
• Normalize Decimal values with Number(...).
• Keep migrations forward-safe.
• Use:
  • pnpm prisma migrate dev --name <name> for new local migrations
  • pnpm prisma migrate deploy for applying existing migrations

---

NestJS Rules

• Keep layering:

  • controller
  • service
  • prisma/shared service

• Reuse shared services.

• Keep DTO validation strict.

• Avoid any.

---

Validation

Typecheck before handoff:

pnpm -s tsc --noEmit