Skip to content

Commit 3e98b10

Browse files
git-stevengit-steven
committed
HITL article
1 parent be0bbc3 commit 3e98b10

71 files changed

Lines changed: 15553 additions & 6680 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

assets/diagram/drawio-palette-guide.md renamed to _guide/diagram/drawio-palette-guide.md

File renamed without changes.

assets/diagram/drawio-palette.xml renamed to _guide/diagram/drawio-palette.xml

File renamed without changes.

‎_guide/diagram/emoji-lexicon-v6.md‎

Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
# icon-lexicon.v6.md
2+
Semantic emoji lexicon for architecture, AI systems, and technical diagrams.
3+
4+
Icons function as **semantic anchors**—a visual DSL for system design.
5+
6+
---
7+
8+
# 🧭 Design Principles
9+
10+
- Icons are **semantic, not decorative**
11+
- Prefer **one canonical meaning per icon**
12+
- Allow **composability** (e.g. ☁️ + ⚙️ = “machine in cloud”)
13+
- Separate:
14+
- **Artifact vs Action vs State**
15+
- Optimize for:
16+
- diagrams
17+
- markdown
18+
- infographics
19+
20+
---
21+
22+
# ⭐ Canonical Icons (v6)
23+
24+
| Icon | Meaning | Notes |
25+
|------|--------|------|
26+
| 📜 | **Model (ML / AI)** | ✅ Canonical — promoted |
27+
| 📦 | Software Package / Artifact | Static deliverable |
28+
| ⛴ | Ship / Deliver / Release | Human-scale shipping metaphor |
29+
| 🚀 | Deploy (system action) | Use sparingly |
30+
| 🏁 | Release Complete / Milestone | Terminal state |
31+
| ☁️ | Cloud / Infra | Combine for richer meaning |
32+
| ⚙️ | Machine / Runtime / Engine | Combine with ☁️ |
33+
| 🧠 | Learning / Intelligence | |
34+
| 🤖 | Autonomous Agent | |
35+
| 👥 | Governance / Humans | |
36+
| 🔄 | Loop / Cycle | |
37+
| ⛓️‍💥 | Broken Loop / Boundary | |
38+
| 📊 | Metrics / Observability | |
39+
| 🧬 | Training / Model evolution | |
40+
| 🧪 | Testing / Validation | |
41+
| ⚖️ | Governance / Tradeoff | |
42+
| 🚰 | Bottleneck | |
43+
| 🌊 | Flow | |
44+
| 🔗 | Dependency | |
45+
| ⛓️ | Coupling | |
46+
| 🔌 | Interface / Port | |
47+
| 🧵 | Stream / pipeline thread | |
48+
| 📣 | Event / signal emission | |
49+
50+
---
51+
52+
# 🧠 Canonical Patterns
53+
54+
## ☁️⚙️ Machine in Cloud
55+
Represents deployed runtime compute.
56+
57+
Variants:
58+
- ☁️📜 = model in cloud
59+
- ☁️⚙️ = runtime
60+
- ☁️🧠 = learning system
61+
62+
---
63+
64+
## 📦 Delivery Flow
65+
66+
📦 → ⛴ → ☁️⚙️ → 🏁
67+
68+
---
69+
70+
# 🧩 Categories
71+
72+
## Architecture
73+
🏛️ 🏢 🏦 🏰 🏚️ 🧱 🗿 🪨 ⚓
74+
75+
## Components
76+
🧩 📦 🗂️ 🔌 🔗 🧷 ⛓️ ⛓️‍💥
77+
78+
## AI / ML
79+
📜 🧠 🤖 🧬 🧪 🧫 🦠 ⚗️ ⚛️
80+
81+
## People
82+
👤 👥 🤝 🧑‍💻 🧑‍🔬 🧑‍🏫 🕵️
83+
84+
## Flow
85+
🌀 🌊 🔄 🧵 🎛️ 📣 📨 🛰️
86+
87+
## Metrics
88+
📊 📈 📉 🧾 🔍 🔎 🔬
89+
90+
## Engineering
91+
⚙️ 🧰 🛠️ 🔧 🔩 🔨
92+
93+
## Infra
94+
☁️ 🖥️ 💻 🗄️ 📡
95+
96+
## Security
97+
🛡️ 🔐 🔒 🗝️ 🪪
98+
99+
## Risk
100+
🔥 ⚡ 💥 🚨 🐞
101+
102+
## Time
103+
⏱️ ⏲ ⏳ 🕒 🕰
104+
105+
---
106+
107+
# 🧠 HITL Patterns
108+
109+
| Concept | Icon |
110+
|--------|------|
111+
| Model | 📜 |
112+
| Inference | 📜 → ⚙️ |
113+
| Runtime | ☁️⚙️ |
114+
| Feedback Loop | 🔄 |
115+
| Governance | 👥 |
116+
| Boundary | ⛓️‍💥 |
117+
| Training | 🧬 |
118+
| Autonomous | 🤖 |
119+
120+
---
121+
122+
# 🏁 Summary
123+
124+
Core mental model:
125+
126+
📦 Artifact
127+
⛴ Ship
128+
☁️⚙️ Runtime
129+
📜 Model
130+
👥 Governance
131+
⛓️‍💥 Boundary

assets/diagram/instability-3d-surface-preview.svg renamed to _guide/diagram/instability-3d-surface-preview.svg

File renamed without changes.

assets/diagram/metrics-instability.drawio.pdf renamed to _guide/diagram/metrics-instability.drawio.pdf

File renamed without changes.

‎_guide/drawio-palette-guide.md‎

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
# draw.io Architecture Icon Palette Guide
2+
3+
Purpose: create consistent visual grammar across diagrams.
4+
5+
---
6+
7+
# Core System Icons
8+
9+
| Icon | Meaning |
10+
|---|---|
11+
🧩 | service
12+
📦 | deployable artifact
13+
🔌 | API / port
14+
🔗 | dependency
15+
🗄️ | datastore
16+
📣 | event
17+
🧵 | stream
18+
📊 | metric
19+
🔥 | incident
20+
21+
---
22+
23+
# Layered Architecture
24+
25+
Presentation
26+
🖥️ UI
27+
28+
Application
29+
🧠 logic
30+
31+
Domain
32+
🧬 business rules
33+
34+
Infrastructure
35+
🗄️ persistence
36+
37+
Example
38+
39+
🖥️ UI
40+
↓
41+
🧠 Service Layer
42+
↓
43+
🧬 Domain Model
44+
↓
45+
🗄️ Database
46+
47+
---
48+
49+
# Microservice Diagram
50+
51+
🧩 Order Service
52+
🔌 REST API
53+
🗄 Orders DB
54+
55+
│
56+
│ 📣 OrderCreated
57+
▼
58+
59+
🧩 Billing Service
60+
🔌 API
61+
🗄 Ledger DB
62+
63+
---
64+
65+
# CQRS Diagram
66+
67+
📥 Command
68+
↓
69+
📣 Event
70+
↓
71+
📊 Projection
72+
73+
---
74+
75+
# DevOps Pipeline
76+
77+
commit → ⚙ build → 🧪 test → 📦 artifact → 🚀 deploy
78+
79+
---
80+
81+
# Data Pipeline
82+
83+
📥 ingest → 🧹 transform → 🗄 data lake → 📊 analytics
84+
85+
---
86+
87+
# draw.io Palette Groups
88+
89+
Architecture
90+
Services
91+
Data
92+
Messaging
93+
Pipelines
94+
Observability
95+
96+
---
97+
98+
# Design Principles
99+
100+
1. Icons represent system roles.
101+
2. Keep icon meanings consistent.
102+
3. Combine icons with short labels.
103+
4. Avoid symbol overload.

0 commit comments

Comments
 (0)