claude-code-ultimate-optimal-framework

Scaffold a Claude Code workspace with routing, memory, and self-updating architecture — in one command.

What It Creates

A 3-layer routing system that tells Claude exactly what to load (and what to skip) for every task. Keeps token usage low, memory high, and context relevant.

your-workspace/
├── CLAUDE.md                 ← Master map (always loaded)
├── CONTEXT.md                ← Task router
├── PROJECT-REGISTRY.md       ← Project index
├── company/                  ← Brand voice, products, SOPs
├── departments/              ← One workspace per department
├── products/                 ← One workspace per product
├── projects/                 ← Time-bounded initiatives (auto-created)
└── _system/                  ← Infrastructure docs + project templates

Usage

npx claude-code-ultimate-optimal-framework init

The CLI will ask you about:

• Company name, description, tagline, website, industry
• Which departments exist
• Products and services
• VPS or local server infrastructure (optional)
• Where to create the workspace

Then it generates the entire folder structure with customized files.

How the System Works

3-Layer Routing

| Layer | File | Purpose | Size | |-------|------|---------|------| | 1 | CLAUDE.md | Always loaded — the map | ≤200 lines | | 2 | CONTEXT.md | Task router — where to go | 30-50 lines | | 3 | [workspace]/CONTEXT.md | Scoped instructions per task | 25-80 lines |

Self-Updating

Paste or speak unstructured thoughts and Claude routes them to the right files automatically:

• "Our brand voice is warm but direct..." → updates company/voice-brand.md
• "We're launching a new service called X..." → updates company/products.md
• "We need a new onboarding process..." → creates company/sops/sop-onboarding.md

Auto-Scaffolding

Say "New project: [describe what you need]" and Claude:

1. Infers the project type (biz-initiative / va-workflow / product-build)
2. Creates the folder structure from the right template
3. Registers it in PROJECT-REGISTRY.md and CLAUDE.md

Token Management

Every workspace has a "Skip These" column — telling Claude what NOT to load. This prevents context bloat on large workspaces.

Local Development

git clone <this repo>
cd claude-code-ultimate-optimal-framework
npm install
node bin/claude-code-ultimate-optimal-framework.js

Publishing

npm publish

Requirements

• Node.js 18+
• Claude Code (claude.ai/code)