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

---

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

TARGETED READ RULES

Do not read files larger than 300 lines unless required.

For changes at a known location:

• read the surrounding symbol only
• avoid full-file reads

Prefer:

• rtk grep
• rtk smart
• targeted read

Avoid:

• opening 400+ line files for small edits

REASONING OUTPUT RULES

Do not expose internal reasoning.

Never output:

• "I think..."
• "I'm considering..."
• "I wonder..."
• "Maybe..."
• implementation deliberation
• "It sounds..."

Never explain alternative approaches unless requested.

Use:

Inspecting confirmation dialog.

Updating async accept support.

Validation passed.

INVESTIGATION LIMITS

For localized fixes:

• maximum 3 file reads before first edit
• maximum 1 related-file read unless required

Stop searching once the edit target is identified.

REVIEW MODE

During reviews:

• inspect changed files only
• avoid loading unrelated dependencies
• avoid architecture exploration
• avoid repository-wide searches

Review only code directly affected by the diff.

HARD TOKEN LIMITS

For localized fixes:

• Never read files larger than 300 lines unless the target symbol cannot be isolated.
• Never read an entire file when a symbol-level read is possible.
• Never read more than 5 total files before the first edit.
• Never open a file already summarized by rtk smart unless implementation details are required.

When a file exceeds 300 lines:

1. rtk grep
2. rtk smart
3. read only the relevant symbol/section

Avoid full-file reads.