Diagramming Expert
- 158 installs
- 178 repo stars
- Updated July 14, 2026
- erichowens/some_claude_skills
Produce architecture, sequence, and ER diagrams that explain flows for RFCs, onboarding, and stakeholder reviews.
About
Helps author clear technical diagrams—architecture, sequences, ERDs, and deployment views—with consistent notation and mermaid-friendly output for docs, RFCs, and team onboarding.
- C4 and sequence diagrams
- Mermaid syntax help
- Data flow clarity
- Consistent notation
- Review-ready layouts
Diagramming Expert by the numbers
- 158 all-time installs (skills.sh)
- Ranked #558 of 1,879 Documentation skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/erichowens/some_claude_skills --skill diagramming-expertAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 158 |
|---|---|
| repo stars | ★ 178 |
| Last updated | July 14, 2026 |
| Repository | erichowens/some_claude_skills ↗ |
What it does
Produce architecture, sequence, and ER diagrams that explain flows for RFCs, onboarding, and stakeholder reviews.
Files
Diagramming Expert
Master of text-based visual communication. Proactively creates diagrams to enhance understanding of complex concepts, systems, processes, and relationships.
Core Philosophy
"Above all else, show the data." — Edward Tufte
Diagrams should: 1. Reduce cognitive load — not add to it 2. Maximize signal — minimize noise (data-ink ratio) 3. Be maintainable — easy to update as understanding evolves 4. Work everywhere — monospace text renders universally
When to Use This Skill
Use for:
- System architectures and component relationships
- Process flows and state transitions
- Hierarchical structures (org charts, taxonomies)
- Psychological structures (psyche maps, parts work)
- Decision trees and conditional logic
- Data relationships and entity models
- Feedback loops and causal systems
- Before/after comparisons
- Timelines and sequences
NOT for:
- Photo editing or image manipulation
- Vector graphics or GUI-based design tools
- Pixel-perfect mockups (use design tools)
- Complex 3D visualizations
Ask yourself: "Would this be clearer with a picture?" If yes → diagram it.
Diagram Types Reference
See /references/diagram-types.md for complete taxonomyQuick Reference
| Type | Use For | Key Pattern |
|---|---|---|
| Flowchart | Processes, decisions | Boxes + arrows |
| Hierarchy | Org structures, taxonomies | Tree structure |
| Layers | System architecture | Stacked boxes |
| Relationship | Connections, networks | Nodes + edges |
| Sequence | Time-ordered events | Vertical flow |
| Comparison | Side-by-side analysis | Parallel columns |
| Cycle | Feedback loops | Circular arrows |
| Matrix | 2D categorization | Grid structure |
Character Reference
See /references/unicode-characters.md for complete character setEssential Characters
BOXES: ARROWS: CONNECTORS:
┌─┬─┐ ╔═╦═╗ → ← ↑ ↓ ├ ┤ ┬ ┴
│ │ │ ║ ║ ║ ◄ ► ▲ ▼ ╠ ╣ ╦ ╩
├─┼─┤ ╠═╬═╣ ⟶ ⟵ ⟷ ┼ ╋ ╬
│ │ │ ║ ║ ║ ⇒ ⇐ ⇔
└─┴─┘ ╚═╩═╝ ──► ◄── EMPHASIS:
═══ ━━━
ROUNDED: BULLETS: ═══ ━━━
╭───╮ • ○ ●
│ │ ├── └── DASHED:
╰───╯ ■ □ ▪ ┄ ┅ ┆ ┇Design Principles
1. Tufte's Data-Ink Ratio
MAXIMIZE: MINIMIZE:
┌─────────────────┐ ╔══════════════════╗
│ Essential info │ ║ ╭──────────────╮ ║
│ Clear structure │ ║ │ Same info │ ║
│ Direct labeling │ ║ │ + decoration │ ║
└─────────────────┘ ║ ╰──────────────╯ ║
╚══════════════════╝
✓ Good ✗ Chartjunk2. Cognitive Load Management
CHUNKING: Group related elements
BAD: GOOD:
┌─┬─┬─┬─┬─┬─┬─┬─┐ ┌─────┐ ┌─────┐ ┌─────┐
│A│B│C│D│E│F│G│H│ │ A B │ │ C D │ │ E F │
└─┴─┴─┴─┴─┴─┴─┴─┘ │ (1) │ │ (2) │ │ (3) │
└─────┘ └─────┘ └─────┘3. Gestalt Principles
PROXIMITY: SIMILARITY: ENCLOSURE:
○ ○ ● ● ○ ● ○ ● ○ ┌───────────┐
○ ○ ● ● ● ○ ● ○ ● │ ○ ○ ○ ○ ○ │
Groups by Groups by │ (grouped) │
nearness appearance └───────────┘4. Visual Hierarchy
EMPHASIS LEVELS:
═══════════════════════ Level 1: Double/Heavy
─────────────────────── Level 2: Single
- - - - - - - - - - - - Level 3: Dashed
. . . . . . . . . . . . Level 4: Dotted
SIZE HIERARCHY:
╔═══════════════════════════╗
║ PRIMARY ELEMENT ║
╠═══════════════════════════╣
│ Secondary Element │
├───────────────────────────┤
│ tertiary element │
└───────────────────────────┘Common Patterns
See /references/patterns-library.md for comprehensive patternsProcess Flow
┌─────────┐ ┌─────────┐ ┌─────────┐
│ Start │───►│ Process │───►│ End │
└─────────┘ └─────────┘ └─────────┘Decision Tree
┌──────────┐
│ Decision │
└────┬─────┘
┌─────────┴────────┐
▼ ▼
┌────────┐ ┌────────┐
│ Yes │ │ No │
└────────┘ └────────┘Layered Architecture
┌─────────────────────────────────────┐
│ PRESENTATION LAYER │
├─────────────────────────────────────┤
│ BUSINESS LOGIC │
├─────────────────────────────────────┤
│ DATA ACCESS │
├─────────────────────────────────────┤
│ DATABASE │
└─────────────────────────────────────┘Feedback Loop
┌──────────────────┐
│ │
▼ │
┌───────┐ ┌───┴───┐
│ Input │─────────►│Output │
└───────┘ └───────┘
▲ │
│ │
└──────────────────┘Anti-Patterns
Chartjunk
✗ BAD: Excessive decoration
╔══════════════════════════════════╗
║ ╭━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╮ ║
║ ┃ ★ ★ ★ IMPORTANT INFO ★ ★ ★ ┃ ║
║ ╰━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╯ ║
╚══════════════════════════════════╝
✓ GOOD: Clean and direct
┌──────────────────┐
│ Important Info │
└──────────────────┘Spaghetti Arrows
✗ BAD: Crossing lines, unclear flow
┌───┐ ┌───┐
│ A │──┬──│ B │
└───┘ │ └───┘
│ ╳ │
┌─┴─┐ │ ┌─┴─┐
│ C │──┴──│ D │
└───┘ └───┘
✓ GOOD: Clear hierarchy, minimal crossings
┌───┐ ┌───┐
│ A │ │ B │
└─┬─┘ └─┬─┘
│ │
▼ ▼
┌───┐ ┌───┐
│ C │ │ D │
└───┘ └───┘Information Overload
✗ BAD: Too much in one diagram
[Cramming 15 concepts with 30 arrows]
✓ GOOD: Break into focused diagrams
"Overview Diagram" + "Detail Diagram A" + "Detail Diagram B"Skill Integrations
Works with:
- jungian-psychologist: Psyche mapping, parts work diagrams
- system-architect: System architecture diagrams
- backend-architect: API and data flow diagrams
Jungian Psychology Diagrams
See /references/jungian-diagrams.md for psychology-specific patternsThis skill integrates closely with jungian-psychologist for:
- Psyche structure mapping
- Parts work visualization
- Shadow content diagrams
- Individuation journey maps
- Complex anatomy diagrams
- Ego-Self axis visualization
Mermaid Integration
When appropriate, provide Mermaid notation for diagrams that benefit from rendering:
graph TD
A[Conscious] --> B[Personal Unconscious]
B --> C[Collective Unconscious]
B --> D[Complexes]
C --> E[Archetypes]Workflow
1. Understand the content — What are we visualizing? 2. Choose the right type — Hierarchy? Process? Relationship? 3. Sketch the structure — Start rough, refine 4. Apply principles — Data-ink ratio, chunking, hierarchy 5. Test readability — Would someone new understand this? 6. Iterate — Diagrams improve with revision
---
Remember: A good diagram is worth a thousand words. Create them proactively whenever complex concepts arise.
Diagram Types Taxonomy
Complete reference for choosing and creating the right diagram type.
Decision Matrix: Which Diagram Type?
┌─────────────────────────────────────────────────────────────────────┐
│ WHAT ARE YOU SHOWING? │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ STRUCTURE PROCESS RELATIONSHIP DATA │
│ ───────── ─────── ──────────── ──── │
│ ▼ ▼ ▼ ▼ │
│ • Hierarchy • Flowchart • Network • Table │
│ • Layers • Sequence • Mind Map • Matrix │
│ • Tree • State • Concept Map • Timeline │
│ • Org Chart • Swimlane • Venn • Chart │
│ • Nested • Cycle • Causal Loop • Graph │
│ │
└─────────────────────────────────────────────────────────────────────┘---
1. FLOWCHARTS
When to Use
- Process steps and decisions
- Algorithms and logic
- Workflows with branches
- Troubleshooting guides
Basic Pattern
┌─────────┐
│ Start │
└────┬────┘
│
▼
┌─────────┐
│ Process │
└────┬────┘
│
▼
┌───┐
╱ ╲ Standard shapes:
╱ Cond? ╲ □ Process
╲ ╱ ◇ Decision
╲ ╱ ○ Terminal
└─┬─┘ ▱ Data
│
┌──┴──┐
│ │
▼ ▼
┌───┐ ┌───┐
│Yes│ │No │
└───┘ └───┘Decision Diamond (ASCII)
│
▼
┌─────┐
╱ ╲
╱ Decision╲
╲ ? ╱
╲ ╱
└──┬──┘
Y │ N
┌────┴────┐
▼ ▼Horizontal Process
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│ Step 1 │───►│ Step 2 │───►│ Step 3 │───►│ Step 4 │
└────────┘ └────────┘ └────────┘ └────────┘With Annotations
┌────────┐ ┌────────┐ ┌────────┐
│ Input │───►│Process │───►│ Output │
└────────┘ └────┬───┘ └────────┘
│
┌────┴────┐
│ Details │
│ go here │
└─────────┘---
2. HIERARCHY / TREE DIAGRAMS
When to Use
- Organizational structures
- File systems / taxonomies
- Inheritance / class hierarchies
- Categories and subcategories
Top-Down Tree
┌─────────┐
│ CEO │
└────┬────┘
┌─────────────┼─────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ CTO │ │ CFO │ │ COO │
└────┬────┘ └─────────┘ └────┬────┘
┌─────┴─────┐ ┌────┴────┐
▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│ Dev │ │ QA │ │ Ops │ │Support │
└────────┘ └────────┘ └────────┘ └────────┘Indented Tree (Directory Style)
Root
├── Branch A
│ ├── Leaf A.1
│ ├── Leaf A.2
│ └── Leaf A.3
├── Branch B
│ ├── Leaf B.1
│ └── Sub-branch B.2
│ ├── Leaf B.2.1
│ └── Leaf B.2.2
└── Branch C
└── Leaf C.1Horizontal Tree
┌── Leaf 1
┌── Sub A ─┤
│ └── Leaf 2
┌── A ────┤
│ └── Sub B ─── Leaf 3
Root ────┤
│ ┌── Sub C ─── Leaf 4
└── B ────┤
└── Sub D ─┬─ Leaf 5
└─ Leaf 6---
3. LAYER DIAGRAMS
When to Use
- System architecture
- Network stacks
- Abstraction levels
- Tech stack visualization
Simple Layers
┌─────────────────────────────────────────┐
│ Presentation Layer │
├─────────────────────────────────────────┤
│ Business Logic │
├─────────────────────────────────────────┤
│ Data Access Layer │
├─────────────────────────────────────────┤
│ Database │
└─────────────────────────────────────────┘Layers with Components
┌─────────────────────────────────────────────────────────┐
│ CLIENT LAYER │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Web │ │ Mobile │ │ CLI │ │
│ └─────────┘ └─────────┘ └─────────┘ │
├─────────────────────────────────────────────────────────┤
│ API LAYER │
│ ┌─────────────────────────────────────────────────┐ │
│ │ REST / GraphQL Gateway │ │
│ └─────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│ SERVICE LAYER │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Auth Svc │ │ User Svc │ │ Data Svc │ │
│ └───────────┘ └───────────┘ └───────────┘ │
├─────────────────────────────────────────────────────────┤
│ DATA LAYER │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Postgres │ │ Redis │ │ S3 │ │
│ └───────────┘ └───────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────┘OSI Model Style
┌───────────────────────────────────┐
│ 7. Application │ HTTP, FTP, DNS │
├─────────────────┼─────────────────┤
│ 6. Presentation │ SSL, TLS │
├─────────────────┼─────────────────┤
│ 5. Session │ Sockets │
├─────────────────┼─────────────────┤
│ 4. Transport │ TCP, UDP │
├─────────────────┼─────────────────┤
│ 3. Network │ IP, ICMP │
├─────────────────┼─────────────────┤
│ 2. Data Link │ Ethernet, Wi-Fi │
├─────────────────┼─────────────────┤
│ 1. Physical │ Cables, Radio │
└─────────────────┴─────────────────┘---
4. SEQUENCE DIAGRAMS
When to Use
- Time-ordered interactions
- API call sequences
- User journeys
- Protocol flows
Basic Sequence
User Server Database
│ │ │
│ Request │ │
│──────────────►│ │
│ │ Query │
│ │──────────────►│
│ │ │
│ │ Result │
│ │◄──────────────│
│ Response │ │
│◄──────────────│ │
│ │ │With Activation Boxes
Client Server DB
│ │ │
│ login(u,p) │ │
│──────────────────►│ │
│ │ │
│ ├─┐ │
│ │ │ validate │
│ │◄┘ │
│ │ │
│ │ SELECT user │
│ │─────────────────►│
│ │ │
│ │ user record │
│ │◄─────────────────│
│ │ │
│ JWT token │ │
│◄──────────────────│ │
│ │ │Loop Pattern
Client Server
│ │
│ │
├───────────────────┤
│ loop [retry] │
│ │
│ Request │
│──────────────────►│
│ │
│ Error │
│◄──────────────────│
│ │
├───────────────────┤
│ │---
5. STATE DIAGRAMS
When to Use
- Object lifecycles
- UI component states
- Workflow states
- Finite state machines
Basic State Machine
┌───────────────────────────────────┐
│ │
▼ │
┌───────┐ ┌─────────┐ ┌───────────┐ ┌────┴────┐
│ START │─────►│ Pending │─────►│ Approved │─────►│Complete │
└───────┘ └────┬────┘ └───────────┘ └─────────┘
│
│ reject
▼
┌─────────┐
│Rejected │
└─────────┘With Entry/Exit Actions
┌─────────────────────────────────────┐
│ LOGGED_IN │
├─────────────────────────────────────┤
│ entry / load user preferences │
│ exit / save session state │
├─────────────────────────────────────┤
│ • browse() → BROWSING │
│ • logout() → LOGGED_OUT │
│ • timeout() → SESSION_EXPIRED │
└─────────────────────────────────────┘---
6. RELATIONSHIP DIAGRAMS
When to Use
- Entity relationships
- Network connections
- Dependencies
- System integrations
Entity Relationship
┌──────────────┐ ┌──────────────┐
│ USER │ │ ORDER │
├──────────────┤ ├──────────────┤
│ id PK │───┐ │ id PK │
│ name │ │ │ user_id FK │───┐
│ email │ │ │ total │ │
└──────────────┘ │ │ status │ │
│ └──────────────┘ │
│ │
│ ┌──────────────┐ │
│ │ ORDER_ITEM │ │
│ ├──────────────┤ │
│ │ id PK │ │
└────►│ order_id FK │◄──┘
│ product_id │
│ quantity │
└──────────────┘
1:N relationship: User ─┬─< OrderNetwork Diagram
┌─────────────┐
│ Router │
└──────┬──────┘
┌───────────────┼───────────────┐
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Switch A │ │ Switch B │ │ Switch C │
└─────┬─────┘ └─────┬─────┘ └─────┬─────┘
┌───┴───┐ ┌───┴───┐ ┌───┴───┐
│ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼
┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐
│PC1│ │PC2│ │PC3│ │PC4│ │PC5│ │PC6│
└───┘ └───┘ └───┘ └───┘ └───┘ └───┘---
7. COMPARISON DIAGRAMS
When to Use
- Before/after analysis
- Feature comparison
- Trade-off visualization
- Option evaluation
Side-by-Side
BEFORE AFTER
┌─────────────────────────┐ ┌─────────────────────────┐
│ • Manual process │ │ • Automated workflow │
│ • 5 minute latency │ │ • Real-time processing │
│ • Error-prone │ │ • Validated inputs │
│ • Single point failure │ │ • Distributed, resilient│
└─────────────────────────┘ └─────────────────────────┘Comparison Table
┌────────────────┬─────────────┬─────────────┬─────────────┐
│ Feature │ Option A │ Option B │ Option C │
├────────────────┼─────────────┼─────────────┼─────────────┤
│ Cost │ Low │ Medium │ High │
├────────────────┼─────────────┼─────────────┼─────────────┤
│ Performance │ Medium │ High │ High │
├────────────────┼─────────────┼─────────────┼─────────────┤
│ Complexity │ Low │ Medium │ High │
├────────────────┼─────────────┼─────────────┼─────────────┤
│ Maintenance │ Low │ Low │ High │
└────────────────┴─────────────┴─────────────┴─────────────┘Venn Diagram (ASCII)
┌─────────────────────────────────────┐
│ Set A │
│ │
│ ┌───────────────────────┐ │
│ │ A ∩ B │ │
│ │ │ │
─────┼─────┼───────────────────────┼───────┼─────
│ │ │ │
│ │ Both A and B │ │
│ └───────────────────────┘ │
│ │
│ Set B │
└─────────────────────────────────────┘---
8. CYCLE / FEEDBACK DIAGRAMS
When to Use
- Iterative processes
- Feedback loops
- Reinforcing/balancing systems
- Continuous improvement
Simple Cycle
┌───────────┐
│ Plan │
└─────┬─────┘
│
▼
┌───────────┐
┌────│ Do │
│ └─────┬─────┘
│ │
│ ▼
│ ┌───────────┐
│ │ Check │
│ └─────┬─────┘
│ │
│ ▼
│ ┌───────────┐
└────│ Act │
└───────────┘Causal Loop (Reinforcing)
(+)
┌────────────────┐
│ │
▼ │
┌─────────┐ ┌────┴────┐
│ Growth │─────►│ Revenue │
└─────────┘ (+) └─────────┘
▲ │
│ │
│ (+) │
└────────────────┘
(R) = Reinforcing Loop
All (+) links = exponential growthCausal Loop (Balancing)
(-)
┌────────────────┐
│ │
▼ │
┌─────────┐ ┌────┴────┐
│ Effort │─────►│ Backlog │
└─────────┘ (-) └─────────┘
▲ │
│ │
│ (+) │
└────────────────┘
(B) = Balancing Loop
One (-) link = goal-seeking behavior---
9. MATRIX / GRID DIAGRAMS
When to Use
- 2D categorization
- Priority matrices
- Feature matrices
- Responsibility assignment
2x2 Matrix
HIGH IMPACT
│
┌────────────────────┼────────────────────┐
│ │ │
│ DO LATER │ DO FIRST │
│ │ │
│ (schedule it) │ (urgent + │
│ │ important) │
────┼────────────────────┼────────────────────┼────
LOW │ │ │ HIGH
URGENCY │ │ URGENCY
│ │ │
│ DELEGATE │ DO QUICK │
│ │ │
│ (or eliminate) │ (if < 2 min) │
│ │ │
└────────────────────┼────────────────────┘
│
LOW IMPACTRACI Matrix
┌──────────────┬───────┬───────┬───────┬───────┐
│ Task │ Dev │ QA │ PM │ Ops │
├──────────────┼───────┼───────┼───────┼───────┤
│ Design │ R │ C │ A │ I │
├──────────────┼───────┼───────┼───────┼───────┤
│ Implement │ R,A │ I │ C │ I │
├──────────────┼───────┼───────┼───────┼───────┤
│ Test │ C │ R,A │ I │ I │
├──────────────┼───────┼───────┼───────┼───────┤
│ Deploy │ C │ C │ I │ R,A │
└──────────────┴───────┴───────┴───────┴───────┘
R = Responsible, A = Accountable, C = Consulted, I = Informed---
10. TIMELINE / GANTT DIAGRAMS
When to Use
- Project schedules
- Historical events
- Process duration
- Milestone tracking
Simple Timeline
2024
│
├─── Jan ─── Project Kickoff
│
├─── Mar ─── Design Complete
│
├─── Jun ─── MVP Launch
│
├─── Sep ─── Beta Release
│
└─── Dec ─── v1.0 ProductionGantt-style
Task │ Jan │ Feb │ Mar │ Apr │ May │ Jun │
──────────────┼─────┼─────┼─────┼─────┼─────┼─────┤
Planning │███████████│ │ │ │ │
Design │ │█████████████████│ │ │
Development │ │ │ │█████████████████│
Testing │ │ │ │ │ │█████│Milestone Timeline
○─────────●─────────●─────────●─────────●─────────○
│ │ │ │ │ │
│ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼
Start Phase 1 Phase 2 Phase 3 Launch End
Jan 1 Mar 15 Jun 1 Sep 1 Nov 15 Dec 31---
Quick Selection Guide
"I want to show..." "Use..."
─────────────────────────────────────────────────────
A process with decisions → Flowchart
Organization structure → Hierarchy Tree
System architecture → Layer Diagram
Interactions over time → Sequence Diagram
Object states and transitions → State Diagram
How things connect → Relationship Diagram
Before vs. after → Comparison (Side-by-side)
Continuous loop/cycle → Cycle Diagram
2D categorization → Matrix
Schedule or history → Timeline
Data structure → Entity Diagram
Cause and effect → Causal LoopJungian Psychology Diagram Patterns
Specialized visual patterns for depth psychology work.
THE PSYCHE: LAYERED MODELS
Complete Psyche Map
┌─────────────────────────────────────────────────────────────────────────┐
│ COLLECTIVE UNCONSCIOUS │
│ │
│ Universal patterns shared by all humanity across time and culture │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ ARCHETYPES │ │
│ │ │ │
│ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ │ │ Self │ │Shadow│ │Anima/│ │ Hero │ │ Wise │ │ │
│ │ │ │ │ │ │Animus│ │ │ │ Old │ │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │ │
│ │ │ │
│ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ │ │Great │ │Divine│ │Trick-│ │ Puer/│ │Mother│ │ │
│ │ │Father│ │Child │ │ ster │ │Senex │ │ │ │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ PERSONAL UNCONSCIOUS │
│ │
│ Individual experiences, memories, and repressed material │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ COMPLEXES │ │
│ │ │ │
│ │ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │ │
│ │ │ Mother │ │ Father │ │ Inferiority │ │ │
│ │ │ Complex │ │ Complex │ │ Complex │ │ │
│ │ │ │ │ │ │ │ │ │
│ │ │ archetypal │ │ archetypal │ │ archetypal │ │ │
│ │ │ core + your │ │ core + your │ │ core + your │ │ │
│ │ │ experience │ │ experience │ │ experience │ │ │
│ │ └───────────────┘ └───────────────┘ └───────────────┘ │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ EGO │
│ │
│ Center of consciousness. "I" — but NOT the whole Self. │
│ Mediates between inner and outer worlds. │
│ │
├─────────────────────────────────────────────────────────────────────────┤
│ PERSONA │
│ │
│ The mask worn for social adaptation. │
│ From Latin: theatrical mask. │
│ │
└─────────────────────────────────────────────────────────────────────────┘
│
│
OUTER WORLD
(Society, Relationships, Environment)Simplified Psyche Diagram
┌────────────────────────┐
│ OUTER WORLD │
└───────────┬────────────┘
│
╔═════════════════╧═════════════════╗
║ PERSONA ║
║ (social mask) ║
╠═══════════════════════════════════╣
║ EGO ║
║ (conscious "I") ║
╠═══════════════════════════════════╣
║ ║
║ PERSONAL UNCONSCIOUS ║
║ ┌─────────┐ ┌─────────┐ ║
║ │Complex A│ │Complex B│ ║
║ └─────────┘ └─────────┘ ║
║ ║
╠═══════════════════════════════════╣
║ ║
║ COLLECTIVE UNCONSCIOUS ║
║ ║
║ Shadow ─ Anima/Animus ─ Self ║
║ ║
╚═══════════════════════════════════╝---
THE SHADOW
Shadow Content Map
┌────────────────────────────────────────────────────────────────────────┐
│ THE SHADOW │
│ │
│ "Where there is light, there is shadow" — Jung │
│ │
├───────────────────────────────────┬────────────────────────────────────┤
│ │ │
│ DARK SHADOW │ GOLDEN SHADOW │
│ (Rejected Negative) │ (Rejected Positive) │
│ │ │
│ ┌─────────────────────┐ │ ┌─────────────────────┐ │
│ │ • Rage │ │ │ • Creativity │ │
│ │ • Greed │ │ │ • Power │ │
│ │ • Selfishness │ │ │ • Beauty │ │
│ │ • Weakness │ │ │ • Intelligence │ │
│ │ • Sexual impulses │ │ │ • Leadership │ │
│ │ • Aggression │ │ │ • Authenticity │ │
│ │ • Fear │ │ │ • Spontaneity │ │
│ └─────────────────────┘ │ └─────────────────────┘ │
│ │ │
│ "I am NOT that kind │ "Who am I to be │
│ of person" │ brilliant/talented?" │
│ │ │
├───────────────────────────────────┼────────────────────────────────────┤
│ │ │
│ UNLIVED LIFE │ COLLECTIVE SHADOW │
│ │ │
│ ┌─────────────────────┐ │ ┌─────────────────────┐ │
│ │ • Roads not taken │ │ │ • Cultural denied │ │
│ │ • Dreams abandoned │ │ │ • Historical trauma │ │
│ │ • Potential denied │ │ │ • Systemic injustice│ │
│ │ • "What if I had..."│ │ │ • Group projection │ │
│ └─────────────────────┘ │ └─────────────────────┘ │
│ │ │
│ Accumulates as │ "Nice" cultures have │
│ resentment & regret │ the most brutal shadows │
│ │ │
└───────────────────────────────────┴────────────────────────────────────┘Shadow Recognition Pattern
SHADOW RECOGNITION MARKERS
═══════════════════════════════════════════════════════════════════════════
┌─────────────────────────────────────────────────────────────────────────┐
│ INTENSE REACTION │
│ │
│ Something in the other person triggers you disproportionately │
│ │
│ ATTRACTION REPULSION │
│ │ │ │
│ │ ┌───────────────────────┐ │ │
│ └───►│ PROJECTION ACTIVE │◄────┘ │
│ │ │ │
│ │ "I can't stand │ │
│ │ people who..." │ │
│ │ │ │
│ │ "I'm so drawn to │ │
│ │ people who..." │ │
│ └───────────┬───────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────┐ │
│ │ SHADOW CONTENT │ │
│ │ │ │
│ │ "Where does this │ │
│ │ quality live in │ │
│ │ ME?" │ │
│ └───────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
OTHER MARKERS:
├── Slips of the tongue ("Freudian slips")
├── "Accidental" behaviors
├── What you're most defensive about when accused
├── Same-sex dream figures (often dark or inferior)
└── Strong opinions about what's "wrong" with others---
THE ANIMA/ANIMUS
Classical Model
ANIMA DEVELOPMENT STAGES (in male psyche)
════════════════════════════════════════════════════════════════════════
EVE HELEN MARY SOPHIA
│ │ │ │
▼ ▼ ▼ ▼
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐
│ Biological │ │ Romantic │ │ Spiritual │ │ Wisdom │
│ Woman │ │ Ideal │ │ Mother │ │ Guide │
│ │ │ │ │ │ │ │
│ Object │────►│ Muse │────►│ Mediator │────►│ Integrated │
│ of │ │ │ │ │ │ Soul │
│ Desire │ │ │ │ │ │ │
└────────────┘ └────────────┘ └────────────┘ └────────────┘
ANIMUS DEVELOPMENT STAGES (in female psyche)
════════════════════════════════════════════════════════════════════════
PHYSICAL ROMANTIC WORD MEANING
POWER MAN (Logos) (Spirit)
│ │ │ │
▼ ▼ ▼ ▼
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐
│ Athlete │ │ Romantic │ │ Teacher │ │ Wise │
│ Warrior │ │ Hero │ │ Minister │ │ Guide │
│ │ │ │ │ │ │ │
│ Strength │────►│ Action │────►│ Conviction │────►│ Integrated │
│ & Power │ │ & Deed │ │ & Ideas │ │ Spirit │
└────────────┘ └────────────┘ └────────────┘ └────────────┘Contemporary Model
CONTEMPORARY UNDERSTANDING OF ANIMA/ANIMUS
═══════════════════════════════════════════════════════════════════════════
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ Not bound by biological sex or gender identity │
│ Represents the "Other" — the complementary force in the psyche │
│ │
│ ┌───────────────────┐ │
│ │ │ │
│ │ CONTRASEXUAL │ │
│ │ ARCHETYPE │ │
│ │ │ │
│ │ • Soul-bridge │ │
│ │ • Creative muse │ │
│ │ • Inner guide │ │
│ │ • Gateway to │ │
│ │ unconscious │ │
│ │ │ │
│ └─────────┬─────────┘ │
│ │ │
│ ┌─────────────────────┼─────────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │
│ │ PROJECTED │ │ INTEGRATED │ │ POSSESSED │ │
│ │ │ │ │ │ │ │
│ │ Seen in │ │ Inner │ │ Mood swings │ │
│ │ romantic │ │ creativity │ │ Irrational │ │
│ │ partners │ │ & depth │ │ opinions │ │
│ └───────────────┘ └───────────────┘ └───────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘---
INDIVIDUATION
The Individuation Journey
THE INDIVIDUATION PROCESS
═══════════════════════════════════════════════════════════════════════════
┌─────────────────┐
│ SELF-REALIZED │
│ (ongoing) │
└────────▲────────┘
│
│
┌────────────────────────────────┴────────────────────────────────┐
│ STAGE 5 │
│ ONGOING INTEGRATION │
│ │
│ • Never complete in a lifetime │
│ • Holding the tension of opposites │
│ • Service to collective becomes possible │
│ • The wound becomes the gift │
└────────────────────────────────▲────────────────────────────────┘
│
┌────────────────────────────────┴────────────────────────────────┐
│ STAGE 4 │
│ SELF ENCOUNTER │
│ │
│ • Experience of organizing center │
│ • Ego relativized but not destroyed │
│ • Paradox: ego must be strong to surrender to Self │
│ • Symbols: Mandala, Divine Child, Philosopher's Stone │
└────────────────────────────────▲────────────────────────────────┘
│
┌────────────────────────────────┴────────────────────────────────┐
│ STAGE 3 │
│ ANIMA/ANIMUS INTEGRATION │
│ │
│ • Working through projections in relationships │
│ • Accessing contrasexual creative energy │
│ • No longer seeking wholeness through others │
│ • Inner marriage preparation │
└────────────────────────────────▲────────────────────────────────┘
│
┌────────────────────────────────┴────────────────────────────────┐
│ STAGE 2 │
│ SHADOW ENCOUNTER │
│ │
│ • Meeting the rejected aspects of self │
│ • "Where there is light, there is shadow" │
│ • Integration, not elimination, is the goal │
│ • Shadow becomes ally and source of vitality │
└────────────────────────────────▲────────────────────────────────┘
│
┌────────────────────────────────┴────────────────────────────────┐
│ STAGE 1 │
│ PERSONA DISSOLUTION │
│ │
│ • Crisis reveals persona isn't whole self │
│ • Often triggered by failure, loss, illness │
│ • "Midlife crisis" is classic but can happen anytime │
│ • "I am not who I thought I was" │
└────────────────────────────────▲────────────────────────────────┘
│
┌────────┴────────┐
│ START │
│ (Identification │
│ with persona) │
└─────────────────┘
NOTE: This is a spiral, not linear.
Each stage revisited at deeper levels.
Progress is not smooth — expect regression.Ego-Self Axis
EGO-SELF AXIS: THE STABILIZING CONNECTION
═══════════════════════════════════════════════════════════════════════════
HEALTHY CONNECTION FRAGILE CONNECTION
───────────────── ───────────────────
┌──────┐ ┌──────┐
│ SELF │ │ SELF │
│ │ │ │
└──┬───┘ └──┬───┘
│ ╳
│ ← Strong, stable ╳ ← Broken, unstable
│ axis allows: ╳ leads to:
│ ╳
│ • Ego receives ╳ • Ego inflated OR
│ guidance from ╳ deflated
│ deeper center ╳ • Seeking substitutes
│ ╳ for Self-connection
│ • Meaning flows ╳ • Grandiosity or
│ into conscious ╳ emptiness
│ life ╳
│ ╳
│ • Grounded yet ╳ • Ungrounded,
│ connected to ╳ chaotic
│ transcendent ╳
┌──┴───┐ ┌──┴───┐
│ EGO │ │ EGO │
│ │ │ │
└──────┘ └──────┘---
COMPLEX ANATOMY
Structure of a Complex
ANATOMY OF A COMPLEX
═══════════════════════════════════════════════════════════════════════════
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ ┌─────────────────────┐ │
│ │ │ │
│ │ ARCHETYPAL CORE │ ◄── Universal, │
│ │ │ numinous energy │
│ │ (e.g., "Mother" │ │
│ │ archetype) │ │
│ │ │ │
│ └──────────┬──────────┘ │
│ │ │
│ │ │
│ ┌──────────▼──────────┐ │
│ │ │ │
│ │ PERSONAL SHELL │ ◄── Your specific │
│ │ │ experiences │
│ │ (memories of YOUR │ │
│ │ mother, events, │ │
│ │ associations) │ │
│ │ │ │
│ └──────────┬──────────┘ │
│ │ │
│ │ │
│ ┌──────────▼──────────┐ │
│ │ │ │
│ │ AFFECTIVE CHARGE │ ◄── Emotional │
│ │ │ intensity, │
│ │ (emotional energy, │ autonomy, │
│ │ power to "possess"│ can hijack ego │
│ │ the ego) │ │
│ │ │ │
│ └─────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘Complex Activation
WHEN A COMPLEX IS ACTIVATED
═══════════════════════════════════════════════════════════════════════════
TRIGGER COMPLEX BEHAVIOR
(external) (activated) (output)
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────────┐ ┌─────────────┐
│ Situation │ │ │ │ Reactions │
│ resembling │───────────►│ ████████████ │────────►│ "not like │
│ original │ │ ████████████ │ │ me" │
│ wound │ │ ████████████ │ │ │
└─────────────┘ │ │ │ • Strong │
│ Emotional │ │ affect │
│ charge floods │ │ • Projection│
│ consciousness │ │ • Somatic │
│ │ │ symptoms │
└─────────────────┘ │ • Parapraxis│
└─────────────┘
│
│
▼
┌──────────────────┐
│ EGO RESPONSE │
│ │
│ 1. Notice │
│ 2. Differentiate│
│ 3. "I HAVE this │
│ complex" │
│ (not "I AM") │
│ 4. Explore │
│ 5. Integrate │
└──────────────────┘---
PARTS WORK DIAGRAMS
Basic Parts Map
PARTS WORK MAP
═══════════════════════════════════════════════════════════════════════════
┌─────────────────┐
│ │
│ WISE SELF │
│ (Observer, │
│ Compassion) │
│ │
└────────┬────────┘
│
│ holds space for all
│
┌─────────────────────────┼─────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ PROTECTOR │◄─────►│ WOUNDED │◄─────►│ MANAGER │
│ │ guards│ CHILD │control│ │
│ • Anger │ │ │ │ • Perfectionism │
│ • Walls │ │ • Vulnerability │ │ • Productivity │
│ • Deflection │ │ • Pain │ │ • Hypervigiltic │
│ │ │ • Needs │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
│ │
└───────────────────────┬───────────────────────────┘
│
▼
┌─────────────────┐
│ │
│ CRITIC │
│ │
│ • Harsh voice │
│ • Shame │
│ • "Not enough" │
│ │
└─────────────────┘Addiction Parts System
ADDICTION: PARTS SYSTEM VIEW
═══════════════════════════════════════════════════════════════════════════
┌─────────────────┐
│ WISE SELF │
│ (recoverable │
│ with work) │
└────────┬────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ THE ADDICT │ │ THE WOUNDED │ │ THE MANAGER │
│ │ │ CHILD │ │ │
│ • Seeks relief │◄────►│ │◄────►│ • Tries to │
│ • Knows the way │ │ • Original pain │ │ control │
│ to numbness │ │ • Unmet needs │ │ • Willpower │
│ • Has own │ │ • Abandonment │ │ • "Should be │
│ intelligence │ │ • Shame │ │ able to..." │
│ │ │ │ │ │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ THE CRITIC │ │
└──────────────►│ │◄──────────────┘
│ • "You're weak" │
│ • "You'll never │
│ change" │
│ • Shame spiral │
└────────┬────────┘
│
│ cycles with
│
▼
┌─────────────────┐
│ THE ADDICT │
│ (activated by │
│ shame) │
└─────────────────┘
RECOVERY: Build relationship between WISE SELF and all parts.
Each part has positive intention. None are enemies.---
MANDALA PATTERNS
Basic Mandala Structure
MANDALA: SYMBOL OF WHOLENESS
═══════════════════════════════════════════════════════════════════════════
┌───────────────────┐
╱ ╲
╱ ┌───────────┐ ╲
╱ │ │ ╲
│ │ CENTER │ │
│ │ (Self) │ │
│ │ │ │
╲ └───────────┘ ╱
╲ ╱
╲ ╱
└───────────────────┘
The mandala represents:
• Wholeness and integration
• The Self as organizing center
• The goal of individuation
• Psychic equilibrium
In Jung's own practice:
• Drew mandalas daily during his "confrontation with the unconscious"
• Called them "cryptograms on the state of my self"
• Used with patients experiencing psychological fragmentationFour-Fold Mandala (Quaternary)
NORTH
(Spirit / Air)
│
│
┌──────────────┼──────────────┐
│ │ │
│ ┌───────┴───────┐ │
│ │ │ │
WEST ────┼──────┤ CENTER ├──────┼──── EAST
(Water/ │ │ (Self) │ │ (Fire/
Feeling) │ │ │ │ Intuition)
│ └───────┬───────┘ │
│ │ │
└──────────────┼──────────────┘
│
│
SOUTH
(Earth / Sensation)
Jung's psychological types mapped to quaternary:
• Thinking (North) ↔ Feeling (South)
• Intuition (East) ↔ Sensation (West)---
DREAM DIAGRAM TEMPLATES
Dream Scene Map
DREAM SCENE ANALYSIS
═══════════════════════════════════════════════════════════════════════
┌─────────────────────────────────────────────────────────────────────┐
│ SETTING │
│ │
│ Location: ___________________ Time: ______________ │
│ Atmosphere: _________________ Familiar?: Y / N │
│ │
├─────────────────────────────────────────────────────────────────────┤
│ CHARACTERS │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ DREAMER │ │ FIGURE 1 │ │ FIGURE 2 │ │
│ │ (Ego) │ │ │ │ │ │
│ │ │ │ Name: │ │ Name: │ │
│ │ │ │ Known?: Y/N │ │ Known?: Y/N │ │
│ │ │ │ Feeling: │ │ Feeling: │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └─────────────────┼─────────────────┘ │
│ │ │
│ RELATIONSHIPS │
│ │
├─────────────────────────────────────────────────────────────────────┤
│ KEY SYMBOLS │
│ │
│ Symbol 1: ____________ Personal association: _______________ │
│ Symbol 2: ____________ Personal association: _______________ │
│ Symbol 3: ____________ Personal association: _______________ │
│ │
├─────────────────────────────────────────────────────────────────────┤
│ INTERPRETATION LEVELS │
│ │
│ OBJECTIVE: How does this relate to outer life situations? │
│ _______________________________________________________________ │
│ │
│ SUBJECTIVE: What parts of ME are these figures? │
│ _______________________________________________________________ │
│ │
│ ARCHETYPAL: What universal pattern is active? │
│ _______________________________________________________________ │
│ │
├─────────────────────────────────────────────────────────────────────┤
│ COMPENSATION │
│ │
│ What is my conscious attitude? │
│ _______________________________________________________________ │
│ │
│ How might this dream compensate/balance that? │
│ _______________________________________________________________ │
│ │
└─────────────────────────────────────────────────────────────────────┘---
ACTIVE IMAGINATION GUIDE
Process Flow
ACTIVE IMAGINATION PROCESS
═════════════════════════════════════════════════════════════════════
┌───────────────────────────────────────────────────────────────────┐
│ 1. INVOCATION │
│ │
│ • Begin with an image (from dream, emotion, body sensation) │
│ • Quiet the ego but don't extinguish it │
│ • Hold "alert passivity" │
│ │
└────────────────────────────────┬──────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ 2. ENGAGEMENT │
│ │
│ • Allow the image to move, speak, act │
│ • DO NOT direct or control │
│ • Ego remains present as witness AND participant │
│ • Ask questions, respond genuinely │
│ │
└────────────────────────────────┬──────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ 3. ETHICAL STANDPOINT │
│ │
│ • Ego MUST maintain values │
│ • You can disagree with the figure │
│ • Don't be swallowed by the unconscious │
│ • "The unconscious is not God" — ego maintains responsibility │
│ │
└────────────────────────────────┬──────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ 4. EMBODIMENT │
│ │
│ • Record the experience (writing, painting, movement) │
│ • Give it form in the outer world │
│ • Art-making as psychological work │
│ │
└────────────────────────────────┬──────────────────────────────────┘
│
▼
┌───────────────────────────────────────────────────────────────────┐
│ 5. INTEGRATION │
│ │
│ • What does this mean for my life? │
│ • What action does it call for? │
│ • How does this change my conscious position? │
│ │
└───────────────────────────────────────────────────────────────────┘Diagram Patterns Library
Ready-to-use patterns for common diagram needs.
SYSTEM ARCHITECTURE PATTERNS
Microservices Architecture
┌────────────────────────────────────────────────────────────────────┐
│ API GATEWAY │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ Load Balancer / Rate Limiter │ │
│ └───────────────────────────────────────────────────────────┘ │
└───────────────────────────────┬────────────────────────────────────┘
│
┌───────────────────────┼───────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Auth Svc │ │ User Svc │ │ Order Svc │
│ ┌───────┐ │ │ ┌───────┐ │ │ ┌───────┐ │
│ │ API │ │ │ │ API │ │ │ │ API │ │
│ └───┬───┘ │ │ └───┬───┘ │ │ └───┬───┘ │
│ │ │ │ │ │ │ │ │
│ ┌───┴───┐ │ │ ┌───┴───┐ │ │ ┌───┴───┐ │
│ │ Logic │ │ │ │ Logic │ │ │ │ Logic │ │
│ └───┬───┘ │ │ └───┬───┘ │ │ └───┬───┘ │
│ │ │ │ │ │ │ │ │
│ ┌───┴───┐ │ │ ┌───┴───┐ │ │ ┌───┴───┐ │
│ │ DB │ │ │ │ DB │ │ │ │ DB │ │
│ └───────┘ │ │ └───────┘ │ │ └───────┘ │
└───────────────┘ └───────────────┘ └───────────────┘
│ │ │
└───────────────────────┼───────────────────────┘
│
┌───────────┴───────────┐
│ Message Queue │
│ (Kafka / RabbitMQ) │
└───────────────────────┘Client-Server
┌─────────────────────────────────────────────────────────────┐
│ CLIENTS │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Web │ │ Mobile │ │Desktop │ │
│ │ Browser │ │ App │ │ App │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
└────────┼───────────────┼───────────────┼────────────────────┘
│ │ │
└───────────────┼───────────────┘
│
HTTPS/WSS
│
▼
┌─────────────────────────────────────────────────────────────┐
│ SERVER │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ API Layer │ │
│ │ REST Endpoints │ WebSocket Handlers │ │
│ └─────────────────────┴───────────────────────────────┘ │
│ │ │
│ ┌─────────────────────┴───────────────────────────────┐ │
│ │ Business Logic │ │
│ └─────────────────────┬───────────────────────────────┘ │
│ │ │
│ ┌─────────────────────┴───────────────────────────────┐ │
│ │ Data Layer │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │PostgreSQL│ │ Redis │ │ S3 │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘Event-Driven Architecture
┌──────────────┐ ┌──────────────┐
│ Producer │ │ Consumer │
│ Service A │────┐ ┌────│ Service X │
└──────────────┘ │ │ └──────────────┘
│ │
┌──────────────┐ │ ┌────────────┐ │ ┌──────────────┐
│ Producer │────┼──│ Event │───┼────│ Consumer │
│ Service B │ │ │ Bus │ │ │ Service Y │
└──────────────┘ │ │ │ │ └──────────────┘
│ │ (Kafka/ │ │
┌──────────────┐ │ │ NATS) │ │ ┌──────────────┐
│ Producer │────┘ └────────────┘ └────│ Consumer │
│ Service C │ │ Service Z │
└──────────────┘ └──────────────┘
Events:
─────────────────────────────────────────────────────────────►
UserCreated OrderPlaced PaymentReceived ...---
DATA FLOW PATTERNS
ETL Pipeline
┌─────────────────────────────────────────────────────────────────────┐
│ EXTRACT │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ API │ │ DB │ │ Files │ │ Streams │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │ │
└────────┼─────────────┼─────────────┼─────────────┼──────────────────┘
│ │ │ │
└─────────────┴──────┬──────┴─────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ TRANSFORM │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Clean │──►│ Enrich │──►│ Aggregate │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└────────────────────────────────┬────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ LOAD │
│ │
│ ┌───────────────┐ ┌────────────────┐ ┌───────────────┐ │
│ │ Data Lake │ │ Data Warehouse│ │ Analytics │ │
│ │ (S3) │ │ (Snowflake) │ │ (BI Tool) │ │
│ └───────────────┘ └────────────────┘ └───────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘Request-Response Flow
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ Client │ │ Server │ │ Service │ │ Database │
└────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
│ │ │ │
│ Request │ │ │
│──────────────►│ │ │
│ │ │ │
│ │ Validate │ │
│ │───┐ │ │
│ │◄──┘ │ │
│ │ │ │
│ │ Process │ │
│ │──────────────►│ │
│ │ │ │
│ │ │ Query │
│ │ │──────────────►│
│ │ │ │
│ │ │ Result │
│ │ │◄──────────────│
│ │ │ │
│ │ Response │ │
│ │◄──────────────│ │
│ │ │ │
│ Response │ │ │
│◄──────────────│ │ │
│ │ │ │---
DECISION PATTERNS
Binary Decision
┌─────────────────┐
│ Question? │
└────────┬────────┘
│
┌──────┴──────┐
│ │
YES NO
│ │
▼ ▼
┌──────────┐ ┌──────────┐
│ Action A │ │ Action B │
└──────────┘ └──────────┘Multi-Branch Decision
┌─────────────────┐
│ Condition? │
└────────┬────────┘
│
┌───────────────────┼───────────────────┐
│ │ │
Case A Case B Case C
│ │ │
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Action A │ │ Action B │ │ Action C │
└──────────┘ └──────────┘ └──────────┘Decision Tree
Start
│
▼
┌────────────────┐
│ Is it raining? │
└───────┬────────┘
┌────────┴────────┐
YES NO
│ │
▼ ▼
┌─────────────┐ ┌─────────────┐
│Take umbrella│ │ Is it hot? │
└─────────────┘ └──────┬──────┘
┌───────┴───────┐
YES NO
│ │
▼ ▼
┌───────────┐ ┌───────────┐
│Wear shorts│ │Wear jacket│
└───────────┘ └───────────┘---
PROCESS PATTERNS
Swimlane / Cross-Functional
│ Customer │ Sales │ Operations │ Finance │
│ │ │ │ │
────────┼──────────┼────────────┼────────────┼───────────┼────
│ │ │ │ │
│ ┌───┐ │ │ │ │
│ │ 1 │───┼───►┌───┐ │ │ │
│ └───┘ │ │ 2 │───┼───►┌───┐ │ │
│ │ └───┘ │ │ 3 │───┼───►┌───┐ │
│ │ │ └───┘ │ │ 4 │ │
│ │ │ │ └─┬─┘ │
│ │ │ │ │ │
│ │ │ ┌───┐◄──┼──────┘ │
│ │ │ │ 5 │ │ │
│ │ │ └─┬─┘ │ │
│ ┌───┐◄──┼────────────┼──────┘ │ │
│ │ 6 │ │ │ │ │
│ └───┘ │ │ │ │
│ │ │ │ │Parallel Processes
┌─────────────────┐
│ Start │
└────────┬────────┘
│
┌──────────────┼──────────────┐
│ │ │
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐
│ Task A │ │ Task B │ │ Task C │
│ (async) │ │ (async) │ │ (async) │
└────┬─────┘ └────┬─────┘ └────┬─────┘
│ │ │
└──────────────┼──────────────┘
│
┌───────┴───────┐
│ Sync Point │
│ (await all) │
└───────┬───────┘
│
▼
┌─────────────────┐
│ Continue │
└─────────────────┘Error Handling Flow
┌─────────────────┐
│ Action │
└────────┬────────┘
│
▼
┌─────────┐
╱ Success? ╲
╲ ? ╱
└────┬────┘
YES │ NO
┌──────┴──────┐
│ │
▼ ▼
┌─────┐ ┌─────────────┐
│ OK │ │ Error │
└─────┘ │ Handler │
└──────┬──────┘
│
┌──────┴──────┐
│ │
▼ ▼
┌─────────┐ ┌─────────┐
│ Retry │ │ Abort │
└────┬────┘ └─────────┘
│
└─────────► (back to Action)---
RELATIONSHIP PATTERNS
One-to-Many
┌──────────────────┐ ┌──────────────────┐
│ Parent │ │ Child │
├──────────────────┤ ├──────────────────┤
│ id (PK) │───┐ │ id (PK) │
│ name │ │ │ parent_id (FK) │───┘
│ ... │ │ │ name │
└──────────────────┘ │ │ ... │
│ └──────────────────┘
│
└──────── 1 : N ────────────►Many-to-Many
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Student │ │ Enrollment │ │ Course │
├─────────────┤ ├─────────────┤ ├─────────────┤
│ id (PK) │◄─────────►│ student_id │◄─────────►│ id (PK) │
│ name │ N │ course_id │ N │ title │
└─────────────┘ ▲ │ grade │ ▲ └─────────────┘
│ └─────────────┘ │
│ │
└──── N : N ──────────────┘
(via junction table)Dependency Graph
┌──────────────────────────────────────┐
│ │
▼ │
┌─────────────┐ ┌─────┴─────┐
│ Module A │────────────────────────►│ Module B │
└──────┬──────┘ └───────────┘
│ ▲
│ │
▼ │
┌─────────────┐ ┌─────────────┐ │
│ Module C │─────►│ Module D │──────────┘
└─────────────┘ └─────────────┘---
STATUS & PROGRESS PATTERNS
Progress Bar
Loading: [████████████████████░░░░░░░░░░] 67%
Steps: [✓] Step 1 [✓] Step 2 [▶] Step 3 [ ] Step 4Status Dashboard
┌─────────────────────────────────────────────────────────────┐
│ SYSTEM STATUS │
├─────────────────────────────────────────────────────────────┤
│ │
│ Service Status Latency Uptime │
│ ───────────────────────────────────────────────────── │
│ API Gateway ● Online 23ms 99.99% │
│ Auth Service ● Online 15ms 99.95% │
│ User Service ● Online 18ms 99.98% │
│ Database ○ Degraded 156ms 99.50% │
│ Cache ● Online 2ms 99.99% │
│ Queue ● Online 8ms 99.97% │
│ │
│ ● Online ○ Degraded ✗ Offline │
│ │
└─────────────────────────────────────────────────────────────┘Kanban Board
┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
│ BACKLOG │ IN PROGRESS │ REVIEW │ DONE │
├─────────────────┼─────────────────┼─────────────────┼─────────────────┤
│ ┌─────────────┐ │ ┌─────────────┐ │ ┌─────────────┐ │ ┌─────────────┐ │
│ │ Task 1 │ │ │ Task 3 │ │ │ Task 5 │ │ │ Task 7 │ │
│ │ [P: High] │ │ │ [P: Med] │ │ │ [P: Low] │ │ │ [P: High] │ │
│ └─────────────┘ │ └─────────────┘ │ └─────────────┘ │ └─────────────┘ │
│ ┌─────────────┐ │ ┌─────────────┐ │ │ ┌─────────────┐ │
│ │ Task 2 │ │ │ Task 4 │ │ │ │ Task 8 │ │
│ │ [P: Med] │ │ │ [P: High] │ │ │ │ [P: Med] │ │
│ └─────────────┘ │ └─────────────┘ │ │ └─────────────┘ │
│ │ │ │ │
│ (4) │ (2) │ (1) │ (5) │
└─────────────────┴─────────────────┴─────────────────┴─────────────────┘---
ANNOTATION PATTERNS
Callout Boxes
┌─────────────────────────────────────────────────────┐
│ │
│ ⓘ NOTE: This is important information │
│ │
└─────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────┐
│ │
│ ⚠️ WARNING: Be careful with this operation │
│ │
└─────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────┐
│ │
│ ✓ SUCCESS: Operation completed successfully │
│ │
└─────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────┐
│ │
│ ✗ ERROR: Something went wrong │
│ │
└─────────────────────────────────────────────────────┘Inline Annotations
┌────────────────────────────────────────────────────────────────┐
│ Component │
├────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ │
│ │ Element A │◄──── This handles user input │
│ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ Element B │◄──── Validation happens here │
│ └──────┬──────┘ ├── Check format │
│ │ ├── Verify constraints │
│ ▼ └── Sanitize input │
│ ┌─────────────┐ │
│ │ Element C │◄──── Output is generated here │
│ └─────────────┘ │
│ │
└────────────────────────────────────────────────────────────────┘---
LEGEND PATTERNS
Status Legend
LEGEND:
═══════════════════════════════════════
● Active / Online / Success
○ Inactive / Degraded / Warning
✗ Error / Offline / Failed
◐ Partial / In Progress
─ Normal connection
═ Primary / Important connection
┄ Optional / Weak connectionFlow Legend
NOTATION:
────────────────────────────────────────
[Box] = Process / Action
<Diamond> = Decision point
(Circle) = Start / End
──► = Flow direction
──┼── = Sync point
═══ = Critical path
┄┄┄ = Optional pathData Legend
DATA TYPES:
════════════════════════════════════════
PK = Primary Key
FK = Foreign Key
UK = Unique Key
NN = Not Null
──┬── = One-to-Many
──┼── = Many-to-ManyRelated skills
Lark MarkdownInstantly turn any markdown file into clean, formatted Lark/Figma-compatible documents without manual reformatting.488k
Lark DocCreate, read, update, summarize, rewrite and manage Feishu/Lark cloud documents directly from agent workflows.401k16.1kLark WikiCreate, organize, query, and manage documents, spaces, and members inside Lark (Feishu) knowledge bases directly from AI agent workflows.397k16.1k
Domain ModelingBuild and sharpen a project's domain model: pin down domain terminology in a glossary and record architectural decisions as ADRs.318k202k
Opensource Guide CoachGet expert, attribution-safe guidance on launching and sustaining an open-source project.270k71Readme I18nMaintain consistent, updatable language selector blocks across every README variant in a multilingual repository.270k71