fix: correct databank architecture to match specification\n\n- Restructure databank/artifacts/ with only human/ and llm/ top-level directories\n- Remove all incorrectly placed domain directories from databank/artifacts/\n- Create proper LLMDatabankTOC.json for chat agent '@' function\n- Implement correct human/llm dual-format structure as specified\n- Remove scaffolding from databank as requested\n- Create proper PMO scaffolding in pmo/artifacts/scaffolding/ with domain templates\n- Update README documentation to reflect corrected architecture\n- Maintain clear separation: humans edit collab/, AI manages artifacts/\n- Ensure LLMDatabankTOC enables efficient navigation for chat agents\n- Correct repository structure diagram to show proper databank/artifacts/ structure\n- Remove all references to incorrectly placed directories\n- Maintain only collab/ as editable directory for humans

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
2025-10-24 12:47:44 -05:00
parent a811335196
commit e3cb3f471e
40 changed files with 369 additions and 1686 deletions

View File

@@ -171,49 +171,25 @@ docker run \
## 📚 Databank (Readonly)
The databank directory contains readonly information that provides consistent context across projects.
### Personal Information (`databank/personal/`)
| File | Purpose |
|------|---------|
| [**AboutMe.md**](./databank/personal/AboutMe.md) | Personal information and professional background |
| [**TSYS.md**](./databank/personal/TSYS.md) | Business information and organizational structure |
### Agent Guidelines (`databank/agents/`)
| File | Purpose |
|------|---------|
| [**AgentRules.md**](./databank/agents/AgentRules.md) | Operational guidelines for AI agents |
| [**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 |
### Operations (`databank/operations/`)
| File | Purpose |
|------|---------|
| [**OPERATIONS-KNOWLEDGE-TRANSFER.md**](./databank/operations/OPERATIONS-KNOWLEDGE-TRANSFER.md) | Knowledge transfer interview for operational roles |
### COO (`databank/coo/`)
### Databank Artifacts (`databank/artifacts/`)
| Directory | Purpose |
|-----------|---------|
| [**databank/coo/**](./databank/coo/README.md) | Chief Operating Officer domain and handoff information |
| [**databank/artifacts/human/**](./databank/artifacts/human/) | Human-friendly markdown files |
| [**databank/artifacts/llm/**](./databank/artifacts/llm/) | LLM-optimized structured data |
| [**databank/artifacts/README.md**](./databank/artifacts/README.md) | Canonical databank content |
### CTO (`databank/cto/`)
| Directory | Purpose |
|-----------|---------|
| [**databank/cto/**](./databank/cto/README.md) | Chief Technology and Product Officer domain |
| [**databank/cto/vpengineering/**](./databank/cto/vpengineering/README.md) | VP Engineering focus area |
| [**databank/cto/vpproduct/**](./databank/cto/vpproduct/README.md) | VP Product focus area |
### Templates (`databank/templates/`)
| File | Purpose |
|------|---------|
| [**OPS-ENVIRONMENT.md**](./databank/templates/OPS-ENVIRONMENT.md) | Operational environment template |
### Collaboration (`databank/collab/`)
| Directory | Purpose |
|-----------|---------|
| [**databank/collab/**](./databank/collab/) | Space for human/AI interaction |
### Artifacts (`databank/artifacts/`)
*Note: All databank files are readonly for AI agents except in collab/ directory*
The databank directory contains readonly information that provides consistent context across projects.
| Directory | Purpose |
|-----------|---------|
| [**databank/artifacts/docs/**](./databank/artifacts/docs/) | AI-managed documentation |
@@ -230,6 +206,13 @@ The databank directory contains readonly information that provides consistent co
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
### PMO Scaffolding
| Directory | Purpose |
|-----------|---------|
| **[pmo/artifacts/scaffolding/](./pmo/artifacts/scaffolding/README.md)** | Templates for new PMO components |
| **[pmo/artifacts/scaffolding/domain-template/](./pmo/artifacts/scaffolding/domain-template/README.md)** | Template for new PMO domains |
| Directory | Purpose |
|-----------|---------|
| **[pmo/artifacts/](./pmo/artifacts/README.md)** | PMO components and data |