@drunkcoding/agents-and-skills 0.0.44 → 0.0.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/.claude-plugin/marketplace.json +2 -47
  2. package/README.md +3 -6
  3. package/package.json +4 -1
  4. package/plugins/multica-tool/.claude-plugin/plugin.json +1 -1
  5. package/plugins/multica-tool/scripts/lib.mjs +53 -4
  6. package/plugins/multica-tool/scripts/multica-export.mjs +170 -50
  7. package/plugins/multica-tool/scripts/multica-import.mjs +209 -27
  8. package/plugins/multica-tool/skills/export/SKILL.md +91 -22
  9. package/plugins/multica-tool/skills/import/SKILL.md +24 -9
  10. package/plugins/multica-tool/skills/sync/SKILL.md +1 -1
  11. package/plugins/plugin-validator/.claude-plugin/plugin.json +1 -1
  12. package/plugins/html-effectiveness/.claude-plugin/plugin.json +0 -17
  13. package/plugins/html-effectiveness/README.md +0 -28
  14. package/plugins/html-effectiveness/agents/report-builder.md +0 -66
  15. package/plugins/html-effectiveness/assets/base.css +0 -51
  16. package/plugins/html-effectiveness/assets/base.js +0 -11
  17. package/plugins/html-effectiveness/assets/charts.js +0 -1
  18. package/plugins/html-effectiveness/assets/components.css +0 -10
  19. package/plugins/html-effectiveness/commands/html-report.md +0 -13
  20. package/plugins/html-effectiveness/docs/template-gallery.md +0 -28
  21. package/plugins/html-effectiveness/package.json +0 -6
  22. package/plugins/html-effectiveness/scripts/_tmp.js +0 -37
  23. package/plugins/html-effectiveness/scripts/catalog.js +0 -47
  24. package/plugins/html-effectiveness/scripts/extract.js +0 -104
  25. package/plugins/html-effectiveness/scripts/mustache.js +0 -90
  26. package/plugins/html-effectiveness/scripts/render.js +0 -176
  27. package/plugins/html-effectiveness/skills/html-effectiveness/SKILL.md +0 -94
  28. package/plugins/html-effectiveness/templates/01-exploration-code-approaches.html.tmpl +0 -400
  29. package/plugins/html-effectiveness/templates/02-exploration-visual-designs.html.tmpl +0 -456
  30. package/plugins/html-effectiveness/templates/03-code-review-pr.html.tmpl +0 -581
  31. package/plugins/html-effectiveness/templates/04-code-understanding.html.tmpl +0 -443
  32. package/plugins/html-effectiveness/templates/05-design-system.html.tmpl +0 -578
  33. package/plugins/html-effectiveness/templates/06-component-variants.html.tmpl +0 -557
  34. package/plugins/html-effectiveness/templates/07-prototype-animation.html.tmpl +0 -417
  35. package/plugins/html-effectiveness/templates/08-prototype-interaction.html.tmpl +0 -363
  36. package/plugins/html-effectiveness/templates/09-slide-deck.html.tmpl +0 -535
  37. package/plugins/html-effectiveness/templates/10-svg-illustrations.html.tmpl +0 -444
  38. package/plugins/html-effectiveness/templates/11-status-report.html.tmpl +0 -152
  39. package/plugins/html-effectiveness/templates/12-incident-report.html.tmpl +0 -547
  40. package/plugins/html-effectiveness/templates/13-flowchart-diagram.html.tmpl +0 -361
  41. package/plugins/html-effectiveness/templates/14-research-feature-explainer.html.tmpl +0 -348
  42. package/plugins/html-effectiveness/templates/15-research-concept-explainer.html.tmpl +0 -334
  43. package/plugins/html-effectiveness/templates/16-implementation-plan.html.tmpl +0 -657
  44. package/plugins/html-effectiveness/templates/17-pr-writeup.html.tmpl +0 -553
  45. package/plugins/html-effectiveness/templates/18-editor-triage-board.html.tmpl +0 -541
  46. package/plugins/html-effectiveness/templates/19-editor-feature-flags.html.tmpl +0 -627
  47. package/plugins/html-effectiveness/templates/20-editor-prompt-tuner.html.tmpl +0 -687
  48. package/plugins/html-effectiveness/templates/manifest.json +0 -441
  49. package/plugins/team-share/.claude-plugin/plugin.json +0 -18
  50. package/plugins/team-share/README.md +0 -46
  51. package/plugins/team-share/agents/team-share.md +0 -53
  52. package/plugins/team-share/commands/team-share.md +0 -4
  53. package/plugins/team-share/skills/claude-config/SKILL.md +0 -143
  54. package/plugins/team-share/skills/codegraph-setup/SKILL.md +0 -81
  55. package/plugins/team-share/skills/understand-setup/SKILL.md +0 -115
  56. package/plugins/tech-graph/.claude-plugin/plugin.json +0 -17
  57. package/plugins/tech-graph/README.md +0 -66
  58. package/plugins/tech-graph/agents/tech-graph.md +0 -97
  59. package/plugins/tech-graph/commands/tech-graph.md +0 -13
  60. package/plugins/tech-graph/scripts/check-deps.sh +0 -55
  61. package/plugins/tech-graph/skills/tech-graph/LICENSE +0 -21
  62. package/plugins/tech-graph/skills/tech-graph/README.md +0 -555
  63. package/plugins/tech-graph/skills/tech-graph/README.zh.md +0 -514
  64. package/plugins/tech-graph/skills/tech-graph/SKILL.md +0 -263
  65. package/plugins/tech-graph/skills/tech-graph/agents/openai.yaml +0 -4
  66. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style1-flat.png +0 -0
  67. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style2-dark.png +0 -0
  68. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style3-blueprint.png +0 -0
  69. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style4-notion.png +0 -0
  70. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style5-glass.png +0 -0
  71. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style6-claude.png +0 -0
  72. package/plugins/tech-graph/skills/tech-graph/assets/samples/sample-style7-openai.png +0 -0
  73. package/plugins/tech-graph/skills/tech-graph/fixtures/agent-memory-types-style4.json +0 -181
  74. package/plugins/tech-graph/skills/tech-graph/fixtures/api-flow-style7.json +0 -40
  75. package/plugins/tech-graph/skills/tech-graph/fixtures/mem0-style1.json +0 -297
  76. package/plugins/tech-graph/skills/tech-graph/fixtures/microservices-style3.json +0 -64
  77. package/plugins/tech-graph/skills/tech-graph/fixtures/multi-agent-style5.json +0 -45
  78. package/plugins/tech-graph/skills/tech-graph/fixtures/system-architecture-style6.json +0 -48
  79. package/plugins/tech-graph/skills/tech-graph/fixtures/tool-call-style2.json +0 -182
  80. package/plugins/tech-graph/skills/tech-graph/package.json +0 -42
  81. package/plugins/tech-graph/skills/tech-graph/references/diagram-types.md +0 -171
  82. package/plugins/tech-graph/skills/tech-graph/references/icons.md +0 -406
  83. package/plugins/tech-graph/skills/tech-graph/references/style-1-flat-icon.md +0 -108
  84. package/plugins/tech-graph/skills/tech-graph/references/style-2-dark-terminal.md +0 -107
  85. package/plugins/tech-graph/skills/tech-graph/references/style-3-blueprint.md +0 -113
  86. package/plugins/tech-graph/skills/tech-graph/references/style-4-notion-clean.md +0 -95
  87. package/plugins/tech-graph/skills/tech-graph/references/style-5-glassmorphism.md +0 -125
  88. package/plugins/tech-graph/skills/tech-graph/references/style-6-claude-official.md +0 -209
  89. package/plugins/tech-graph/skills/tech-graph/references/style-7-openai.md +0 -215
  90. package/plugins/tech-graph/skills/tech-graph/references/style-diagram-matrix.md +0 -135
  91. package/plugins/tech-graph/skills/tech-graph/references/svg-layout-best-practices.md +0 -100
  92. package/plugins/tech-graph/skills/tech-graph/references/svg-to-png.md +0 -115
  93. package/plugins/tech-graph/skills/tech-graph/scripts/README.md +0 -269
  94. package/plugins/tech-graph/skills/tech-graph/scripts/generate-diagram.sh +0 -181
  95. package/plugins/tech-graph/skills/tech-graph/scripts/generate-from-template.py +0 -1587
  96. package/plugins/tech-graph/skills/tech-graph/scripts/test-all-styles.sh +0 -143
  97. package/plugins/tech-graph/skills/tech-graph/scripts/validate-svg.sh +0 -306
  98. package/plugins/tech-graph/skills/tech-graph/templates/agent-architecture.svg +0 -28
  99. package/plugins/tech-graph/skills/tech-graph/templates/architecture.svg +0 -23
  100. package/plugins/tech-graph/skills/tech-graph/templates/comparison-matrix.svg +0 -14
  101. package/plugins/tech-graph/skills/tech-graph/templates/data-flow.svg +0 -28
  102. package/plugins/tech-graph/skills/tech-graph/templates/er-diagram.svg +0 -21
  103. package/plugins/tech-graph/skills/tech-graph/templates/flowchart.svg +0 -21
  104. package/plugins/tech-graph/skills/tech-graph/templates/sequence.svg +0 -20
  105. package/plugins/tech-graph/skills/tech-graph/templates/state-machine.svg +0 -20
  106. package/plugins/tech-graph/skills/tech-graph/templates/timeline.svg +0 -19
  107. package/plugins/tech-graph/skills/tech-graph/templates/use-case.svg +0 -21
@@ -1,42 +0,0 @@
1
- {
2
- "name": "@yizhiyanhua-ai/fireworks-tech-graph",
3
- "version": "1.0.4",
4
- "description": "Generate production-quality SVG technical diagrams (architecture, flowchart, UML, ER, sequence, etc.) with 7 built-in styles. Export as SVG+PNG via cairosvg (recommended), with rsvg-convert and puppeteer as alternatives.",
5
- "main": "SKILL.md",
6
- "keywords": [
7
- "claude-code",
8
- "skill",
9
- "diagram",
10
- "svg",
11
- "architecture",
12
- "flowchart",
13
- "uml",
14
- "sequence-diagram",
15
- "er-diagram",
16
- "visualization"
17
- ],
18
- "author": "yizhiyanhua-ai",
19
- "license": "MIT",
20
- "repository": {
21
- "type": "git",
22
- "url": "git+https://github.com/yizhiyanhua-ai/fireworks-tech-graph.git"
23
- },
24
- "bugs": {
25
- "url": "https://github.com/yizhiyanhua-ai/fireworks-tech-graph/issues"
26
- },
27
- "homepage": "https://github.com/yizhiyanhua-ai/fireworks-tech-graph#readme",
28
- "files": [
29
- "SKILL.md",
30
- "README.md",
31
- "README.zh.md",
32
- "LICENSE",
33
- "references/",
34
- "scripts/",
35
- "fixtures/",
36
- "templates/",
37
- "assets/"
38
- ],
39
- "engines": {
40
- "node": ">=14.0.0"
41
- }
42
- }
@@ -1,171 +0,0 @@
1
- # Diagram Types & Layout Rules
2
-
3
- ## Architecture Diagram
4
- Nodes = services/components. Group into **horizontal layers** (top→bottom or left→right).
5
- - Typical layers: Client → Gateway/LB → Services → Data/Storage
6
- - Use `<rect>` dashed containers to group related services in the same layer
7
- - Arrow direction follows data/request flow
8
- - ViewBox: `0 0 960 600` standard, `0 0 960 800` for tall stacks
9
-
10
- ## Data Flow Diagram
11
- Emphasizes **what data moves where**. Focus on data transformation.
12
- - Label every arrow with the data type (e.g., "embeddings", "query", "context")
13
- - Use wider arrows (`stroke-width: 2.5`) for primary data paths
14
- - Dashed arrows for control/trigger flows
15
- - Color arrows by data category (not just Agent/RAG — use semantics)
16
-
17
- ## Flowchart / Process Flow
18
- Sequential decision/process steps.
19
- - Top-to-bottom preferred; left-to-right for wide flows
20
- - Diamond shapes for decisions, rounded rects for processes, parallelograms for I/O
21
- - Keep node labels short (≤3 words); put detail in sub-labels
22
- - Align nodes on a grid: x positions snap to 120px intervals, y to 80px
23
-
24
- ## Agent Architecture Diagram
25
- Shows how an AI agent reasons, uses tools, and manages memory.
26
- Key conceptual layers to always consider:
27
- - **Input layer**: User, query, trigger
28
- - **Agent core**: LLM, reasoning loop, planner
29
- - **Memory layer**: Short-term (context window), Long-term (vector/graph DB), Episodic
30
- - **Tool layer**: Tool calls, APIs, search, code execution
31
- - **Output layer**: Response, action, side-effects
32
- Use cyclic arrows (loop arcs) to show iterative reasoning. Separate memory types visually.
33
-
34
- ## Memory Architecture Diagram (Mem0, MemGPT-style)
35
- Specialized agent diagram focused on memory operations.
36
- - Show memory **write path** and **read path** separately (different arrow colors)
37
- - Memory tiers: Working Memory → Short-term → Long-term → External Store
38
- - Label memory operations: `store()`, `retrieve()`, `forget()`, `consolidate()`
39
- - Use stacked rects or layered cylinders for storage tiers
40
-
41
- ## Sequence Diagram
42
- Time-ordered message exchanges between participants.
43
- - Participants as vertical **lifelines** (top labels + vertical dashed lines)
44
- - Messages as horizontal arrows between lifelines, top-to-bottom time order
45
- - Activation boxes (thin filled rects on lifeline) show active processing
46
- - Group with `<rect>` loop/alt frames with label in top-left corner
47
- - ViewBox height = 80 + (num_messages × 50)
48
-
49
- ## Comparison / Feature Matrix
50
- Side-by-side comparison of approaches, systems, or components.
51
- - Column headers = systems, row headers = attributes
52
- - Row height: 40px; column width: min 120px; header row height: 50px
53
- - Checked cell: tinted background (e.g. `#dcfce7`) + `✓` checkmark; unsupported: `#f9fafb` fill
54
- - Alternating row fills (`#f9fafb` / `#ffffff`) for readability
55
- - Max readable columns: 5; beyond that, split into two diagrams
56
-
57
- ## Timeline / Gantt
58
- Horizontal time axis showing durations, phases, and milestones.
59
- - X-axis = time (weeks/months/quarters); Y-axis = items/tasks/phases
60
- - Bars: rounded rects, colored by category, labeled inside or beside
61
- - Milestone markers: diamond or filled circle at specific x position with label above
62
- - ViewBox: `0 0 960 400` typical; wider for many time periods: `0 0 1200 400`
63
-
64
- ## Mind Map / Concept Map
65
- Radial layout from central concept.
66
- - Central node at `cx=480, cy=280`
67
- - First-level branches: evenly distributed around center (360/N degrees)
68
- - Second-level branches: branch off first-level at 30-45° offset
69
- - Use curved `<path>` with cubic bezier for branches, not straight lines
70
-
71
- ## Class Diagram (UML)
72
- Static structure showing classes, attributes, methods, and relationships.
73
- - **Class box**: 3-compartment rect (name / attributes / methods), min width 160px
74
- - Top compartment: class name, bold, centered (abstract = *italic*)
75
- - Middle: attributes with visibility (`+` public, `-` private, `#` protected)
76
- - Bottom: method signatures, same visibility notation
77
- - **Relationships**:
78
- - Inheritance (extends): solid line + hollow triangle arrowhead, child → parent
79
- - Implementation (interface): dashed line + hollow triangle, class → interface
80
- - Association: solid line + open arrowhead, label with multiplicity (1, 0..*, 1..*)
81
- - Aggregation: solid line + hollow diamond on container side
82
- - Composition: solid line + filled diamond on container side
83
- - Dependency: dashed line + open arrowhead
84
- - **Interface**: `<<interface>>` stereotype above name, or circle/lollipop notation
85
- - **Enum**: compartment rect with `<<enumeration>>` stereotype, values in bottom
86
- - Layout: parent classes top, children below; interfaces to the left/right of implementors
87
- - ViewBox: `0 0 960 600` standard; `0 0 960 800` for deep hierarchies
88
-
89
- ## Use Case Diagram (UML)
90
- System functionality from user perspective.
91
- - **Actor**: stick figure (circle head + body line) placed outside system boundary
92
- - Label below figure, 13-14px
93
- - Primary actors on left, secondary/supporting on right
94
- - **Use case**: ellipse with label centered inside, min 140×60px
95
- - Keep names verb phrases: "Create Order", "Process Payment"
96
- - **System boundary**: large rect with dashed border + system name in top-left
97
- - **Relationships**:
98
- - Include: dashed arrow `<<include>>` from base to included use case
99
- - Extend: dashed arrow `<<extend>>` from extension to base use case
100
- - Generalization: solid line + hollow triangle (specialized → general)
101
- - Layout: system boundary centered, actors outside, use cases inside
102
- - ViewBox: `0 0 960 600` standard
103
-
104
- ## State Machine Diagram (UML)
105
- Lifecycle states and transitions of an entity.
106
- - **State**: rounded rect with state name, min 120×50px
107
- - Internal activities: small text `entry/ action`, `exit/ action`, `do/ activity`
108
- - **Initial state**: filled black circle (r=8), one outgoing arrow
109
- - **Final state**: filled circle (r=8) inside hollow circle (r=12)
110
- - **Choice**: small hollow diamond, guard labels on outgoing arrows `[condition]`
111
- - **Transition**: arrow with optional label `event [guard] / action`
112
- - Guard conditions in square brackets
113
- - Actions after `/`
114
- - **Composite/nested state**: larger rect containing sub-states, with name tab
115
- - **Fork/join**: thick horizontal or vertical black bar (synchronization)
116
- - Layout: initial state top-left, final state bottom-right, flow top-to-bottom
117
- - ViewBox: `0 0 960 600` standard
118
-
119
- ## ER Diagram (Entity-Relationship)
120
- Database schema and data relationships.
121
- - **Entity**: rect with entity name in header (bold), attributes below
122
- - Primary key attribute: underlined
123
- - Foreign key: italic or marked with (FK)
124
- - Min width: 160px; attribute font-size: 12px
125
- - **Relationship**: diamond shape on connecting line
126
- - Label inside diamond: "has", "belongs to", "enrolls in"
127
- - Cardinality labels near entity: `1`, `N`, `0..1`, `0..*`, `1..*`
128
- - **Weak entity**: double-bordered rect with double diamond relationship
129
- - **Associative entity**: diamond + rect hybrid (rect with diamond inside)
130
- - Line style: solid for identifying relationships, dashed for non-identifying
131
- - Layout: entities in 2-3 rows, relationships between related entities
132
- - ViewBox: `0 0 960 600` standard; wider `0 0 1200 600` for many entities
133
-
134
- ## Network Topology
135
- Physical or logical network infrastructure.
136
- - **Devices**: icon-like rects or rounded rects
137
- - Router: circle with cross arrows
138
- - Switch: rect with arrow grid
139
- - Server: stacked rect (rack icon)
140
- - Firewall: brick-pattern rect or shield shape
141
- - Load Balancer: horizontal split rect with arrows
142
- - Cloud: cloud path (overlapping arcs)
143
- - **Connections**: lines between device centers
144
- - Ethernet/wired: solid line, label bandwidth
145
- - Wireless: dashed line with WiFi symbol
146
- - VPN: dashed line with lock icon
147
- - **Subnets/Zones**: dashed rect containers with zone label (DMZ, Internal, External)
148
- - **Labels**: device hostname + IP below, 12-13px
149
- - Layout: tiered top-to-bottom (Internet → Edge → Core → Access → Endpoints)
150
- - ViewBox: `0 0 960 600` standard
151
-
152
- ## UML Coverage Map
153
-
154
- Full mapping of UML 14 diagram types to supported diagram types:
155
-
156
- | UML Diagram | Supported As | Notes |
157
- |-------------|-------------|-------|
158
- | Class | Class Diagram | Full UML notation |
159
- | Component | Architecture Diagram | Use colored fills per component type |
160
- | Deployment | Architecture Diagram | Add node/instance labels |
161
- | Package | Architecture Diagram | Use dashed grouping containers |
162
- | Composite Structure | Architecture Diagram | Nested rects within components |
163
- | Object | Class Diagram | Instance boxes with underlined name |
164
- | Use Case | Use Case Diagram | Full actor/ellipse/relationship |
165
- | Activity | Flowchart / Process Flow | Add fork/join bars |
166
- | State Machine | State Machine Diagram | Full UML notation |
167
- | Sequence | Sequence Diagram | Add alt/opt/loop frames |
168
- | Communication | — | Approximate with Sequence (swap axes) |
169
- | Timing | Timeline | Adapt time axis |
170
- | Interaction Overview | Flowchart | Combine activity + sequence fragments |
171
- | ER Diagram | ER Diagram | Chen/Crow's foot notation |
@@ -1,406 +0,0 @@
1
- # Icon Reference
2
-
3
- ## Rules for Renderer Compatibility (cairosvg / rsvg-convert)
4
-
5
- **Never use** `@import url()` for icon fonts — neither cairosvg nor rsvg-convert fetches external resources.
6
- **Always use** inline SVG `<path>`, `<circle>`, `<rect>`, `<text>` combinations.
7
- **Font fallback**: embed font-family in `<style>` using system fonts only.
8
-
9
- ---
10
-
11
- ## Generic Semantic Shapes (No product — use these first)
12
-
13
- ### Database / Vector Store (cylinder)
14
- ```xml
15
- <!-- cx=center-x, top=top-y, w=width, h=height -->
16
- <!-- Typical: w=80, h=70 -->
17
- <ellipse cx="cx" cy="top" rx="w/2" ry="w/6" fill="fill" stroke="stroke" stroke-width="1.5"/>
18
- <rect x="cx-w/2" y="top" width="w" height="h" fill="fill" stroke="none"/>
19
- <line x1="cx-w/2" y1="top" x2="cx-w/2" y2="top+h" stroke="stroke" stroke-width="1.5"/>
20
- <line x1="cx+w/2" y1="top" x2="cx+w/2" y2="top+h" stroke="stroke" stroke-width="1.5"/>
21
- <!-- Optional inner rings for Vector Store -->
22
- <ellipse cx="cx" cy="top+h*0.33" rx="w/2" ry="w/6" fill="none" stroke="stroke" stroke-width="0.7" opacity="0.5"/>
23
- <ellipse cx="cx" cy="top+h*0.66" rx="w/2" ry="w/6" fill="none" stroke="stroke" stroke-width="0.7" opacity="0.5"/>
24
- <ellipse cx="cx" cy="top+h" rx="w/2" ry="w/6" fill="fill-dark" stroke="stroke" stroke-width="1.5"/>
25
- ```
26
-
27
- ### LLM / Model Node (rounded rect with spark)
28
- ```xml
29
- <!-- Rounded rect with double border = "intelligent" signal -->
30
- <rect x="x" y="y" width="w" height="h" rx="10" fill="fill" stroke="stroke-outer" stroke-width="2.5"/>
31
- <rect x="x+3" y="y+3" width="w-6" height="h-6" rx="8" fill="none" stroke="stroke-inner" stroke-width="0.8" opacity="0.5"/>
32
- <!-- Spark icon (⚡) as text or small lightning path -->
33
- <text x="cx" y="cy-6" text-anchor="middle" font-size="14">⚡</text>
34
- <text x="cx" y="cy+10" text-anchor="middle" fill="text-color" font-size="13" font-weight="600">GPT-4o</text>
35
- ```
36
-
37
- ### Agent / Orchestrator (hexagon)
38
- ```xml
39
- <!-- r = circumradius, cx/cy = center -->
40
- <!-- For r=36: points at 36,0 18,31.2 -18,31.2 -36,0 -18,-31.2 18,-31.2 -->
41
- <polygon points="cx,cy-r cx+r*0.866,cy-r*0.5 cx+r*0.866,cy+r*0.5 cx,cy+r cx-r*0.866,cy+r*0.5 cx-r*0.866,cy-r*0.5"
42
- fill="fill" stroke="stroke" stroke-width="1.5"/>
43
- <text x="cx" y="cy+5" text-anchor="middle" fill="text" font-size="12" font-weight="600">Agent</text>
44
- ```
45
-
46
- ### Memory Node (short-term, dashed border)
47
- ```xml
48
- <rect x="x" y="y" width="w" height="h" rx="8"
49
- fill="fill" stroke="stroke" stroke-width="1.5" stroke-dasharray="6,3"/>
50
- <text x="cx" y="cy-6" text-anchor="middle" fill="text" font-size="10" opacity="0.7">MEMORY</text>
51
- <text x="cx" y="cy+8" text-anchor="middle" fill="text" font-size="13">Short-term</text>
52
- ```
53
-
54
- ### Tool / Function Call (rect with gear symbol)
55
- ```xml
56
- <rect x="x" y="y" width="w" height="h" rx="6" fill="fill" stroke="stroke" stroke-width="1.5"/>
57
- <!-- Gear: simplified as ⚙ unicode or small circle with lines -->
58
- <text x="cx" y="cy-4" text-anchor="middle" font-size="16">⚙</text>
59
- <text x="cx" y="cy+12" text-anchor="middle" fill="text" font-size="12">Tool Name</text>
60
- ```
61
-
62
- ### Queue / Stream (horizontal pipe)
63
- ```xml
64
- <!-- Pipe tube: left cap ellipse + body + right cap ellipse -->
65
- <ellipse cx="x1" cy="cy" rx="ry*0.6" ry="ry" fill="fill-dark" stroke="stroke" stroke-width="1.5"/>
66
- <rect x="x1" y="cy-ry" width="x2-x1" height="ry*2" fill="fill" stroke="none"/>
67
- <line x1="x1" y1="cy-ry" x2="x2" y2="cy-ry" stroke="stroke" stroke-width="1.5"/>
68
- <line x1="x1" y1="cy+ry" x2="x2" y2="cy+ry" stroke="stroke" stroke-width="1.5"/>
69
- <ellipse cx="x2" cy="cy" rx="ry*0.6" ry="ry" fill="fill-light" stroke="stroke" stroke-width="1.5"/>
70
- ```
71
-
72
- ### User / Human Actor
73
- ```xml
74
- <!-- Head -->
75
- <circle cx="cx" cy="cy-18" r="10" fill="fill" stroke="stroke" stroke-width="1.2"/>
76
- <!-- Body / shoulders -->
77
- <path d="M cx-14,cy+16 Q cx-14,cy-4 cx,cy-4 Q cx+14,cy-4 cx+14,cy+16"
78
- fill="fill" stroke="stroke" stroke-width="1.2"/>
79
- <text x="cx" y="cy+30" text-anchor="middle" fill="text" font-size="12">User</text>
80
- ```
81
-
82
- ### API Gateway (hexagon, single border, smaller)
83
- ```xml
84
- <polygon points="cx,cy-28 cx+24,cy-14 cx+24,cy+14 cx,cy+28 cx-24,cy+14 cx-24,cy-14"
85
- fill="fill" stroke="stroke" stroke-width="1.5"/>
86
- <text x="cx" y="cy+5" text-anchor="middle" fill="text" font-size="11">API</text>
87
- ```
88
-
89
- ### Browser / Web Client
90
- ```xml
91
- <rect x="x" y="y" width="w" height="h" rx="6" fill="fill" stroke="stroke" stroke-width="1.5"/>
92
- <!-- Title bar -->
93
- <rect x="x" y="y" width="w" height="20" rx="6" fill="fill-dark" stroke="none"/>
94
- <rect x="x" y="y+14" width="w" height="6" fill="fill-dark"/>
95
- <!-- Traffic light dots -->
96
- <circle cx="x+12" cy="y+10" r="4" fill="#ef4444" opacity="0.8"/>
97
- <circle cx="x+24" cy="y+10" r="4" fill="#f59e0b" opacity="0.8"/>
98
- <circle cx="x+36" cy="y+10" r="4" fill="#10b981" opacity="0.8"/>
99
- ```
100
-
101
- ### Document / File
102
- ```xml
103
- <!-- Folded corner rectangle -->
104
- <path d="M x,y L x+w-12,y L x+w,y+12 L x+w,y+h L x,y+h Z"
105
- fill="fill" stroke="stroke" stroke-width="1.5"/>
106
- <!-- Fold -->
107
- <path d="M x+w-12,y L x+w-12,y+12 L x+w,y+12" fill="fill-dark" stroke="stroke" stroke-width="1"/>
108
- <!-- Lines inside -->
109
- <line x1="x+8" y1="y+h*0.45" x2="x+w-8" y2="y+h*0.45" stroke="stroke" stroke-width="1" opacity="0.5"/>
110
- <line x1="x+8" y1="y+h*0.6" x2="x+w-8" y2="y+h*0.6" stroke="stroke" stroke-width="1" opacity="0.5"/>
111
- <line x1="x+8" y1="y+h*0.75" x2="x+w-16" y2="y+h*0.75" stroke="stroke" stroke-width="1" opacity="0.5"/>
112
- ```
113
-
114
- ### Decision Diamond (flowcharts)
115
- ```xml
116
- <!-- cx/cy = center, hw = half-width, hh = half-height -->
117
- <polygon points="cx,cy-hh cx+hw,cy cx,cy+hh cx-hw,cy"
118
- fill="fill" stroke="stroke" stroke-width="1.5"/>
119
- <text x="cx" y="cy+5" text-anchor="middle" fill="text" font-size="12">Condition?</text>
120
- ```
121
-
122
- ### Swim Lane Container
123
- ```xml
124
- <!-- Background band for a layer/group -->
125
- <rect x="x" y="y" width="w" height="h" rx="6"
126
- fill="fill" fill-opacity="0.04" stroke="stroke" stroke-width="1" stroke-dasharray="6,4"/>
127
- <!-- Layer label top-left -->
128
- <text x="x+12" y="y+16" fill="label-color" font-size="10" font-weight="600" letter-spacing="0.06em">LAYER NAME</text>
129
- ```
130
-
131
- ---
132
-
133
- ## Product Icons (Brand Colors + Inline SVG)
134
-
135
- All use circle badge + text abbreviation pattern. Replace `cx`, `cy` with actual coordinates.
136
-
137
- ### AI / ML Products
138
-
139
- | Product | Color | Badge Text |
140
- |---------|-------|-----------|
141
- | OpenAI / ChatGPT | `#10A37F` | `OAI` |
142
- | Anthropic / Claude | `#D97757` | `Claude` |
143
- | Google Gemini | `#4285F4` | `Gemini` |
144
- | Meta LLaMA | `#0467DF` | `LLaMA` |
145
- | Mistral | `#FF7000` | `Mistral` |
146
- | Cohere | `#39594D` | `Cohere` |
147
- | Groq | `#F55036` | `Groq` |
148
- | Together AI | `#6366F1` | `Together` |
149
- | Replicate | `#191919` | `Rep` |
150
- | Hugging Face | `#FFD21E` (text dark) | `HF` |
151
-
152
- **Template:**
153
- ```xml
154
- <circle cx="cx" cy="cy" r="22" fill="BRAND_COLOR"/>
155
- <text x="cx" y="cy+5" text-anchor="middle" fill="white"
156
- font-size="10" font-weight="700" font-family="Helvetica">BADGE_TEXT</text>
157
- <!-- Optional: outer ring for "AI" products -->
158
- <circle cx="cx" cy="cy" r="24" fill="none" stroke="BRAND_COLOR" stroke-width="1" opacity="0.4"/>
159
- ```
160
-
161
- ### AI Memory & RAG Products
162
-
163
- | Product | Color | Badge |
164
- |---------|-------|-------|
165
- | Mem0 | `#6366F1` | `mem0` |
166
- | LangChain | `#1C3C3C` | `🦜` or `LC` |
167
- | LlamaIndex | `#8B5CF6` | `LI` |
168
- | LangGraph | `#1C3C3C` | `LG` |
169
- | CrewAI | `#EF4444` | `Crew` |
170
- | AutoGen | `#0078D4` | `AG` |
171
- | Haystack | `#FF6D00` | `🌾` or `HS` |
172
- | DSPy | `#7C3AED` | `DSPy` |
173
-
174
- ### Vector Databases
175
-
176
- | Product | Color | Badge |
177
- |---------|-------|-------|
178
- | Pinecone | `#1C1C2E` + green | `Pine` |
179
- | Weaviate | `#FA0050` | `Wea` |
180
- | Qdrant | `#DC244C` | `Qdrant` |
181
- | Chroma | `#FF6B35` | `Chr` |
182
- | Milvus | `#00A1EA` | `Milvus` |
183
- | pgvector | `#336791` | `pgv` |
184
- | Faiss | `#0467DF` | `FAISS` |
185
-
186
- **Vector DB template (cylinder + badge):**
187
- ```xml
188
- <!-- Cylinder shape -->
189
- <ellipse cx="cx" cy="top" rx="40" ry="12" fill="FILL" stroke="STROKE" stroke-width="1.5"/>
190
- <rect x="cx-40" y="top" width="80" height="50" fill="FILL" stroke="none"/>
191
- <line x1="cx-40" y1="top" x2="cx-40" y2="top+50" stroke="STROKE" stroke-width="1.5"/>
192
- <line x1="cx+40" y1="top" x2="cx+40" y2="top+50" stroke="STROKE" stroke-width="1.5"/>
193
- <ellipse cx="cx" cy="top+50" rx="40" ry="12" fill="FILL_DARK" stroke="STROKE" stroke-width="1.5"/>
194
- <!-- Product name -->
195
- <text x="cx" y="top+30" text-anchor="middle" fill="white"
196
- font-size="11" font-weight="700">Pinecone</text>
197
- ```
198
-
199
- ### Classic Databases & Storage
200
-
201
- | Product | Color |
202
- |---------|-------|
203
- | PostgreSQL | `#336791` |
204
- | MySQL | `#4479A1` |
205
- | MongoDB | `#47A248` |
206
- | Redis | `#DC382D` |
207
- | Elasticsearch | `#005571` |
208
- | Cassandra | `#1287B1` |
209
- | Neo4j | `#008CC1` |
210
- | SQLite | `#003B57` |
211
-
212
- ### Message Queues & Streaming
213
-
214
- | Product | Color |
215
- |---------|-------|
216
- | Apache Kafka | `#231F20` |
217
- | RabbitMQ | `#FF6600` |
218
- | AWS SQS | `#FF9900` |
219
- | NATS | `#27AAE1` |
220
- | Pulsar | `#188FFF` |
221
-
222
- ### Cloud & Infra
223
-
224
- | Product | Color |
225
- |---------|-------|
226
- | AWS | `#FF9900` |
227
- | GCP | `#4285F4` |
228
- | Azure | `#0089D6` |
229
- | Cloudflare | `#F48120` |
230
- | Vercel | `#000000` |
231
- | Docker | `#2496ED` |
232
- | Kubernetes | `#326CE5` |
233
- | Terraform | `#7B42BC` |
234
- | Nginx | `#009639` |
235
- | FastAPI | `#009688` |
236
-
237
- ### Observability
238
-
239
- | Product | Color |
240
- |---------|-------|
241
- | Grafana | `#F46800` |
242
- | Prometheus | `#E6522C` |
243
- | Datadog | `#632CA6` |
244
- | LangSmith | `#1C3C3C` |
245
- | Langfuse | `#6366F1` |
246
- | Arize | `#6B48FF` |
247
-
248
- ---
249
-
250
- ## Azure Service Icons
251
-
252
- Azure brand colour: `#0089D6` (top tile / outer ring).
253
- Service-specific accents come from Microsoft's Azure icon set; use them
254
- as the inner badge fill so a glance still tells you "this is Azure".
255
-
256
- **Template (Azure tile):**
257
- ```xml
258
- <!-- Azure tile: outer rounded square in Azure blue, inner badge for the service. -->
259
- <rect x="cx-22" y="cy-22" width="44" height="44" rx="6"
260
- fill="#0089D6" stroke="none"/>
261
- <rect x="cx-19" y="cy-19" width="38" height="38" rx="4"
262
- fill="SERVICE_COLOR" stroke="none"/>
263
- <text x="cx" y="cy+5" text-anchor="middle" fill="white"
264
- font-size="9" font-weight="700" font-family="Helvetica">BADGE</text>
265
- ```
266
-
267
- ### Azure Compute
268
-
269
- | Product | Service Color | Badge |
270
- |---------|---------------|-------|
271
- | Azure Functions | `#0062AD` | `Func` |
272
- | Azure App Service | `#0072C6` | `App` |
273
- | Azure Container Apps | `#3F8624` | `ACA` |
274
- | Azure Container Instances | `#0078D4` | `ACI` |
275
- | Azure Kubernetes Service (AKS) | `#326CE5` | `AKS` |
276
- | Azure Virtual Machines | `#0078D4` | `VM` |
277
- | Azure Batch | `#0072C6` | `Batch` |
278
- | Azure Spring Apps | `#6DB33F` | `Spring` |
279
-
280
- ### Azure Data & Analytics
281
-
282
- | Product | Service Color | Badge |
283
- |---------|---------------|-------|
284
- | Azure SQL Database | `#0066A1` | `SQL` |
285
- | Azure Cosmos DB | `#3D7AB3` | `Cosmos` |
286
- | Azure Database for PostgreSQL | `#336791` | `pg` |
287
- | Azure Database for MySQL | `#4479A1` | `MySQL` |
288
- | Azure Synapse Analytics | `#0078D4` | `Syn` |
289
- | Azure Data Factory | `#0078D4` | `ADF` |
290
- | Azure Databricks | `#FF3621` | `Bricks` |
291
- | Azure Stream Analytics | `#0072C6` | `Stream` |
292
- | Azure Data Explorer (Kusto) | `#1E5180` | `Kusto` |
293
- | Azure Cache for Redis | `#DC382D` | `Redis` |
294
-
295
- ### Azure Storage
296
-
297
- | Product | Service Color | Badge |
298
- |---------|---------------|-------|
299
- | Azure Blob Storage | `#0078D4` | `Blob` |
300
- | Azure Queue Storage | `#0078D4` | `Queue` |
301
- | Azure Table Storage | `#0078D4` | `Table` |
302
- | Azure Files | `#0078D4` | `Files` |
303
- | Azure Data Lake Storage Gen2 | `#0078D4` | `Lake` |
304
-
305
- ### Azure AI
306
-
307
- | Product | Service Color | Badge |
308
- |---------|---------------|-------|
309
- | Azure OpenAI Service | `#10A37F` | `AOAI` |
310
- | Azure AI Search (Cognitive Search) | `#0078D4` | `AISrch` |
311
- | Azure AI Foundry | `#742774` | `Foundry` |
312
- | Azure Machine Learning | `#0078D4` | `AML` |
313
- | Azure AI Content Safety | `#107C10` | `Safety` |
314
- | Azure Speech / Translator | `#0078D4` | `Speech` |
315
-
316
- ### Azure Messaging & Eventing
317
-
318
- | Product | Service Color | Badge |
319
- |---------|---------------|-------|
320
- | Azure Service Bus | `#0078D4` | `SB` |
321
- | Azure Event Grid | `#0078D4` | `Grid` |
322
- | Azure Event Hubs | `#0078D4` | `Hubs` |
323
- | Azure Notification Hubs | `#0078D4` | `Notif` |
324
- | Azure SignalR Service | `#0078D4` | `SignalR` |
325
-
326
- ### Azure Networking & Edge
327
-
328
- | Product | Service Color | Badge |
329
- |---------|---------------|-------|
330
- | Azure Front Door | `#0078D4` | `AFD` |
331
- | Azure Application Gateway | `#0078D4` | `AppGW` |
332
- | Azure Load Balancer | `#0078D4` | `LB` |
333
- | Azure API Management | `#1FBA9F` | `APIM` |
334
- | Azure Virtual Network | `#0078D4` | `VNet` |
335
- | Azure Private Link | `#0078D4` | `PL` |
336
- | Azure CDN | `#0078D4` | `CDN` |
337
- | Azure DNS | `#0078D4` | `DNS` |
338
-
339
- ### Azure Identity & Security
340
-
341
- | Product | Service Color | Badge |
342
- |---------|---------------|-------|
343
- | Microsoft Entra ID (Azure AD) | `#0072C6` | `Entra` |
344
- | Azure Key Vault | `#FFB900` | `KV` |
345
- | Azure Sentinel | `#0072C6` | `Sentinel` |
346
- | Microsoft Defender for Cloud | `#0078D4` | `Defender` |
347
-
348
- ### Azure DevOps & Operations
349
-
350
- | Product | Service Color | Badge |
351
- |---------|---------------|-------|
352
- | Azure DevOps Pipelines | `#0078D4` | `Pipelines` |
353
- | GitHub Actions (Azure target) | `#181717` | `GHA` |
354
- | Azure Monitor | `#0078D4` | `Monitor` |
355
- | Application Insights | `#0072C6` | `AppI` |
356
- | Azure Log Analytics | `#0078D4` | `Logs` |
357
-
358
- ### Azure-specific shapes
359
-
360
- For diagrams that need a recognisable "Azure" visual without a service
361
- badge — e.g. a region container or a subscription boundary — use a
362
- dashed Azure-blue outline:
363
-
364
- ```xml
365
- <!-- Azure region/subscription container -->
366
- <rect x="x" y="y" width="w" height="h" rx="8"
367
- fill="#0089D6" fill-opacity="0.04"
368
- stroke="#0089D6" stroke-width="1.2" stroke-dasharray="6,4"/>
369
- <text x="x+12" y="y+16" fill="#0089D6" font-size="10"
370
- font-weight="700" letter-spacing="0.06em">AZURE • REGION NAME</text>
371
- ```
372
-
373
- ---
374
-
375
- ## Icon Sizing Guide
376
-
377
- | Context | Recommended Size | Padding |
378
- |---------|-----------------|---------|
379
- | Node badge (inside box) | 28×28px circle | 10px |
380
- | Standalone icon node | 40×40px | 16px |
381
- | Hero / central node | 56×56px | 20px |
382
- | Small inline indicator | 16×16px | 6px |
383
-
384
- ## Arrow Marker Templates
385
-
386
- ```xml
387
- <defs>
388
- <!-- Standard filled arrow -->
389
- <marker id="arrow-COLORNAME" markerWidth="10" markerHeight="7"
390
- refX="9" refY="3.5" orient="auto">
391
- <polygon points="0 0, 10 3.5, 0 7" fill="COLOR"/>
392
- </marker>
393
-
394
- <!-- Open arrow (outline only) -->
395
- <marker id="arrow-open" markerWidth="10" markerHeight="8"
396
- refX="9" refY="4" orient="auto">
397
- <path d="M 0 0 L 10 4 L 0 8" fill="none" stroke="COLOR" stroke-width="1.5"/>
398
- </marker>
399
-
400
- <!-- Circle dot (for association lines) -->
401
- <marker id="dot" markerWidth="8" markerHeight="8"
402
- refX="4" refY="4" orient="auto">
403
- <circle cx="4" cy="4" r="3" fill="COLOR"/>
404
- </marker>
405
- </defs>
406
- ```