Files

1.5 KiB

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)