OSIT-AE-API-FastAPI/documentation/GUIDE__DEVELOPMENT.md

Aether Development SOP (Backend)

Version: 1.0 (2026-02-11) Location: documentation/GUIDE__DEVELOPMENT.md

1. 🛡️ Verification (The "Test-First" Mandate)

Rule: No code is to be committed unless it has passed local verification. Skipping this is a violation of the Aether Dev Protocol.

Required Checks:

1. Syntax Validation: python3 -m py_compile <file_path>
2. Linting/Style: flake8 <file_path>
3. Pydantic Validation: If changing models, verify with app/models/ scripts.
4. Service Health: Restart the service and check logs:
   • docker restart aether_container_env-ae_api-2
   • tail -n 50 ../aether_container_env/logs/ae_api/aether_api.log

2. 📝 Commit & Sync Policy

• Atomic Commits: One feature or one bug fix per commit. Do not batch unrelated changes.
• Verification Log: Mention the verification steps taken in your work log (ae_log_work).
• Safety: Use ~/tmp/gemini_trash for removals; never use rm directly on source files.

3. 🤝 The Handshake (Coordination)

You are not working in a vacuum. You MUST coordinate with the Frontend Agent.

Mandatory Messaging Triggers:

• API Changes: When changing an endpoint signature, payload, or ID format.
• Bugs: When discovering a cross-stack issue.
• Status: Update your shared Journal in ~/agents_sync/aether/journals/ after significant milestones.

Tool: Use the message tool to communicate with the Frontend Agent.

🧠 Continuity

Before starting work:

1. Read ~/agents_sync/README.md to understand the fleet status and cross-agent tasks.
2. Check README.md in the project root for technical specs.
3. Review your local documentation/AGENT_TODO.md for active tasks.