Chapter 2: Workspace Overview

Last Updated: 2026-04-16

/Users/username/Cursor/
├── ITI/                    # IT Influentials business monorepo
├── Personal/               # Personal projects
├── Archives/               # Timestamped backups from backup.sh
├── Globals/                # Workspace-level shared assets
├── Experiments/            # Throwaway / proof-of-concept work
├── _backups/               # Snapshot backups
├── .mcp.json               # MCP server configuration (n8n)
├── .vscode/                # VS Code / Cursor workspace settings
├── README.md               # Workspace overview
└── CLAUDE.MD               # Root AI context file

2.2 The ITI Monorepo

ITI/ is the primary business monorepo. It contains everything needed to run IT Influentials as an organization.

ITI/
├── .agents/                # Antigravity workspace config (rules, skills, workflows)
├── .antigravity/           # Antigravity session artifacts (gitignored)
├── branding/               # Logos, themes, color palettes, brand guidelines
├── clients/                # Client projects (isolated per client, classifications per Ch. 31)
├── infrastructure/         # Docker orchestration
│   └── n8n-dify/           # 9-service stack (the platform foundation)
│       ├── docker-compose.yml
│       ├── .env            # Secrets — never committed to Git
│       ├── init-db.sql     # PostgreSQL initialization
│       ├── dify-nginx.conf # Nginx gateway config
│       ├── backup.sh       # Automated backup script
│       ├── kb-migrate.sh   # Knowledge base migration
│       └── tests/          # pytest smoke + integration test suite
├── internal/               # Internal-use tools (3)
│   ├── gd-claude-chatbot/  # Grateful Dead chatbot (reference implementation)
│   ├── iti-agents/         # Agent documentation and specs
│   └── iti-chatbot/        # ITI chatbot platform
├── knowledge/              # Consultancy knowledge base
│   ├── prompts/            # AI system prompts
│   ├── consultancy/        # Management and advisory knowledge
│   ├── coding-playbook/    # Coding conventions and guides
│   ├── chat-transcripts/   # Important AI conversation logs
│   └── context-files/      # Role definition files
├── marketing/              # Campaigns, content, LinkedIn, website assets
├── operations/             # Business operations hub
│   ├── agents/             # 109 indexed agents + 34 dev-process agents
│   ├── Skills/             # 233 skills (Claude-Skills/ is canonical source)
│   ├── business-documents/ # SOPs, plans, financial models
│   ├── documentation/      # This manual and all technical docs
│   ├── portfolios/         # Portfolio showcase docs
│   ├── requirements/       # Product and agent requirements
│   └── scripts/            # Automation scripts
├── products/               # 20 product directories (see Chapter 32)
├── shared/                 # ITI Shared Library (see Chapter 13)
├── training/               # Training materials and data
├── CLAUDE.md               # ITI monorepo AI context file
└── README.md               # ITI overview

---

2.3 Products Directory

ITI/products/ contains each commercial product in its own subdirectory. Every product maintains its own Git repository and its own set of required artifacts (CLAUDE.md, REQUIREMENTS.md, ARCHITECTURE.md, DEPLOY.md, THIRD_PARTY.md).

Product Directory	Description
aeo-optimizer/	Answer Engine Optimization WordPress plugin
ai-news-cafe/	AI news aggregation chatbot
backyard-gardener-cleanup-utility/	Gardening advisor (cleanup utility)
career-coach/	Career development plugin
estate-manager/	Estate planning (WordPress + Desktop + PWA)
executive-advisor/	Multi-agent executive consultation
factchecker-plugin/	Fact-checking WordPress plugin
farmers-bounty/	Garden planning, harvest tracking
gd-chatbot/	Grateful Dead chatbot plugin
household-os/	Household management system
it-influentials-website/	Main ITI website
it-influentials.com/	Company web property
journey-mapper/	Customer journey mapping tool
local-seo/	Local SEO tools
my-travelplanner/	Travel planning plugin
patriot-university/	Civic engagement and voting accountability
scuba-gpt/	Scuba diving advisor
seo-assistant-plugin/	SEO assistant

---

2.4 Personal Projects

Personal/ mirrors the ITI structure but for non-business projects.

Personal/
├── personal-assistant/     # Tauri 2 desktop AI assistant
├── expat-advisor/          # Native macOS expat planning app (Swift/SwiftUI)
├── patriot-agent/          # Flask-based civic engagement tool
├── Retirement Planner/     # Financial planning (Swift/Rust)
├── operations/             # Personal ops mirror (agents, skills)
├── ops/                    # Personal ops scripts
├── CLAUDE.md               # Personal projects AI context file
└── README.md               # Personal projects index

---

2.5 The Shared Library

ITI/shared/ is the most important directory for any developer. Before writing any new code, check the shared library first.

ITI/shared/
├── wordpress/              # WordPress PHP library (11 files)
│   ├── api-clients/        # Claude, Tavily, Pinecone, Workflow Adapter
│   ├── database/           # Database base class
│   ├── admin-ui/           # Admin UI components
│   ├── chat-handlers/      # Chat orchestration
│   └── utilities/          # Helper functions
├── desktop/                # Tauri/Electron library (6 files)
│   ├── auth/               # Authentication
│   ├── database/           # Local SQLite database
│   └── services/           # Common services
├── ios-macos/              # Swift library (2 files)
│   ├── ClaudeService.swift
│   └── KeychainService.swift
├── python/                 # Python utilities (2 files)
├── rust/                   # Rust shared components
├── patterns/               # Architecture pattern documentation
│   ├── singleton/
│   ├── rag-architecture/
│   ├── multi-agent/
│   ├── database/
│   ├── wordpress-plugin/
│   └── desktop/
├── templates/              # Project starter templates
│   ├── wordpress-plugin/
│   ├── desktop-app/
│   └── pwa/
├── CATALOG.md              # Full component catalog
├── QUICK-START.md          # Getting started guide
└── README.md               # Library documentation

See Chapter 13 for full usage instructions.

---

2.6 Operations Directory

ITI/operations/ is the nerve center for non-product business activity.

Subdirectory	Contents
agents/	109 indexed agents (JSON + MD) + 34 dev-process agents (MD)
Skills/Claude-Skills/	Canonical source for all 233 ITI-authored skills
documentation/	This manual, workspace maps, quickstart guides
documentation/manual/	This manual (chapter files)
business-documents/	SOPs, strategic plans, financial models
portfolios/	Portfolio showcase documents for consulting
requirements/agents/	ITI Agent System definitions
scripts/	Operational automation scripts

Key operational documents:

File	Purpose
documentation/WORKSPACE-MAP.md	Visual directory map
documentation/GUIDE-TO-ALL-AGENTS-AND-SKILLS.md	Master agent and skill catalog
documentation/QUICKSTART-GUIDE.md	New team member onboarding
agents-and-skills.md	Global master reference (143 agents, 233 skills)
knowledgebase-inventory.md	Full inventory of all KB files
workflow-documentation.md	Workflow patterns with sample code

---

2.7 Git Repository Structure

The workspace uses multiple Git repositories:

Repository	Location	Scope
ITI monorepo	ITI/.git	All ITI shared infrastructure, operations, marketing
Operations sub-repo	ITI/operations/.git	Operations-only version control
Marketing sub-repo	ITI/marketing/.git	Marketing assets
Branding sub-repo	ITI/branding/.git	Brand assets
Training sub-repo	ITI/training/.git	Training materials
Per-product repos	ITI/products//.git	Each product individually versioned
Per-internal repos	ITI/internal//.git	Each internal tool individually versioned
Per-personal repos	Personal//.git	Each personal project individually versioned

Warning: The .env file at ITI/infrastructure/n8n-dify/.env contains all infrastructure secrets. It is listed in .gitignore and must never be committed to any repository.

---

2.8 Configuration Files

File	Location	Purpose
.mcp.json	Workspace root	MCP server configuration for n8n
.vscode/	Workspace root	VS Code/Cursor workspace settings
CLAUDE.MD	Workspace root	Root-level AI context
CLAUDE.md	ITI/	ITI monorepo AI context
CLAUDE.md	Personal/	Personal projects AI context
CLAUDE.md	Per product	Product-specific AI context

Every CLAUDE.md file is read by the AI at the start of each build session to establish context. See Chapter 23 for the full session protocol.

---

2.9 Finding Things Quickly

# List all products
ls ITI/products/

# List all clients
ls ITI/clients/

# List all personal projects
ls Personal/

# Navigate to shared library
cd ITI/shared/

# Navigate to infrastructure
cd ITI/infrastructure/n8n-dify/

# Navigate to operations
cd ITI/operations/

# Find any CLAUDE.md file
find /Users/username/Cursor -name "CLAUDE.md" -maxdepth 4

---

Previous: Chapter 1 — Introduction | Next: Chapter 3 — The Docker Stack