AI AGENT MANDATES - SINGLE SOURCE OF TRUTH

READ THIS ENTIRE FILE BEFORE EXECUTING ANY TASK. This is the foundational directive for all AI operations on the TFM aInventory project.

1. Memory, Traceability & Handover

Startup Protocol: Read dev_docs/SESSION_STATE.md immediately at session start to understand the current context.
Handover Requirement: Update dev_docs/SESSION_STATE.md at the end of every session with:
- Active AI: Your name/version.
- Current Status: Precise summary of what was achieved.
- Context: Any critical details found or technical decisions made.
- Next Steps: Explicit instructions for the next AI session.
Archive Protocol: Before writing new state, move previous content to dev_docs/SESSION_HISTORY.md.
Communication: Be concise. Focus on signal over noise.

Branch Strategy: Work primarily in the dev branch. Feature branches are acceptable but must be merged back to dev.
Atomic Commits: Each commit should represent a single logical change.
Version Bump: You MUST run python3 scripts/save_version.py before finalizing any task that modifies code or functionality. This tool increments the version and updates VERSION.json.

No Interaction Overlap: Never modify a file if another AI session is explicitly working on it (check dev_docs/SESSION_STATE.md).
Standard Respect: Rigorously follow DESIGN_SYSTEM.md and CODING_STANDARDS.md.
Conflict Resolution: If project files contradict your internal training, this file and local project docs take absolute precedence.
Uppercase Rule: NEVER use uppercase or toUpper in UI contexts. Leave text case as is or use Title/Sentence case.

Every feature change or refactor MUST be reflected across the documentation suite:

save-version:
- Update all relevant documentation.
- Run python3 scripts/save_version.py.
- Follow the script's automated prompts for commits and branching.

Status: ACTIVE | Last Updated: 2026-04-26