reachableceo/ReachableCEO-AI-Homedir-Public

Files

ReachableCEO 61919ae452 docs: improve documentation formatting and remove Claude references\n\n- Format AboutMe.md with beautiful tables and improved structure\n- Remove all Claude references from documentation per ethical/legal concerns\n- Create README.md files in all top-level and sub-level directories\n- Update README.md to link to README.md files instead of directories\n- Add beautiful stub README.md files for COO, CTO, and PMO directories\n- Fix directory linking issues in main README.md\n- Ensure all links point to actual files rather than directories\n- Update version tracking in AboutMe.md to v1.0.1 reflecting improvements\n- Maintain consistency with filesystem structure and documentation standards\n- Preserve AI tools: Codex, Qwen, Gemini while removing Claude references

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

2025-10-24 11:36:12 -05:00

11 KiB

Raw Blame History

🏠 AI Home Directory

Your centralized knowledge base and project management office for AI-assisted development

🧠 Overview

Aspect	Description
Purpose	Centralized "AI home directory" with separated readonly databank and read-write PMO
Function	Provides consistent context across all projects with managed project updates
Integration	Mounted in development containers with appropriate permissions
Status	Actively evolving knowledge base with structured PMO functionality

This repository functions as my 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.

🏗️ Repository Structure


AI-Home-Directory/          # Mount point in containers

├── databank/               # 🔒 Readonly context (mounted readonly)

│   ├── personal/           # Personal information

│   │   ├── AboutMe.md

│   │   └── TSYS.md

│   ├── agents/             # AI agent guidelines

│   │   ├── AgentRules.md

│   │   ├── AGENTS.md

│   │   └── AI-TOOLS.md

│   ├── operations/         # Operational environment information

│   │   └── OPERATIONS-KNOWLEDGE-TRANSFER.md

│   ├── coo/                # Chief Operating Officer domain

│   │   └── (COO handoff information and processes)

│   ├── cto/                # Chief Technology and Product Officer domain

│   │   ├── vpengineering/  # VP Engineering focus area

│   │   └── vpproduct/      # VP Product focus area

│   ├── templates/          # Template files for projects

│   │   └── OPS-ENVIRONMENT.md

│   ├── collab/             # Human/AI interaction space

│   └── artifacts/          # AI-managed content and resources

│       ├── docs/           # AI-managed documentation

│       ├── code/           # AI-managed code artifacts

│       ├── config/         # AI-managed configuration

│       └── templates/      # AI-managed templates

├── pmo/                    # ✏️ Read-write PMO (mounted read-write)

│   ├── artifacts/          # PMO components and data

│   │   ├── dashboard/      # PMO dashboard views

│   │   ├── projects/       # Project registry and tracking links

│   │   ├── reports/        # Status reports

│   │   ├── resources/      # Resource management

│   │   ├── config/         # PMO configuration

│   │   └── docs/           # PMO documentation

│   ├── coo/                # COO-specific project management

│   ├── cto/                # CTO-specific project management

│   │   ├── vpengineering/  # VP Engineering project management

│   │   └── vpproduct/      # VP Product project management

│   └── collab/             # PMO-specific collaboration

└── README.md               # This file

🐳 Mounting in Containers

Recommended Mount Pattern

# 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

📚 Databank (Readonly)

The databank directory contains readonly information that provides consistent context across projects.

Personal Information (`databank/personal/`)

File	Purpose
AboutMe.md	Personal information and professional background
TSYS.md	Business information and organizational structure

Agent Guidelines (`databank/agents/`)

File	Purpose
AgentRules.md	Operational guidelines for AI agents
AGENTS.md	Guidelines for AI agents working with this repo
AI-TOOLS.md	AI tool preferences and usage patterns

Operations (`databank/operations/`)

File	Purpose
OPERATIONS-KNOWLEDGE-TRANSFER.md	Knowledge transfer interview for operational roles

COO (`databank/coo/`)

Directory	Purpose
databank/coo/	Chief Operating Officer domain and handoff information

CTO (`databank/cto/`)

Directory	Purpose
databank/cto/	Chief Technology and Product Officer domain
databank/cto/vpengineering/	VP Engineering focus area
databank/cto/vpproduct/	VP Product focus area

Templates (`databank/templates/`)

File	Purpose
OPS-ENVIRONMENT.md	Operational environment template

Collaboration (`databank/collab/`)

Directory	Purpose
databank/collab/	Space for human/AI interaction

Artifacts (`databank/artifacts/`)

Directory	Purpose
databank/artifacts/docs/	AI-managed documentation
databank/artifacts/code/	AI-managed code artifacts
databank/artifacts/config/	AI-managed configuration
databank/artifacts/templates/	AI-managed templates

Note: All databank files are readonly for AI agents except in collab/ and artifacts/ directories

📊 PMO (Read-Write)

The PMO (Project Management Office) directory contains project management functionality where AI agents can update project status and milestones. Project management/todo artifacts stay local to their project, and the PMO links to them. Projects will update the PMO using a defined structure/format/protocol.

PMO Components

Directory	Purpose
pmo/artifacts/	PMO components and data
pmo/artifacts/dashboard/	PMO dashboard views and reports
pmo/artifacts/projects/	Project registry and tracking links
pmo/artifacts/reports/	Status reports and analytics
pmo/artifacts/resources/	Resource allocation and management
pmo/artifacts/config/	PMO configuration and settings
pmo/artifacts/docs/	Detailed PMO documentation
pmo/coo/	COO-specific project management
pmo/cto/	CTO-specific project management
pmo/cto/vpengineering/	VP Engineering project management
pmo/cto/vpproduct/	VP Product project management
pmo/collab/	PMO-specific collaboration

PMO Update Guidelines

AI agents may only update PMO when milestones are reached
Audit logs belong in individual project repositories
Only PMO updates are allowed in this repository
All other content in this repository is readonly

Documentation

For detailed PMO documentation, see the detailed documentation.

🔄 Workflow

Primary Flow

Mount → Databank mounted as readonly, PMO mounted as read-write
Access → AI agents have readonly knowledge from databank
Update → AI agents update PMO with project milestones and status
Report → PMO provides centralized project visibility

Integration Pattern

🌐 Universal Context: Databank available as readonly reference
📊 PMO Updates: Agents update project status in PMO only
⚡ Efficient: Eliminates repetitive context explanation
🔐 Secure: Clear permission boundaries for container mounting

✅ Benefits

Benefit	Impact
🎯 Consistency	All projects have access to the same foundational knowledge (databank)
🔒 Security	Clear permission boundaries with separate mount points
⚡ Efficiency	Eliminates need to repeatedly explain context to AI agents
📈 Scalability	Works seamlessly with multiple ongoing projects
🔧 Maintainability	Centralized updates propagate to all projects automatically
⚙️ Continuity	Provides continuity across different projects
🔗 Integration	Seamless with existing AI tools (Codex, Qwen, Gemini)

🚀 Usage

Getting Started

# Clone the repository
git clone ssh://git@git.knownelement.com:29418/reachableceo/ReachableCEO-AI-Homedir-Public.git

# Mount in your Docker development environment with proper 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

Current AI Tools in Workflow

✨ Codex - Primary daily driver (subscription-based)
🤖 Qwen - Heavy system orchestration, shell/Docker expertise
🔍 Gemini - Primarily for audits

📈 Active Development

⚠️ Note: This knowledge base is actively evolving over the coming hours with substantial updates to the databank.

Planned Enhancements

Additional context files for specific domains
Enhanced PMO dashboard functionality
Integration with more project management tools
Improved documentation structure

🤝 Contributing to Context

Since this serves as a living knowledge base:

All content is designed to be machine-readable for AI agents
Files follow structured formats for easy processing
Regular updates ensure current and relevant information
Version control maintains history and evolution
AI agents treat databank as readonly - only PMO updates allowed
Audit logs belong in projects, not this repository

Change Tracking/Revision Table

Date/Time	Version	Description	Author
2025-10-24 11:30 CDT	1.0.2	Fix repository structure duplication	Charles N Wyble (@ReachableCEO)
2025-10-24 10:50 CDT	1.0.1	Update date format consistency	Charles N Wyble (@ReachableCEO)
2025-10-24 10:34 CDT	1.0.0	Initial change tracking table for README	Charles N Wyble (@ReachableCEO)

Last updated: October 24, 2025
Part of the AIOS (AI Operating System) ecosystem

11 KiB Raw Blame History