psp_panel/agents.md

AGENT.md

Scope

Applies to the full repository unless overridden by a deeper AGENT.md.

Stack:

• Angular 20
• Standalone components
• pnpm
• Docker
• RTK

---

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…”

Prefer:

• “Updated environment files.”
• “Applied tenant config fix.”

---

RTK RULES (MANDATORY)

Always prefer RTK commands.

Use:

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

Avoid raw:

• cat
• grep
• rg
• tree
• git diff
• recursive find

Use raw shell only for:

• builds
• runtime/debugging
• Docker
• pnpm
• commands RTK cannot perform

---

FILE READING POLICY

Preferred order:

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

Rules:

• Search before reading.
• Read only required files.
• Do not read TS/HTML/SCSS together unless required.
• Stop exploring once edit location is clear.
• Avoid rereading unchanged files.

Large files:

• rtk read <file> -l aggressive

---

ANGULAR WORKFLOW

For components:

1. rtk grep "<component-name>"
2. rtk smart component.ts
3. Read template only if UI changes are required
4. Read styles only if styling changes are required

Avoid broad module inspection.

---

TOKEN RULES

Do not:

• dump large files
• scan unrelated folders
• inspect generated directories
• perform repeated searches
• over-explain edits

Avoid:

• dist/
• .angular/
• coverage/
• node_modules/
• .git/

---

CHANGE POLICY

• Keep changes minimal and scoped.
• Reuse existing patterns.
• Avoid unrelated refactors.
• Preserve tenant separation.
• Prefer root-cause fixes.

---

PROJECT RULES

Tenant Builds

• default → dist/production
• tis → dist/tis

Keep Docker DIST_DIR aligned with Angular output.

Do not use Angular fileReplacements for static assets.

---

Input Component

File:

• src/app/shared/components/input/input.component.ts

For:

• type="number"
• type="price"

Requirements:

• normalize Persian/Arabic digits
• allow only digits and .
• support fixed precision
• keep identifier fields string-safe

---

Shared Field Rules

When creating fields:

• use shared field wrappers
• reuse app-input
• register exports in shared indexes
• keep control names consistent

---

VALIDATION

TypeScript:

• pnpm -s exec tsc -p tsconfig.app.json --noEmit

Docker:

• docker compose build app_default
• docker compose build app_tis

Validate only impacted areas when possible.

---

FINAL RESPONSE RULES

Keep final responses under 10 lines unless:

• validation failed
• architecture changed
• user requested explanation

Prefer:

Updated:

• file1
• file2

Validation:

• tsc passed