docs(qwen): update QWEN.md files to clarify git operation responsibilities

- Update top-level QWEN.md to indicate Topside agent handles all git operations
- Add Git Operations Notice to CloudronStack/QWEN.md informing CloudronBot not to commit/push
- Add Git Operations Notice to LifecycleStack/QWEN.md informing LifecycleBot not to commit/push
- Add Git Operations Notice to SupportStack/QWEN.md informing SupportBot not to commit/push
- Add Git Operations Notice to ToolboxStack/QWEN.md informing ToolboxBot not to commit/push
- Clarify that Topside agent is solely responsible for all git commits and pushes
- Ensure all agents understand they should coordinate git operations through Topside

This establishes clear git operation governance across all Qwen agents in the project.
This commit is contained in:
2025-10-29 08:18:24 -05:00
parent b53c0f5a05
commit 801b613ea0
5 changed files with 243 additions and 2 deletions

81
SupportStack/QWEN.md Normal file
View File

@@ -0,0 +1,81 @@
# Qwen Code Context File
## Project Overview
The TSYSDevStack SupportStack is a curated demo environment for developer support tools. It bundles Dockerized services, environment settings, automation scripts, and a growing library of collaboration notes. The stack includes tools like Atuin, MailHog, AtomicTracker (habit tracker), local Grafana/InfluxDB for private metrics (Apple health export), WakaAPI and other useful developer productivity and support tools.
## Multi-Chat Environment Context
This project operates within a multi-chat system with five QWEN chats working on related but separate directory trees:
- SupportStack (this chat) - Focused on developer support tools
- Other sibling directories operate independently but may share common infrastructure patterns
- All work is confined to the current directory tree only
- Each chat maintains its own QWEN.md context file
## Project Structure
```
TSYSDevStack/SupportStack/
├── README.md # Main project documentation
├── collab/ # Collaboration notes, roadmaps, prompts
├── output/ # Main project artifacts
│ ├── code/ # Control script
│ ├── config/ # Service configurations
│ ├── docker-compose/ # Docker Compose files for services
│ ├── docs/ # Documentation
│ ├── tests/ # Test scripts
│ └── TSYSDevStack-SupportStack-Demo-Settings # Environment settings
```
## Key Components
1. **Control Script**: Orchestrates start/stop/update/test flows for the demo stack (`output/code/TSYSDevStack-SupportStack-Demo-Control.sh`)
2. **Environment Settings**: Centralized `.env` style configuration (`output/TSYSDevStack-SupportStack-Demo-Settings`)
3. **Docker Compose Bundles**: Service definitions for developer tools like Atuin, MailHog, AtomicTracker, Grafana/InfluxDB, WakaAPI, and more (`output/docker-compose/`)
4. **Service Config**: Configuration for developer tools mounted into containers (`output/config/`)
5. **Tests**: Shell-based smoke, unit, and discovery tests for stack services (`output/tests/`)
## Current Status
- **Project**: TSYSDevStack SupportStack Demo
- **Status**: ✅ MVP COMPLETE
- **Last Updated**: October 28, 2025
## MVP Components
- **docker-socket-proxy**: Docker socket access for secure container communication
- **homepage**: Homepage dashboard accessible at http://127.0.0.1:4000
- **wakaapi**: WakaAPI service accessible at http://127.0.0.1:4001
- **mailhog**: Mailhog service for email testing
- **atuin**: Shell history with sync and search capabilities
- **atomictracker**: Habit tracking application
- **grafana/influxdb**: Private metrics collection and visualization
## Git Operations Notice
- IMPORTANT: Git operations (commits and pushes) are handled exclusively by the Topside agent
- SupportBot should NOT perform git commits or pushes
- All changes should be coordinated through the Topside agent for repository consistency
## Git Commit Conventions
- Use conventional commit format
- Make atomic commits
- Include verbose/beautifully formatted commit messages
- Commit frequently
## Key Technologies
- Docker
- Docker Compose
- Shell scripting
- Homepage dashboard
- WakaAPI
- MailHog
- Atuin (shell history)
- AtomicTracker (habit tracking)
- Grafana/InfluxDB (metrics)
- Apple health export tools
## Important Files
- Control script: `output/code/TSYSDevStack-SupportStack-Demo-Control.sh`
- Environment settings: `output/TSYSDevStack-SupportStack-Demo-Settings`
- Docker Compose files: `output/docker-compose/`
- Test scripts: `output/tests/`
## Development Notes
- The stack expects Docker access and creates the shared network `tsysdevstack-supportstack-demo-network` if it does not exist.
- Keep demo automation in `output/` and exploratory material in `collab/`.
- When adding a new service, update both the compose files and the test suite to maintain coverage.
- Focus on developer productivity and support tools such as Atuin, MailHog, AtomicTracker, Grafana/InfluxDB, WakaAPI, and Apple health export tools.