docs: update repository structure, add COO directories, and merge v2 proposal updates\n\n- Update main README.md repository structure to reflect current state\n- Remove context/ directory from databank as per new structure\n- Add COO sections to both databank/ and pmo/ directories\n- Create COO directories for transition to Albert\n- Add GLOSSARY.md template for project use\n- Update AGENTS.md to include COO transition information for Albert\n- Add rule requiring acronyms to be defined when first used\n- Add GLOSSARY requirement for all projects\n- Update PMO section to explain PMO (Project Management Office) acronym\n- Merge updates from PROPOSAL-AGENTS-v2.md into current AGENTS.md\n- Update version tracking in AGENTS.md to v8.0.0 reflecting COO changes\n- Add change tracking table to README.md\n- Reflect that project management artifacts stay local to projects with PMO linking to them\n- Update authority structure to include Albert's future role in COO transition

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
2025-10-24 10:43:51 -05:00
parent 974fc96959
commit 347ef9d496
13 changed files with 669 additions and 34 deletions

View File

@@ -34,24 +34,33 @@ AI-Home-Directory/ # Mount point in containers
├── databank/ # 🔒 Readonly context (mounted readonly)
│ ├── personal/ # Personal information
│ │ ├── AboutMe.md
│ │ ├── StartHere.md
│ │ └── TSYS.md
│ ├── agents/ # AI agent guidelines
│ │ ├── AgentRules.md
│ │ ├── AGENTS.md
│ │ └── AI-TOOLS.md
│ ├── context/ # General context information
│ │ ├── AUDIT1.md
│ │ └── PROJECT-MGMT-TOOLS.md
│ ├── context/ # General context information
│ │ ├── AUDIT1.md
│ │ └── PROJECT-MGMT-TOOLS.md
│ ├── operations/ # Operational environment information
│ │ └── OPERATIONS-KNOWLEDGE-TRANSFER.md
── templates/ # Template files for projects
└── OPS-ENVIRONMENT.md
── coo/ # Chief Operating Officer domain
└── (COO handoff information and processes)
│ ├── templates/ # Template files for projects
│ │ └── OPS-ENVIRONMENT.md
│ ├── collab/ # Human/AI interaction space
│ └── artifacts/ # AI-managed content and resources
│ ├── docs/ # AI-managed documentation
│ ├── code/ # AI-managed code artifacts
│ ├── config/ # AI-managed configuration
│ └── templates/ # AI-managed templates
├── pmo/ # ✏️ Read-write PMO (mounted read-write)
│ ├── dashboard/ # PMO dashboard views
│ ├── artifacts/ # PMO components and data
│ │ ├── dashboard/ # PMO dashboard views
│ │ ├── projects/ # Project registry and tracking links
│ │ ├── reports/ # Status reports
│ │ ├── resources/ # Resource management
│ │ ├── config/ # PMO configuration
│ │ └── docs/ # PMO documentation
│ ├── coo/ # COO-specific project management
│ └── collab/ # PMO-specific collaboration
│ ├── projects/ # Project registry and links
│ ├── reports/ # Status reports
│ ├── resources/ # Resource management
@@ -126,22 +135,16 @@ The databank directory contains readonly information that provides consistent co
| [**AGENTS.md**](./databank/agents/AGENTS.md) | Guidelines for AI agents working with this repo |
| [**AI-TOOLS.md**](./databank/agents/AI-TOOLS.md) | AI tool preferences and usage patterns |
### Context Information (`databank/context/`)
| File | Purpose |
|------|---------|
| [**AUDIT1.md**](./databank/context/AUDIT1.md) | Analysis and improvement suggestions (template/example) |
| [**PROJECT-MGMT-TOOLS.md**](./databank/context/PROJECT-MGMT-TOOLS.md) | CLI project management tool recommendations |
### Templates (`databank/templates/`)
| File | Purpose |
|------|---------|
| [**OPS-ENVIRONMENT.md**](./databank/templates/OPS-ENVIRONMENT.md) | Operational environment template |
### Operations (`databank/operations/`)
| File | Purpose |
|------|---------|
| [**OPERATIONS-KNOWLEDGE-TRANSFER.md**](./databank/operations/OPERATIONS-KNOWLEDGE-TRANSFER.md) | Knowledge transfer interview for operational roles |
### COO (`databank/coo/`)
| Directory | Purpose |
|-----------|---------|
| [**databank/coo/**](./databank/coo/) | Chief Operating Officer domain and handoff information |
### Templates (`databank/templates/`)
| File | Purpose |
|------|---------|
@@ -166,7 +169,7 @@ The databank directory contains readonly information that provides consistent co
## 📊 PMO (Read-Write)
The PMO directory contains project management functionality where AI agents can update project status and milestones.
The PMO (Project Management Office) directory contains project management functionality where AI agents can update project status and milestones. Project management/todo artifacts stay local to their project, and the PMO links to them. Projects will update the PMO using a defined structure/format/protocol.
### PMO Components
| Directory | Purpose |
@@ -178,6 +181,7 @@ The PMO directory contains project management functionality where AI agents can
| **[pmo/artifacts/resources/](./pmo/artifacts/resources/)** | Resource allocation and management |
| **[pmo/artifacts/config/](./pmo/artifacts/config/)** | PMO configuration and settings |
| **[pmo/artifacts/docs/](./pmo/artifacts/docs/)** | Detailed PMO documentation |
| **[pmo/coo/](./pmo/coo/)** | COO-specific project management |
| **[pmo/collab/](./pmo/collab/)** | PMO-specific collaboration |
### PMO Update Guidelines
@@ -267,5 +271,13 @@ Since this serves as a living knowledge base:
---
## Change Tracking/Revision Table
| Date/Time | Version | Description | Author |
|----------------------------------|---------|--------------------------------------------------|---------------------|
| 2025-10-24 10:34 CDT (UTC-05:00) | 1.0.0 | Initial change tracking table for README | Charles N Wyble (@ReachableCEO) |
---
*Last updated: October 24, 2025*
*Part of the AIOS (AI Operating System) ecosystem*