feat(docs): standardize README.md files across all stacks
- Update top-level README.md with AI collaboration section and working agreement - Standardize all stack README.md files (CloudronStack, LifecycleStack, SupportStack, ToolboxStack) with consistent structure: - Add Working Agreement section with consistent items across all stacks - Add AI Agent section identifying the responsible bot for each stack - Add License section with reference to main LICENSE file - Add Quick Start section where missing - Create missing LifecycleStack/collab directory with .gitkeep file - Add top-level QWEN.md file for tracking Topside agent work - Add top-level commit-template.txt and configure git to use it - Ensure consistent formatting and content across all documentation - Fix CloudronStack README title to match project structure This commit ensures all README files follow the same structure and contain necessary information for coordination between different Qwen agents working on each stack.
This commit is contained in:
55
QWEN.md
Normal file
55
QWEN.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# Qwen Agent Development Log
|
||||
|
||||
Date: Wednesday, October 29, 2025
|
||||
|
||||
## Project Context
|
||||
|
||||
TSYSDevStack is a constellation of curated stacks that power rapid prototyping, support simulations, developer workspaces, and (soon) lifecycle orchestration for TSYS Group. The project consists of four main stacks:
|
||||
|
||||
- **CloudronStack**: Cloudron application packaging and upstream research
|
||||
- **LifecycleStack**: Promotion workflows, governance, and feedback loops
|
||||
- **SupportStack**: Demo environment for support tooling
|
||||
- **ToolboxStack**: Reproducible developer workspaces and containerized tooling
|
||||
|
||||
## Topside Role
|
||||
|
||||
As the Topside Qwen agent, I operate at the top level of the directory tree and am responsible for:
|
||||
|
||||
- Keeping the top-level README.md and each of the four subdirectory README.md files up to date
|
||||
- Performing general housekeeping tasks
|
||||
- Maintaining this top-level QWEN.md file for tracking work
|
||||
|
||||
## Development Guidelines
|
||||
|
||||
- All commits should be verbose/beautifully formatted
|
||||
- Use atomic commits
|
||||
- Use conventional commit format
|
||||
|
||||
## Git Configuration
|
||||
|
||||
- Commit template configured to enforce conventional commits
|
||||
- Template file: /home/localuser/TSYSDevStack/commit-template.txt
|
||||
|
||||
## Task Tracking
|
||||
|
||||
Current tasks and progress:
|
||||
- [x] Explore the current directory structure in depth
|
||||
- [x] Create a QWEN.md file to track our work
|
||||
- [x] Review all subdirectory README.md files
|
||||
- [x] Update README.md files as needed throughout the project
|
||||
- [ ] Perform general housekeeping tasks as requested
|
||||
|
||||
## Work Log
|
||||
|
||||
### Session 1 (2025-10-29)
|
||||
- Oriented to the directory tree structure
|
||||
- Analyzed all README.md files in the project
|
||||
- Created QWEN.md file for tracking work
|
||||
- Set up commit configuration requirements
|
||||
- Updated all README.md files for consistency across the project:
|
||||
- Added Working Agreement section with consistent items
|
||||
- Added AI Agent section identifying the responsible bot
|
||||
- Added License section with reference to main LICENSE
|
||||
- Fixed CloudronStack README title and content
|
||||
- Created missing collab directory in LifecycleStack
|
||||
- Created top-level commit template and configured git
|
||||
Reference in New Issue
Block a user