[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:
Digital Production Factory
2025-12-09 19:25:11 -03:00
parent 6ac9e7d811
commit 2c9f52c029
52 changed files with 154 additions and 154 deletions

View File

@@ -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