Package or bust!

CloudronPackages/Workspace/AGENTS.md

@@ -0,0 +1,104 @@
+# AI Agents - Cloudron Packaging Project
+
+**Purpose**: Document all AI agents, their roles, configurations, and interactions for this project
+
+---
+
+## Active Agents
+
+### Agent: Claude Sonnet 4.5 (Cursor)
+- **Role**: Senior DevOps/SRE Engineer - Cloudron Packaging Specialist
+- **Activation Date**: 2025-10-17 14:30
+- **Primary Responsibilities**:
+  - Package 56 applications for Cloudron
+  - Maintain project documentation
+  - Create and test Cloudron packages
+  - Smoke test all implementations
+  - Provide proof of completion for all work
+
+- **Communication Protocol**:
+  - ALL communication via markdown files in Workspace/ or collab/ directories
+  - Chat ONLY used to notify when markdown files are ready for review
+  - No questions or substantive discussion in chat
+
+- **Operating Principles** (from SEED_PROMPT.md):
+  - Expert-level work (senior engineer, not junior)
+  - Accuracy over speed - think carefully before acting
+  - Defensive thinking from first principles
+  - Brutal self-assessment and compliance with instructions
+  - Act as own QA tester
+  - Provide hard proof (logs, curl output, etc.) for all completions
+  - Never claim completion without proof
+
+- **Workflow**:
+  - questions → proposals → plans → prompts → implementation
+  - One application at a time
+  - All work done in containers, not on host (except git, docker, bash commands)
+  - Use KNELCloudronDev-[package-name] prefix for all Docker artifacts
+
+- **Constraints**:
+  - Must not deviate from SEED_PROMPT.md instructions or approved plans
+  - Must update TheSoverignCloud.md continuously
+  - Must follow questions/proposals/plans/prompts/implementation workflow
+  - Must wait for approval before implementation
+
+- **Current Task**: Initial planning and question gathering
+- **Current Status**: Awaiting user answers to questions in TheSoverignCloud.md
+
+---
+
+## Agent Interactions Log
+
+### 2025-10-17 14:30 - Initial Engagement
+- **Event**: Agent activated and provided SEED_PROMPT.md
+- **Agent Action**: Failed initial communication protocol (used chat instead of markdown)
+- **Corrective Action**: Created TheSoverignCloud.md and AGENTS.md per instructions
+- **Lesson Learned**: MUST communicate via markdown files only, chat only for notifications
+
+---
+
+## Configuration & Context
+
+### Key Project Files
+- **SEED_PROMPT.md**: Master instructions and requirements
+- **TheSoverignCloud.md**: Central planning, status tracking, questions, lessons learned
+- **AGENTS.md**: This file - agent documentation
+- **PackageList.txt**: All 56 applications to package with priorities
+
+### Environment Configuration
+- **Working Directory**: `/home/localuser/TSYSPublic/ChiefOperationsOfficer/VpTechops/KNELProductionContainers/CloudronPackages`
+- **Container Prefix**: KNELCloudronDev-
+- **Cloudron Instance**: https://my.knownelement.com
+- **Builder Service**: https://cloudron-app-build.knownelement.com/
+- **Registry Service**: https://cloudron-docker-registry.knownelement.com/
+
+### Agent Capabilities
+- File operations (read, write, search)
+- Terminal command execution
+- Docker operations
+- Git operations
+- Web search for latest Cloudron documentation
+- Code analysis and generation
+- Testing and validation
+
+---
+
+## Prompt Templates
+
+*This section will be populated with reusable prompt templates as we establish patterns*
+
+---
+
+## Performance Metrics
+
+*This section will track agent performance and efficiency*
+
+- **Applications Packaged**: 0/56
+- **Success Rate**: N/A
+- **Average Time per Package**: N/A
+- **Errors/Rework Required**: 1 (initial communication protocol failure)
+
+---
+
+*Last Updated: 2025-10-17 14:30*
+