bruno/dss

Files

Digital Production Factory 2c9f52c029 [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.

2025-12-09 19:25:11 -03:00

1.3 KiB

Raw Blame History

DSS Knowledge Base

This directory contains structured data schemas for AI agent knowledge about the Design System Server project.

Files

Core Architecture

dss-architecture.json - Three-tier enterprise architecture (Router, Messaging, Workflows)
- Module specifications
- Design patterns applied
- Performance metrics

Design Principles

dss-principles.json - Immutable core principles governing DSS
- Monolithic structure definition
- Translation dictionary patterns
- Custom props strategy
- Multi-system ingestion flow
- UI library normalization rules

MCP Tools

mcp-tools.json - MCP-first tool specifications
- 6 Project Management Tools
- 5 Context Compiler Tools
- Tool inputs, outputs, and operations
- Architecture benefits

Usage

These JSON schemas are designed to be:

Machine-readable - AI agents can parse and query efficiently
Version-controlled - Track changes to project knowledge
Single source of truth - Eliminate redundant documentation
Queryable - Enable semantic search and analysis

MCP Memory Graph

The knowledge in these files is also synchronized to the MCP memory graph for cross-session persistence and relationship mapping.

See the main README.md for project overview and natural language documentation.

1.3 KiB Raw Blame History