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:
@@ -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)
|
||||
|
||||
---
|
||||
Reference in New Issue
Block a user