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:
49
pmo/artifacts/projects/PROJECT_TEMPLATE.md
Normal file
49
pmo/artifacts/projects/PROJECT_TEMPLATE.md
Normal 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]
|
||||
48
pmo/artifacts/projects/README.md
Normal file
48
pmo/artifacts/projects/README.md
Normal 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`
|
||||
72
pmo/artifacts/projects/SAMPLE-001_DemoProject.json
Normal file
72
pmo/artifacts/projects/SAMPLE-001_DemoProject.json
Normal 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."
|
||||
}
|
||||
53
pmo/artifacts/projects/SAMPLE-001_DemoProject.md
Normal file
53
pmo/artifacts/projects/SAMPLE-001_DemoProject.md
Normal 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.
|
||||
45
pmo/artifacts/projects/project-template.json
Normal file
45
pmo/artifacts/projects/project-template.json
Normal 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]"
|
||||
}
|
||||
Reference in New Issue
Block a user