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)