ReachableCEO-AI-Homedir-Public/databank/README.md

🏠 AI Home Directory - Databank

Your centralized knowledge base with human/LLM optimized dual-format structure

---

📋 Table of Contents

• Overview
• Directory Structure
• Usage Guidelines
• Integration Points

---

🧠 Overview

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

1. Input: Joplin exports → ./collab/fromjoplin/
2. Intake: Structured interviews → ./collab/intake/responses/
3. Processing: Conversion → ./artifacts/
4. Distribution: Sync to ./human/ and ./llm/
5. 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