How paglaai/pagladesign works
PaglaDESIGN is a canonical, machine-readable design authority, not an application or component kit. Its workflow starts with design doctrine, tokens, specifications, and ecosystem registry; those assets guide downstream surfaces and agents through CSS, human-facing FERN documentation, machine-readable/MCP access, and architecture governance. The README documents these product branches, while the sampled source mainly exposes the FERN and DOCX generators. The MCP implementation and several renderer details are not sampled, so their internal relationships are not expanded.
Main entry points: tokens.css Reference CSS · DESIGN_TOKENS.md Design Tokens · build_fern.py FERN Renderer · DESIGN_DNA.md Design DNA
Components 18
Design Authority
- Design DNA
design-system/DESIGN_DNA.md - Design Tokens
design-system/DESIGN_TOKENS.md - Component Specs
components/COMPONENT_LIBRARY.md - Brand Guidance
brand/BRAND.md - Ecosystem Registry
ecosystem.json
Human Surfaces
- Reference CSS
css/tokens.css - CSS Layers
css/base.css - CSS Utilities
css/utilities.css - FERN Renderer
bin/build_fern.py - Documentation Portal
DOC - DOCX Generator
bin/build_docx.py
Machine Access
- Machine Renderer
design-system/MACHINE_RENDERER.md - MCP Retrieval
.ai/mcp/server.py - RAG Indexer
.ai/mcp/rag.py
Governance
- Architecture Specs
design-system/ARCHITECT_RENDERER.md - ADR Governance
governance/DECISIONS.md
Other components
- Downstream Surfaces
- AI Agents
Connections 13
- Design Tokens → Reference CSS: defines tokens
README.md - Reference CSS → CSS Layers: styles surfaces
README.md - Reference CSS → CSS Utilities: styles surfaces
README.md - Design DNA → Downstream Surfaces: guides implementation
README.md - Component Specs → Downstream Surfaces: specifies components
README.md - Brand Guidance → Downstream Surfaces: guides identity
README.md - Ecosystem Registry → Downstream Surfaces: registers consumers
README.md - FERN Renderer → Documentation Portal: generates portal
README.md - Design Tokens → FERN Renderer: informs styling
README.md - Machine Renderer → AI Agents: provides context format
README.md - MCP Retrieval → AI Agents: serves retrieval
README.md - RAG Indexer → AI Agents: grounds retrieval
README.md - Architecture Specs → ADR Governance: formalizes decisions
README.md