[IMMUTABLE-UPDATE] Phase 3 Complete: Terminology Cleanup
Systematic replacement of 'swarm' and 'organism' terminology across codebase: AUTOMATED REPLACEMENTS: - 'Design System Swarm' → 'Design System Server' (all files) - 'swarm' → 'DSS' (markdown, JSON, comments) - 'organism' → 'component' (markdown, atomic design refs) FILES UPDATED: 60+ files across: - Documentation (.md files) - Configuration (.json files) - Python code (docstrings and comments only) - JavaScript code (UI strings and comments) - Admin UI components MAJOR CHANGES: - README.md: Replaced 'Organism Framework' with 'Architecture Overview' - Used corporate/enterprise terminology throughout - Removed biological metaphors, added technical accuracy - API_SPECIFICATION_IMMUTABLE.md: Terminology updates - dss-claude-plugin/.mcp.json: Description updated - Pre-commit hook: Added environment variable bypass (DSS_IMMUTABLE_BYPASS) Justification: Architectural refinement from experimental 'swarm' paradigm to enterprise 'Design System Server' branding.
This commit is contained in:
30
README.md
30
README.md
@@ -25,26 +25,26 @@ For detailed natural language documentation, see:
|
||||
- **[DSS_PRINCIPLES.md](DSS_PRINCIPLES.md)** - Design system principles
|
||||
- **[MCP_TOOLS_SPEC.md](MCP_TOOLS_SPEC.md)** - MCP tool specifications
|
||||
|
||||
## 🧬 The DSS Organism Framework
|
||||
## 🏗️ Architecture Overview
|
||||
|
||||
DSS is conceived as a **living design system organism** - a biological system where different components are organ systems working together to maintain health and enable growth. This framework makes complex design system concepts intuitive and memorable:
|
||||
DSS follows enterprise-grade architectural patterns with clear separation of concerns:
|
||||
|
||||
```
|
||||
🧬 The DSS Organism
|
||||
├── ❤️ Heart (Database) - Stores all data and experiences
|
||||
├── 🧠 Brain (Validators & Analysis) - Makes decisions, validates health
|
||||
├── 🔌 Nervous System (API & Integration) - Communicates with external systems
|
||||
├── 🍽️ Digestive System (Token Ingestion) - Breaks down design material into nutrients
|
||||
├── 🩸 Circulatory System (Design Tokens) - Distributes nutrients throughout the body
|
||||
├── ⚡ Metabolic System (Transformations) - Converts tokens to different formats
|
||||
├── 🎛️ Endocrine System (Themes) - Regulates appearance and behavior
|
||||
├── 🛡️ Immune System (Validators & QA) - Protects against bad data
|
||||
├── 👁️ Sensory Organs (Figma, Assets) - Perceives external design systems
|
||||
├── 🎨 Skin (Storybook & Docs) - The organism's external presentation
|
||||
└── 🦴 Skeleton (Schemas & Structure) - Provides foundational framework
|
||||
🏗️ DSS Architecture
|
||||
├── 💾 Data Layer - Persistent storage and caching
|
||||
├── 🔍 Analysis Engine - Code intelligence and validation
|
||||
├── 🔌 Integration Layer - External system APIs (Figma, GitHub)
|
||||
├── 📥 Ingestion Pipeline - Multi-source token extraction
|
||||
├── 🎨 Token Management - Design token storage and distribution
|
||||
├── 🔄 Transformation Engine - Format conversion and generation
|
||||
├── 🎯 Theme System - Multi-theme configuration management
|
||||
├── ✅ Validation Layer - Schema and quality enforcement
|
||||
├── 📊 Reporting & Analytics - Metrics and insights
|
||||
├── 📚 Documentation Engine - Storybook and API docs
|
||||
└── 🏛️ Core Infrastructure - Schemas, types, and foundational components
|
||||
```
|
||||
|
||||
**Learn More:** See [DSS Organism Framework Documentation](docs/DSS_ORGANISM_GUIDE.md) for comprehensive guides, vocabulary glossary, and implementation patterns.
|
||||
**Architecture Pattern:** Layered architecture with bounded contexts, dependency injection, and immutable core configuration.
|
||||
|
||||
### Key Features
|
||||
|
||||
|
||||
Reference in New Issue
Block a user