276ed71f31
Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm
Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)
Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability
Migration completed: $(date)
🤖 Clean migration with full functionality preserved
3.0 KiB
3.0 KiB
DSS Context Map - Read This First
CRITICAL FOR AI AGENTS: This file maps the entire DSS documentation hierarchy. Read this first when starting a new session to understand where information lives.
Entry Point
You are in: /home/overbits/dss/
📘 TIER 1: Foundational Contracts (Always Loaded)
These files define the immutable contracts and philosophy of DSS. They change only through semantic versioning.
System Architecture
- File:
docs/01_core/ARCHITECTURE.md - Contains: System design, component boundaries, technology stack
- Updated When: Major architectural decisions are made
API Contracts
- File:
docs/01_core/API_CONTRACTS.md - Contains: Complete API specification, endpoint contracts, error codes
- Updated When: New endpoints added or contracts change
Design System Philosophy
- File:
docs/01_core/PRINCIPLES.md - Contains: Core principles, design philosophy, development values
- Updated When: Core philosophy evolves
📊 TIER 2: Current State (Always Loaded)
These files reflect the current state of the system in production.
Project Status
- File:
docs/02_status/PROJECT_STATUS.md - Contains: Deployment status, active bugs, roadmap
Implementation Summary
- File:
docs/02_status/IMPLEMENTATION_SUMMARY.md - Contains: What has been built (phases 1-5C)
Project Overview
- File:
README.md(in root) - Contains: Quick start, project description
📖 TIER 3: Reference Guides (Load as Needed)
- Integration:
docs/03_reference/INTEGRATION_GUIDE.md - Migration:
docs/03_reference/MIGRATION_GUIDE.md - MCP Tools:
docs/03_reference/MCP_TOOLS_SPEC.md - Production:
docs/03_reference/PRODUCTION_READINESS.md
📦 TIER 4: Historical Archive
Location: docs/archive/pre_optimization/
Do NOT load these for normal work. These are historical snapshots from past phases.
🎯 Core Principles
- Single Source of Truth - Each concept documented once
- Foundational Contracts - API specs and principles are immutable
- Current State Transparency - Status always reflects production
- Progressive Detail - Quick ref → guides → specs
- Phase Agnostic - Docs independent of dev phases
- Knowledge Persistence - Deep context in
.knowledge/graph - MCP First - Design system tools are first-class citizens
📍 Quick Navigation
| I Need To... | Read This... |
|---|---|
| Understand the system | docs/01_core/ARCHITECTURE.md |
| Check API endpoints | docs/01_core/API_CONTRACTS.md |
| See what's deployed | docs/02_status/PROJECT_STATUS.md |
| Integrate DSS | docs/03_reference/INTEGRATION_GUIDE.md |
| Migrate to DSS | docs/03_reference/MIGRATION_GUIDE.md |
| Know the philosophy | docs/01_core/PRINCIPLES.md |
| Deploy production | docs/03_reference/PRODUCTION_READINESS.md |
| Understand MCP tools | docs/03_reference/MCP_TOOLS_SPEC.md |
| Learn the project | README.md |
| Contribute code | CONTRIBUTING.md |
Last Updated: 2025-12-08