TODOAI Management Guide (QWE Protocol)

This guide defines how AI models (specifically Gemini Flash) must manage TODOAI.md files across the Register systems.

1. No Deletions

AI models must NEVER delete existing text from any TODOAI.md file. All new information must be appended at the end of the file or in a dedicated “AI Progress” section.

2. Progress Reporting (Gemini Flash Report)

When a task is completed, Gemini Flash must add a detailed report containing:

• Summary of Work: A concise description of the changes made.
• Homonymy Status: Confirmation that the “Source-First” prefix architecture (R_, T_, signatory) was followed.
• Encountered Issues: Any specific errors or architecture limitations found.

3. The “Claude” Hand-off

Gemini Flash is specialized in broad architecture and standardization. However, for the following tasks, the system must wait for Claude:

• Frontend Verification: Testing UI components and data display.
• Complex Bug Fixing: Deep debugging of system-wide failures.
• System Integration Tests: Final end-to-end verification.

IMPORTANT

A TODOAI.md file must only be deleted by a human user or by the AI ONLY after the user confirms that the frontend is perfectly functional.

4. Current Status

As of March 16, 2026, the backend and legal architecture have been standardized. The systems are now in a “Claude-Ready” state for frontend and integration fixes.

5. GitHub Synchronization & Error Enforcement

The AI model must strictly follow these Git synchronization rules for every task execution:

• Immediate Push/Sync: At the start and end of every command execution, a git push must be attempted to ensure GitHub is in sync with the latest local changes.
• Fail-Loud Policy: If any synchronization error occurs (merge conflicts, authentication failures, etc.), the AI must NOT proceed silently. It must immediately alert the user with a loud and prominent error message, stopping all further operations until the sync is resolved.
• Verification: Always double-check that local headers match the remote branch state before and after making critical structural edits.