This repository functions as your personal "AI home directory" with a clear separation between readonly context (databank) and managed project updates (PMO). The databank provides consistent context across all projects while the PMO tracks project status and manages updates.

Dual-Format Architecture

The databank implements a dual-format architecture optimized for different consumers:

Format	Purpose	Location
Human-Friendly	Beautiful markdown for human consumption	`./human/`
LLM-Optimized	Structured data for AI agent consumption	`./llm/`
Collaborative Input	Shared workspace for updates	`./collab/`
Canonical Source	Authoritative content storage	`./artifacts/`

🏗️ Directory Structure

AI-Home-Directory/
├── databank/               # 🔒 Readonly context (mounted readonly)
│   ├── human/             # Human-friendly markdown files
│   │   ├── personal/      # Personal information
│   │   ├── agents/        # AI agent guidelines
│   │   ├── context/       # General context information
│   │   ├── operations/    # Operational environment
│   │   ├── templates/     # Template files
│   │   ├── coo/           # Chief Operating Officer domain
│   │   ├── cto/           # Chief Technology Officer domain
│   │   └── README.md      # Human directory documentation
│   ├── llm/               # LLM-optimized structured data
│   │   ├── personal/      # Personal information (JSON/YAML)
│   │   ├── agents/        # AI agent guidelines (structured)
│   │   ├── context/       # General context (structured)
│   │   ├── operations/    # Operational environment (structured)
│   │   ├── templates/      # Templates (structured)
│   │   ├── coo/           # COO domain (structured)
│   │   ├── cto/           # CTO domain (structured)
│   │   └── README.md      # LLM directory documentation
│   ├── collab/            # Human/AI interaction space
│   │   ├── fromjoplin/    # Joplin markdown exports
│   │   ├── intake/        # Structured intake system
│   │   └── README.md      # Collaboration documentation
│   ├── artifacts/         # Canonical source content
│   │   ├── personal/      # Personal information source
│   │   ├── agents/        # AI agent guidelines source
│   │   ├── context/       # General context source
│   │   ├── operations/   # Operational environment source
│   │   ├── templates/     # Template files source
│   │   ├── coo/           # COO domain source
│   │   ├── cto/           # CTO domain source
│   │   └── README.md      # Artifacts documentation
│   └── README.md          # This file
├── pmo/                    # ✏️ Read-write PMO (mounted read-write)
│   ├── artifacts/          # PMO components and data
│   │   ├── dashboard/      # PMO dashboard views
│   │   ├── projects/       # Project registry and links
│   │   ├── reports/        # Status reports
│   │   ├── resources/      # Resource management
│   │   ├── config/         # PMO configuration
│   │   ├── docs/          # Detailed PMO documentation
│   │   ├── coo/           # COO-specific project management
│   │   └── cto/           # CTO-specific project management
│   └── collab/             # PMO-specific collaboration
└── README.md               # Main repository documentation

📝 Usage Guidelines

For Human Editors

Edit Location: Use ./collab/ for all content modifications
Content Types: Joplin exports, markdown files, structured intake responses
Process: Content flows from collab → artifacts → human/llm dual formats
Frequency: Regular updates through structured interviews and Joplin exports

For AI Agents

Human Format: Access ./human/ for beautiful, readable documentation
LLM Format: Access ./llm/ for structured, token-efficient data
Updates: Modify only PMO directory, not databank
Intake: Contribute to ./collab/intake/ with new information

For Joplin Integration

Export Location: Drop Joplin markdown exports in ./collab/fromjoplin/
Processing: Automated conversion to both human and LLM formats
Synchronization: Updates propagate to artifacts, human, and llm directories
Format: Standard Joplin markdown export format

🔗 Integration Points

Primary Integration

TSYSDevStack - Docker artifacts repository for development environment

Mounting in Containers

# Separate mount points with clear permissions
docker run \
  -v /path/to/AI-Home-Directory/databank:/ai-home/databank:ro \
  -v /path/to/AI-Home-Directory/pmo:/ai-home/pmo:rw \
  your-development-image

Permission Boundaries

databank/: 🔒 Read-only access (ro) - Consistent context for all tools
pmo/: ✏️ Read-write access (rw) - Project management updates

🔄 Workflow

Content Lifecycle

Input: Joplin exports → ./collab/fromjoplin/
Intake: Structured interviews → ./collab/intake/responses/
Processing: Conversion → ./artifacts/
Distribution: Sync to ./human/ and ./llm/
Consumption: Humans read human/, LLMs consume llm/

Update Process

Human Updates: Joplin → collab/fromjoplin → processing pipeline
Structured Updates: Interviews → collab/intake → processing pipeline
Direct Updates: Only via collab/ directories, never direct databank edits
Validation: Automated checks ensure consistency between formats

Last updated: October 24, 2025
Part of the AIOS (AI Operating System) ecosystem
Optimized for solo entrepreneur workflows