- HEARTBEAT.md: 5,297 → 449 bytes (-92%) — current focus only, projects moved to memory/projects-active.md - AGENTS.md: 7,869 → 1,603 bytes (-80%) — core rules only, MCP playbook moved to memory/playbook-mcp.md - SOUL.md: 5,394 → 1,935 bytes (-64%) — same security, fewer words - USER.md: 2,732 → 705 bytes (-74%) — collaborators moved to memory/contacts.md - lessons-learned.md: 27,252 → 3,031 bytes (-89%) — hot universal rules only, rest in lessons-archive.md - 2026-02-15.md: 24,675 → 2,453 bytes (-90%) — compressed, full version in archive/ Total injected tokens: ~5,700 → ~2,000 (65% reduction) Research basis: Stanford 'Lost in the Middle', JetBrains context management study
31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# MCP Work Playbook (loaded on demand, not injected)
|
|
|
|
## Source of Truth
|
|
All MCP work committed + pushed to `mcpengine-repo/` (`BusyBee3333/mcpengine`).
|
|
|
|
## Gold Standard
|
|
Before ANY MCP server work: read `mcp-gold-standard.md`.
|
|
Covers: server architecture (main.ts/server.ts, lazy loading), API client patterns, tool file structure (Zod + naming), React app patterns (ErrorBoundary, dark theme, mock data), landing pages (chat demo, GSAP, site-generator), README requirements.
|
|
|
|
## Factory Checklist
|
|
Before spawning build agents: read `mcp-factory-checklist.md` + follow pre-flight.
|
|
After agent completes: run post-completion verification. NEVER trust agent narratives — verify filesystem.
|
|
|
|
## File Locations
|
|
- Servers: `mcpengine-repo/servers/{platform-name}/`
|
|
- Apps/UI: `mcpengine-repo/servers/{platform-name}/src/apps/` or `ui/`
|
|
- Factory tools: `mcpengine-repo/infra/factory-tools/`
|
|
- Pipeline state: `mcpengine-repo/infra/command-center/`
|
|
- Reviews: `mcpengine-repo/infra/factory-reviews/`
|
|
- Landing pages: `mcpengine-repo/landing-pages/`
|
|
- Docs: `mcpengine-repo/docs/`
|
|
|
|
## Workflow
|
|
1. Build in workspace for speed
|
|
2. Sync: `rsync -a --exclude='node_modules' --exclude='.git' src/ mcpengine-repo/servers/{name}/`
|
|
3. Commit + push: `cd mcpengine-repo && git add -A && git commit -m "{name}: {what}" && git push`
|
|
|
|
## Also push to individual repos when they exist
|
|
- GHL → `BusyBee3333/Go-High-Level-MCP-2026-Complete`
|
|
- 30 original servers → `BusyBee3333/{name}-mcp-2026-complete`
|