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:
56
README.md
56
README.md
@@ -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*
|
||||
Reference in New Issue
Block a user