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

@@ -0,0 +1,49 @@
# Project Template
## Project Information
| Field | Value |
|-------|-------|
| **Name** | [Project Name] |
| **ID** | [Unique Project ID] |
| **Status** | Active / On Hold / Completed / Planned |
| **Priority** | Critical / High / Medium / Low |
| **Health** | Green / Yellow / Red |
| **Last Updated** | YYYY-MM-DD HH:MM:SS |
| **Tracking URL** | [Link to project-specific tracking system] |
| **Owner** | [Project owner] |
| **Dependencies** | [Other projects this project depends on] |
| **Due Date** | [Key milestone or completion date] |
| **Progress** | [Percentage complete] |
| **Next Milestone** | [Next major milestone to achieve] |
## Project Details
### Description
[Detailed description of the project]
### Objectives
- [ ] [Objective 1]
- [ ] [Objective 2]
- [ ] [Objective 3]
### Milestones
| Milestone | Target Date | Status |
|-----------|-------------|--------|
| [Milestone 1] | [Date] | Not Started / In Progress / Completed |
| [Milestone 2] | [Date] | Not Started / In Progress / Completed |
| [Milestone 3] | [Date] | Not Started / In Progress / Completed |
### Resources
- Team Members: [List of contributors]
- Budget: [If applicable]
- Tools: [List of tools used for this project]
### Risks
| Risk | Impact | Mitigation Strategy |
|------|--------|-------------------|
| [Risk 1] | [High/Medium/Low] | [How to mitigate] |
| [Risk 2] | [High/Medium/Low] | [How to mitigate] |
### Notes
[Any additional notes about the project]

View File

@@ -0,0 +1,48 @@
# PMO Project Registry
This directory contains all registered projects in the PMO system. Each project should follow the standardized schema defined in the PMO proposal.
## Project Entry Templates
- `PROJECT_TEMPLATE.md` - Human-readable template for project entries
- `project-template.json` - Machine-readable template for AI processing
## Adding a New Project
To add a new project to the registry:
1. Copy the project template that best suits your needs
2. Fill in all required fields according to the schema
3. Save the file with a descriptive name (e.g., `{PROJECT_ID}_{PROJECT_NAME}.md` or `{PROJECT_ID}_{PROJECT_NAME}.json`)
4. Update the main dashboard to reflect the new project
## Project Schema
Each project entry should contain:
| Field | Description | Required |
|-------|-------------|----------|
| `name` | Project name (human readable) | Yes |
| `id` | Unique identifier | Yes |
| `status` | Current status (Active, On Hold, Completed, Planned) | Yes |
| `priority` | Priority level (Critical, High, Medium, Low) | Yes |
| `health` | Health indicator (Green, Yellow, Red) | Yes |
| `last_updated` | Timestamp of last status update | Yes |
| `tracking_url` | Link to project-specific tracking | Yes |
| `owner` | Project owner | No |
| `dependencies` | Other projects this project depends on | No |
| `due_date` | Key milestone or completion date | No |
| `progress` | Percentage complete | Yes |
| `next_milestone` | Next major milestone to achieve | Yes |
## Project Status Values
- **Status**: `Active`, `On Hold`, `Completed`, `Planned`
- **Priority**: `Critical`, `High`, `Medium`, `Low`
- **Health**: `Green`, `Yellow`, `Red`
## File Naming Convention
Use the format: `{PROJECT_ID}_{PROJECT_NAME}.{md|json}`
Example: `PROJ-001_EcommercePlatform.md`

View File

@@ -0,0 +1,72 @@
{
"name": "Demo Project",
"id": "SAMPLE-001",
"status": "Active",
"priority": "Medium",
"health": "Green",
"last_updated": "2025-10-24 10:00:00",
"tracking_url": "https://github.com/example/demo-project",
"owner": "Project Owner",
"dependencies": [],
"due_date": "2025-12-31",
"progress": 25,
"next_milestone": "Complete initial design phase",
"description": "This is a sample project created to demonstrate the PMO project registry functionality. It serves as an example of how projects should be structured and tracked within the PMO system.",
"objectives": [
"Set up project structure",
"Complete initial design phase",
"Implement core features",
"Testing and validation",
"Project completion"
],
"milestones": [
{
"name": "Project Setup",
"target_date": "2025-10-20",
"status": "Completed"
},
{
"name": "Initial Design",
"target_date": "2025-11-15",
"status": "In Progress"
},
{
"name": "Feature Implementation",
"target_date": "2025-11-30",
"status": "Not Started"
},
{
"name": "Testing",
"target_date": "2025-12-15",
"status": "Not Started"
},
{
"name": "Project Completion",
"target_date": "2025-12-31",
"status": "Not Started"
}
],
"resources": {
"team_members": [
"Project Owner"
],
"budget": "Demo project",
"tools": [
"GitHub",
"Documentation tools"
]
},
"risks": [
{
"risk": "Scope creep",
"impact": "Medium",
"mitigation_strategy": "Clearly defined objectives and scope"
},
{
"risk": "Resource availability",
"impact": "Low",
"mitigation_strategy": "Single owner, flexible timeline"
}
],
"notes": "This is a demonstration project for the PMO system. It shows how projects should be documented and tracked according to the established schema."
}

View File

@@ -0,0 +1,53 @@
# Sample Project: Demo Project
## Project Information
| Field | Value |
|-------|-------|
| **Name** | Demo Project |
| **ID** | SAMPLE-001 |
| **Status** | Active |
| **Priority** | Medium |
| **Health** | Green |
| **Last Updated** | 2025-10-24 10:00:00 |
| **Tracking URL** | https://github.com/example/demo-project |
| **Owner** | Project Owner |
| **Dependencies** | None |
| **Due Date** | 2025-12-31 |
| **Progress** | 25% |
| **Next Milestone** | Complete initial design phase |
## Project Details
### Description
This is a sample project created to demonstrate the PMO project registry functionality. It serves as an example of how projects should be structured and tracked within the PMO system.
### Objectives
- [x] Set up project structure
- [ ] Complete initial design phase
- [ ] Implement core features
- [ ] Testing and validation
- [ ] Project completion
### Milestones
| Milestone | Target Date | Status |
|-----------|-------------|--------|
| Project Setup | 2025-10-20 | Completed |
| Initial Design | 2025-11-15 | In Progress |
| Feature Implementation | 2025-11-30 | Not Started |
| Testing | 2025-12-15 | Not Started |
| Project Completion | 2025-12-31 | Not Started |
### Resources
- Team Members: Project Owner
- Budget: $0 (Demo project)
- Tools: GitHub, Documentation tools
### Risks
| Risk | Impact | Mitigation Strategy |
|------|--------|-------------------|
| Scope creep | Medium | Clearly defined objectives and scope |
| Resource availability | Low | Single owner, flexible timeline |
### Notes
This is a demonstration project for the PMO system. It shows how projects should be documented and tracked according to the established schema.

View File

@@ -0,0 +1,45 @@
{
"name": "[Project Name]",
"id": "[Unique Project ID]",
"status": "Active",
"priority": "Medium",
"health": "Green",
"last_updated": "YYYY-MM-DD HH:MM:SS",
"tracking_url": "[Link to project-specific tracking system]",
"owner": "[Project owner]",
"dependencies": [],
"due_date": "[Key milestone or completion date]",
"progress": 0,
"next_milestone": "[Next major milestone to achieve]",
"description": "[Detailed description of the project]",
"objectives": [
"[Objective 1]",
"[Objective 2]",
"[Objective 3]"
],
"milestones": [
{
"name": "[Milestone 1]",
"target_date": "[Date]",
"status": "Not Started"
},
{
"name": "[Milestone 2]",
"target_date": "[Date]",
"status": "Not Started"
}
],
"resources": {
"team_members": [],
"budget": null,
"tools": []
},
"risks": [
{
"risk": "[Risk 1]",
"impact": "Medium",
"mitigation_strategy": "[How to mitigate]"
}
],
"notes": "[Any additional notes about the project]"
}