# Workspace Structure

The ox workspace follows the "two trees, one workspace" pattern: `o/` for knowledge, `x/` for code.

```
~/ox/                                    # Workspace root (NOT a git repo)
├── .agents/                             # Universal agent context
│   ├── workspace-structure.md           # This document
│   ├── philosophy.md                    # Team values & principles
│   ├── SOUL.md                          # Identity & behavioral core
│   ├── IDENTITY.md                      # Agent behavioral guidelines
│   ├── AGENTS.md                        # Agent workspace rules
│   └── shared/                          # Operational state
│       ├── deployments.md               # Live deployment map
│       └── infrastructure.yaml          # Single source of truth for infra
│
├── o/                                   # Obsidian vault (knowledge layer)
│   ├── .obsidian/                       # Vault configuration
│   └── o/                               # Vault content root
│       ├── who/                         # People — every person gets a linked note
│       ├── what/                        # Projects, orgs, tools, topics
│       │   ├── orgs/
│       │   │   ├── COM/                 # Commercial organizations
│       │   │   ├── EDU/                 # Educational institutions
│       │   │   └── FAM/                 # Family organizations
│       │   ├── bots/                    # AI agent notes & shared memory
│       │   │   └── memory/              # Cross-device synced memory
│       │   └── [topics]/                # Skills, tools, career, essays, etc.
│       ├── when/                        # Temporal — daily notes, cycles, events
│       │   ├── days/                    # Daily notes
│       │   ├── weeks/  months/  quarters/  years/
│       │   ├── cycles/                  # Sprint/project cycles
│       │   └── events/                  # Calendar events
│       └── where/                       # Geolocation only (physical places)
│
└── x/                                   # Code layer
    └── code/
        └── remote/
            └── github/
                └── <org>/               # One directory per GitHub org
                    └── <repo>/          # Each repo keeps its own .git history
```

## Conventions

- **Two trees:** `o/` is for thinking (knowledge), `x/` is for doing (code).
- **Repository paths mirror the remote:** `x/code/remote/{host}/{org}/{repo}/`. All code repos are checked out under `x/code/`.
- **Wikilinks use absolute vault-root paths:** `[[o/who/John Doe]]`, `[[o/what/orgs/COM/iwl/infrastructure]]`.
- **`o/where/` is reserved for geolocation only** — infrastructure notes live under `o/what/orgs/...`.
- **Every repo includes a `CLAUDE.md`** for agent onboarding, cross-referencing the relevant notes in `o/`.
- **The who/what/when/where convention** organizes the vault: people, things, time, and place.

See also: [Methodology](https://iamox.ai/docs/methodology.md) · [Code Indexing](https://iamox.ai/docs/code-indexing.md)