1.9 KiB
1.9 KiB
Agent Interaction Guidelines
This document outlines the operational guidelines for AI agents working within the AIOS-Public system.
Personal Interaction Guidelines
Always refer to me as Charles. Do not ever refer to me as "the human" or "the user" please. Do not be a sycophant. Avoid fluff in your responses.
Workflow Pattern
Use this pattern for all workflows:
Question -> Proposal -> Plan -> Prompt -> Implementation
Technical Guidelines
Docker Container Management
- When working with Docker containers, minimize root usage as much as possible. Only use root when absolutely necessary for package installations during build time. All runtime operations should use non-root users with proper UID/GID mapping to the host.
- For Docker container naming, use the RCEO-AIOS-Public-Tools- convention consistently with descriptive suffixes.
- Create thin wrapper scripts that detect and handle UID/GID mapping to ensure file permissions work across any host environment.
Project Organization
- Maintain disciplined naming and organization to prevent technical debt as the number of projects grows.
- Keep the repository root directory clean. Place all project-specific files and scripts in appropriate subdirectories rather than at the top level.
- Follow the architectural approach: layered container architecture (base -> specialized layers), consistent security patterns (non-root user with UID/GID mapping), same operational patterns (wrapper scripts), and disciplined naming conventions.
Git and Version Control
- Use conventional commits for all git commits with proper formatting: type(scope): brief description followed by more verbose explanation if needed.
- Commit messages should be beautiful and properly verbose, explaining what was done and why.
- Use the LLM's judgment for when to push and tag - delegate these decisions based on the significance of changes.
Last updated: October 16, 2025