49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
# Databank Artifacts
|
|
|
|
This directory contains the canonical databank content in dual-format structure.
|
|
|
|
## Structure
|
|
|
|
```
|
|
artifacts/
|
|
├── 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:
|
|
|
|
- **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/output)
|
|
- **`../../../pmo/artifacts/`** - Project management updates (separate system)
|
|
|
|
--- |