# 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)

---