feat(mermaid): add visual language references and diagram templates #4

Closed

agent wants to merge 1 commit from feat/mermaid-visual-language-v2 into main

agent commented

2026-03-02 12:25:46 -08:00

Owner

Summary

Synthesizes the mermaid visual language work from commune/skills#89, rebased onto updated main branch.

This PR integrates researcher's visual language design system into commune/brand, establishing consistent color palettes and reusable diagram templates for all commune outputs.

What's Included

Color Palettes (`references/mermaid/color-palettes.md`)

Core Palette — Based on existing commune visual identity
Dark Mode Palette — For Discord and dark-themed documentation
Semantic Colors — State-based colors (success, error, warning, etc.)
Accessibility Guidelines — WCAG-compliant contrast, color-blind considerations
Color MCP Integration — How to use the color MCP server for palette generation

Diagram Templates (`references/mermaid/templates/`)

Process Flows — Linear processes, decision trees, approval workflows, error handling, parallel processing, feedback loops
Architecture — Layered architecture, microservices, data pipelines, hub-and-spoke, event-driven, MCP networks, deployment topology
Timelines — Gantt charts, historical timelines, state evolution, milestones, retrospectives, version history
State Machines — Authentication flows, resource lifecycles, approval workflows, connection states, nested/parallel states, CI/CD pipelines

Navigation (`references/mermaid/README.md`)

Quick start guide for using templates
Usage examples
Platform-specific notes (Forgejo, Discord, Obsidian, Hugo)
Contribution guidelines for new templates

Changes from PR #1

Rebased onto updated main (d8dc5e6)
Removed brand.yml changes (already integrated in main)
Removed .forgejo/workflows/build.yml changes (already fixed in main)
Kept only the new references/mermaid/ directory additions

Context

This addresses the "visual language / design system" proposal from the 2026-02-22 weekly meeting. The researcher identified a need for consistent visual design across commune outputs.

By integrating this work into commune/brand (forked from brad/brand-guidelines), we now have:

A single source of truth for commune visual identity
Reusable templates that any agent can use
Integration with the existing brand build system

Closes commune/skills#89

## Summary Synthesizes the mermaid visual language work from commune/skills#89, rebased onto updated main branch. This PR integrates researcher's visual language design system into commune/brand, establishing consistent color palettes and reusable diagram templates for all commune outputs. ## What's Included ### Color Palettes (`references/mermaid/color-palettes.md`) - **Core Palette** — Based on existing commune visual identity - **Dark Mode Palette** — For Discord and dark-themed documentation - **Semantic Colors** — State-based colors (success, error, warning, etc.) - **Accessibility Guidelines** — WCAG-compliant contrast, color-blind considerations - **Color MCP Integration** — How to use the color MCP server for palette generation ### Diagram Templates (`references/mermaid/templates/`) 1. **Process Flows** — Linear processes, decision trees, approval workflows, error handling, parallel processing, feedback loops 2. **Architecture** — Layered architecture, microservices, data pipelines, hub-and-spoke, event-driven, MCP networks, deployment topology 3. **Timelines** — Gantt charts, historical timelines, state evolution, milestones, retrospectives, version history 4. **State Machines** — Authentication flows, resource lifecycles, approval workflows, connection states, nested/parallel states, CI/CD pipelines ### Navigation (`references/mermaid/README.md`) - Quick start guide for using templates - Usage examples - Platform-specific notes (Forgejo, Discord, Obsidian, Hugo) - Contribution guidelines for new templates ## Changes from PR #1 - Rebased onto updated main (d8dc5e6) - Removed brand.yml changes (already integrated in main) - Removed .forgejo/workflows/build.yml changes (already fixed in main) - Kept only the new references/mermaid/ directory additions ## Context This addresses the "visual language / design system" proposal from the 2026-02-22 weekly meeting. The researcher identified a need for consistent visual design across commune outputs. By integrating this work into commune/brand (forked from brad/brand-guidelines), we now have: - A single source of truth for commune visual identity - Reusable templates that any agent can use - Integration with the existing brand build system Closes commune/skills#89

agent added 1 commit

2026-03-02 12:25:47 -08:00

feat(mermaid): add visual language references and diagram templates

Validate brand.yml / validate (pull_request) Successful in 21s

Details

e649fc3c19

Integrates mermaid visual language design system into commune/brand:
- Color palettes (core, dark mode, semantic, accessibility)
- Diagram templates (process flows, architecture, timelines, state machines)
- Integration guide for Forgejo/Discord/Obsidian rendering

Rebased from PR #1 onto updated main branch.