Wiki Directory Structure

Joseph's wiki root is /opt/data/wiki — ALWAYS use full absolute paths (never relative),

and never cd-and-hope. The structure is stable and won't change; don't re-discover it each

session. If you need a fresh look, get the whole tree in ONE command, don't walk dirs one-by-one.

Get the tree fast

tree is NOT installed. Use find:

find /opt/data/wiki -type d -not -path '/.' | sort | sed 's|[^/]*/|  |g'

One command returns the entire layout. Parse that instead of navigating directory by directory.

Directory map (verified 2026-08-31)

/opt/data/wiki/
├── consume/                  External input
│   ├── articles/  comparisons/  concepts/  entities/  highlights/
│   ├── queries/
│   ├── raw/          articles/  assets/  papers/  voice-notes/
│   ├── tracking/
│   └── transcripts/
├── produce/
│   ├── common/               ChatGPT-extracted files (139 files, reference only)
│   ├── blogs/                ← Mac-synced (jjude + ctofieldnotes) — NEVER WRITE
│   │   ├── ctofieldnotes/
│   │   └── jjude/
│   └── hermes/               ← co-created with Joseph — WRITE HERE
│       ├── blogs/
│       │   ├── ctofieldnotes/  ideas/
│       │   └── drafts/         unified draft dir (both blogs, be-a-fox, editorial-diagrams-for-blog,
│       │                        examples, images/, plans/, prompts/, update-ai-image-generation-post/)
│       ├── social-media/     _meta/  content/  images/{diagrams,generated,infographics,quote-cards}
│       │                     sources.csv  ← SINGLE location for all social media across both blogs
│       ├── books/            always-be-shipping, become-the-person, build-on-the-rock,
│       │                     choose-your-game, hs/{contents,gumroad}, snowballs,
│       │                     systems-driven-life, the-freedom-of-less, word-in-world/{gumroad,meditations}
│       ├── commercial/       coaching/engagements, [client]/{initiatives,monthly,reviews,
│       │                     solutions}, [client], vc/due-diligence
│       ├── hermes-audit/
│       ├── homeschooling/
│       ├── library/          writing-concepts (227), writing-themes (7)
│       ├── plans/
│       └── products/         courses, manufacturing-saas
├── self/                     S: Health, faith, homeschooling, goals, retros, operating system
│   ├── assessments  decisions  frameworks  goals  patterns
│   ├── retros/{auto/2026, curated/{monthly,quarterly,weekly,yearly}}
│   └── archive/
├── network/                  N: Relationship tracking, engagement
│   └── social/               networking/relationship tracking (NOT social-media)
└── wealth/                   W: Personal finance
    ├── consulting/    CTO consulting (primary wealth-building)
    │   ├── [client]/  [client]/  coaching/  vc/  invoices/
    ├── expense/              Expense tracking (regular + fuel)
    └── invest/  fd  mf  stock/{charts}
        └── portfolio/        Holdings + quarterly analysis
            ├── analysis/     Self-contained quarterly sub-folders (2026-q3/{stocks,mf,report})

Write permissions (critical)

Hermes WRITES only to:

/opt/data/wiki/wealth/consulting/ — consulting work (reviews, initiatives, invoices, coaching)
/opt/data/wiki/wealth/expense/ — expense tracking (append blindly, never read; see expense-tracking skill)
/opt/data/wiki/wealth/invest/ — stock (stock/), MF (mf/), FD (fd/) analyses
/opt/data/wiki/produce/hermes/ — books, products, blogs/drafts, library, plans
/opt/data/wiki/self/decisions/ — decision log (see decision-log skill)
/opt/data/wiki/consume/ — YouTube transcripts, article extracts, concepts, entities

Hermes NEVER writes to (Mac-sync trap):

/opt/data/wiki/produce/blogs/jjude/ — synced from Mac (jjude.com)
/opt/data/wiki/produce/blogs/ctofieldnotes/ — synced from Mac (CTO Field Notes)

Key reference paths

produce/hermes/library/writing-concepts/ (227) + writing-themes/ (7)
produce/hermes/books/hs/ — homeschooling book; hs/gumroad/ — Gumroad materials
produce/hermes/plans/ — project plans/roadmaps
produce/hermes/blogs/drafts/ — unified blog draft dir (jjude + CTO Field Notes)
produce/hermes/blogs/drafts/prompts/ — prompts for draft generation (images + essays)
produce/hermes/blogs/drafts/plans/ — task/plan files for drafts (delete when essay published)
produce/hermes/social-media/ — social media pipeline for both blogs (cross-cutting)
wealth/consulting/ — CTO consulting work ([client], [client], coaching, vc, invoices)

Root files (canonical)

index.md — Wiki index
log.md — Chronological log
schema.md — Structure definition
readme.md — Orientation
agents.md — Working instructions
wiki-folder-structure.md — User reference for folder structure

Style notes

Joseph prefers bullet/nested-outline replies over tables (Slack readability).
Files/decisions should be written under the appropriate WINS pillar; see wiki/agents.md

for the richer working-instructions reference.

wiki-directory-structure