# 🏠 AI Home Directory - Databank

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

---

## 📋 Table of Contents
- [Overview](#overview)
- [Directory Structure](#directory-structure)
- [Usage Guidelines](#usage-guidelines)
- [Integration Points](#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/`](./human/) |
| **LLM-Optimized** | Structured data for AI agent consumption | [`./llm/`](./llm/) |
| **Collaborative Input** | Shared workspace for updates | [`./collab/`](./collab/) |
| **Canonical Source** | Authoritative content storage | [`./artifacts/`](./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/`](./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/`](./human/) for beautiful, readable documentation
- **LLM Format**: Access [`./llm/`](./llm/) for structured, token-efficient data
- **Updates**: Modify only PMO directory, not databank
- **Intake**: Contribute to [`./collab/intake/`](./collab/intake/) with new information

### For Joplin Integration
- **Export Location**: Drop Joplin markdown exports in [`./collab/fromjoplin/`](./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**](https://git.knownelement.com/KNEL/TSYSDevStack) - Docker artifacts repository for development environment

### Mounting in Containers
```bash
# 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/`](./collab/fromjoplin/)
2. **Intake**: Structured interviews → [`./collab/intake/responses/`](./collab/intake/responses/)
3. **Processing**: Conversion → [`./artifacts/`](./artifacts/)
4. **Distribution**: Sync to [`./human/`](./human/) and [`./llm/`](./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*