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

@@ -1,40 +1,49 @@
# Databank Artifacts
This directory contains all databank artifacts in their canonical form. Files in this directory are:
- Managed by AI agents based on communications in `../collab/`
- Organized by domain for efficient access
- Maintained as single source of truth for all context
- Updated only through AI processing of collab communications
This directory contains the canonical databank content in dual-format structure.
## Structure
```
artifacts/
├── personal/ # Personal information and biography
── agents/ # AI agent guidelines and tools
├── context/ # General context information
├── operations/ # Operational environment information
├── templates/ # Template files for new content
├── scaffolding/ # Template structure for new domains
├── coo/ # Chief Operating Officer domain
├── cto/ # Chief Technology and Product Officer domain
└── README.md # This file
├── human/ # Human-friendly markdown files
── llm/ # LLM-optimized structured data
```
## Purpose
Files in this directory represent the authoritative versions of all databank content. They are:
- Updated only by AI agents processing `../collab/` communications
- Never edited directly by humans
- Maintained as single source of truth
- Organized for efficient AI access patterns
- **Managed by AI agents** based on communications in `../collab/`
- **Never edited directly** by humans
- **Maintained as single source of truth**
- **Organized for optimal access** by both humans and LLMs
## Formats
### Human Format (`human/`)
- Beautiful markdown with tables, structure, and visual hierarchy
- Optimized for human reading and comprehension
- Rich with context and explanations
- Follows documentation best practices
### LLM Format (`llm/`)
- Structured data in JSON/YAML for efficient parsing
- Minimally formatted for token efficiency
- Organized for programmatic access
- Optimized for LLM context window usage
## Management
- **Content Creation**: Via `../collab/` communications
- **Updates**: AI agents process collab/ and update artifacts/
- **Synchronization**: Both formats kept in sync automatically
- **Version Control**: All changes tracked via Git
## Relationship to Other Directories
- **`../collab/`** - Human/AI communication space (input)
- **This directory** - Canonical content storage (storage)
- **`../../../pmo/artifacts/`** - Project management updates (output)
- **This directory** - Canonical content storage (storage/output)
- **`../../../pmo/artifacts/`** - Project management updates (separate system)
---