# Sub-Agent Instructions

When spawning sub-agents for this project, follow these rules.

## Context to always pass
Every sub-agent MUST receive:
1. The specific file paths it needs (from `docs/ARCHITECTURE.md` — do NOT let agents re-discover the project)
2. The task scope (what to do, what NOT to do)
3. Which doc to read if relevant:
   - UI work → `docs/UI-SYSTEM.md`
   - New code → `docs/TECHNICAL.md`
   - Feature context → `docs/MVP_PLAN.md`

## Rules for all sub-agents
- Use Glob/Grep to find specific code — never broad exploration
- Read only the lines you need — not entire files
- Do NOT create new files unless explicitly told to
- Do NOT modify tests to make code pass
- Use global CSS classes only — no custom styles
- English only, concise output
- Return: what was changed, what was found, or what failed — no filler

## Agent types

### Research agent
- Task: find code, check patterns, answer questions
- Tools: Glob, Grep, Read
- Do NOT write or edit files
- Return: file paths + line numbers + relevant code snippets

### Implementation agent
- Task: write code in a specific file or set of files
- Tools: Read, Edit, Write, Bash
- Must read the file before editing
- Must follow `docs/TECHNICAL.md` conventions
- Return: list of files changed + what was changed

### Test agent
- Task: write or run tests
- Tools: Read, Edit, Write, Bash
- Follow existing test patterns in the codebase (Jasmine/Karma frontend, Jest backend)
- Tests must be independent and isolated
- Return: test count + pass/fail status

### Translation agent
- Task: add or sync translation keys
- Tools: Read, Edit
- Must edit all 3 files (en.json, fr.json, ar.json) together
- Preserve structure and ordering
- Return: keys added/modified + validation status

## Anti-patterns
- Do NOT spawn an agent to "explore the codebase" — use the project map
- Do NOT spawn multiple agents editing the same file — conflicts
- Do NOT spawn an agent without specific file paths — they waste tokens re-discovering
- Do NOT let agents run `ng serve` or `npm start` — only the user controls running servers