Folder Structure — Claude Compass

🌐 Global Claude Config — Always Loaded

C:\Users\matt_\
│
└── .claude\                          ← Global Claude Code config (auto-created)
    ├── CLAUDE.md                     ← Writing style, your role, global prefs
    ├── memory\                       ← Auto-managed by Claude — do not edit
    │   └── MEMORY.md                 ← Auto index of all memory files
    └── commands\                     ← Global skills (always available)
        ├── clone-repo.md             ← /clone-repo — delete and re-clone a repo for a new session
        ├── create-customer.md        ← /create-customer — create a new customer workspace
        ├── create-project.md         ← /create-project — create a new project under a customer
        ├── create-repo.md            ← /create-repo — first-time repo setup for a project
        ├── fabric-cicd-setup.md      ← /fabric-cicd-setup — set up Fabric CI/CD pipeline
        ├── handover.md               ← /handover — save a structured session handover note
        └── update-handover.md        ← /update-handover — update an existing handover note

ℹ️

Everything in ~/.claude/ is available in every session from every folder. This is where your writing style and global skills live.

🏢 Work Root — Disseminate Limited

C:\Users\matt_\OneDrive\Claude\                              ← Stable working root (create this)
│
├── CLAUDE.md                         ← Disseminate context: stack, standards, structure
│
├── _claude-guide\                    ← My Claude Compass (this website)
│   ├── assets\
│   ├── index.html
│   └── ...
│
├── _global\                          ← Global Claude config (symlinked from ~/.claude)
│   ├── CLAUDE.md                     ← Writing style, rules, global preferences
│   ├── memory\                       ← Memory files (always loaded)
│   └── commands\                     ← Global skills / slash commands
│
├── _output\                          ← Root-level Claude outputs and handover notes
│
├── _temp\                            ← Temporary uploads: screenshots, files to share with Claude
│
├── Customers\
│   ├── CustomerA\
│   │   ├── CLAUDE.md             ← Customer: env names, contacts, workspace IDs
│   │   ├── _temp\                 ← Screenshots, files to share with Claude (this customer)
│   │   ├── _context\              ← Stable reference — never deleted
│   │   │   ├── urls-connections.md   ← Fabric endpoints, DevOps URLs
│   │   │   ├── security-notes.md     ← ⚠ Non-secret config only
│   │   │   └── architecture.md
│   │   │
│   │   ├── Project1\              ← OPEN THIS for Project1 work
│   │   │   ├── CLAUDE.md         ← Project scope, tables, naming
│   │   │   ├── _temp\             ← Screenshots, files to share with Claude (this project)
│   │   │   ├── .claude\
│   │   │   │   └── commands\     ← Project-specific skills
│   │   │   ├── _context\
│   │   │   │   └── design-docs\  ← Upload design docs here
│   │   │   ├── _output\           ← Claude responses, generated docs
│   │   │   ├── Project1.code-workspace ← Multi-root VS Code workspace
│   │   │   └── repos\             ← All clones live here
│   │   │       ├── Project1-Bronze\  ← git clone (ephemeral)
│   │   │       ├── Project1-Silver\  ← git clone (ephemeral)
│   │   │       ├── Project1-Gold\    ← git clone (ephemeral)
│   │   │       └── Project1-PowerBI\ ← git clone (ephemeral)
│   │   │
│   │   ├── Project2\
│   │   │   └── ... same structure ...
│   │   │
│   │   └── _powerbi-crossproject\    ← Cross-project PBI (spans all projects)
│   │       └── repos\
│   │           └── CustomerA-PowerBI\    ← Refresh less often than project repos
│   │
│   └── CustomerB\
│       └── ... same structure ...
│
├── Disseminate\                      ← Work done on the business (not for clients)
│   ├── CLAUDE.md                     ← Internal context, business goals
│   ├── _assets\                      ← Logo, branding, images, brand guidelines
│   ├── _templates\                   ← Proposal, SoW, report and email templates
│   ├── _admin\                       ← Contracts, insurance, company documents
│   └── Projects\                     ← Internal projects with defined scope
│
└── Personal\
    ├── CLAUDE.md                     ← Personal: learning goals, tech stack
    └── Projects\
        ├── App1\
        └── App2\

🔑 Stability Reference

Folder / File	Stable?	Rule
`~/.claude/`	Permanent	Never delete. Auto-managed by Claude Code.
`CLAUDE.md` files at any level	Permanent	Live outside repos. Always preserved.
`_context\` folders	Permanent	Design docs, URLs, notes. Never inside a repo.
`_output\` folders	Semi-stable	Claude's outputs. Keep until no longer needed.
`.code-workspace` files	Permanent	Lives at project root above `repos\`. Survives re-clones.
`repos\ProjectX-Bronze\`	Ephemeral	Delete and re-clone freely. Nothing important here.

🔄 Your Repo Workflow

Since you delete and re-clone repos rather than keeping them long-lived, the key rule is: the project folder above repos\ is your stable anchor.

Step	Action	Location
1. Start work	Clone into `repos\` subfolder	`Project1\repos\Project1-Bronze\`
2. Open VS Code	Open workspace file (not the repo)	`Project1\Project1.code-workspace`
3. Work with Claude	Claude has full context cascade	Reads CLAUDE.md at project → customer → Kerv
4. Commit & PR	Commit, push, raise PR in Azure DevOps	Normal git workflow
5. Done for now	Delete the repo folder	`Project1\repos\Project1-Bronze\` deleted
6. Next session	Re-clone into same subfolder name	Workspace file reconnects automatically

✅

Because the .code-workspace file uses relative paths like "path": "repos/Project1-Bronze", re-cloning with the same folder name instantly reconnects all roots in VS Code.