You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 69c06d2
Browse filesBrowse the repository at this point in the historyBrowse files
Root causes, all fixed:
- check-code.py TypeScript checker used a malformed npx invocation
(npm error: could not determine executable to run) and, once
fixed, pulled in DOM lib types by default, colliding with sample
classes named Notification. Now compiles against a shared scratch
project (typescript + @types/node) with --lib es2022, no DOM.
- Blocks in a file that reference a symbol defined in an earlier
same-language block (a class, then a test double for it further
down) are legitimate progressive documentation, not broken
samples. The checker now retries a failing block against every
same-language block seen so far in that file before failing it.
- Added a markdown style gate (markdownlint-cli2 0.23.2), config
tuned for a citation-heavy technical corpus: line length, bare
URLs, and ordered-list-restart rules disabled where they conflict
with continuous reference numbering across headed subsections;
everything else enforced. Fixed the 4 genuine defects it found
(missing blank lines around headings, a malformed C# heading).
Also: the pipeline script (workflows/patterns-lean.js) no longer
trusts an authoring agent's own completion claim. A real incident
during this session: an agent returned "SKIP already complete"
for a file that did not exist. Every chunk is now re-verified by a
dedicated read-only agent re-running the structural gate, and a
per-agent 30-minute timeout catches a stuck slot instead of hanging
the batch forever. Both mechanisms proven against fixtures replaying
the real failure before being trusted.
46/46 entries pass structure and prose. 197/197 code samples
compile. 0 markdown issues.
@@ -47,6 +49,7 @@ Each entry needs these dimensions, otherwise it reads as a starter catalog:
47
49
-**Citations with page/section/version/date**
48
50
49
51
**4. Padding To Cut**
52
+
50
53
-**Family 04 Design Principles** should not be a pattern family. SOLID, GRASP, CUPID, CAP, PACELC, ACID, BASE, Conway’s Law, and Postel’s Law are principles, laws, or distributed-systems constraints. Keep them as cross-reference pages, not peer entries beside GoF/EIP/PoEAA.
51
54
-**Family 18 Anti-Patterns** is valid only if anchored in Brown et al. and production failure modes. Otherwise it becomes a grab bag overlapping Code Smells and Security. Do not cut it entirely; split into **Software Anti-Patterns**, **Architecture Anti-Patterns**, **Distributed Systems Failure Patterns**, and **AI Anti-Patterns**.
Copy file name to clipboardExpand all lines: patterns/08-cloud-distributed/README.md
+8-3Lines changed: 8 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,16 +2,15 @@
2
2
3
3
Origin. Azure Architecture Center, Nygard
4
4
5
-
18 entries, 171,524 words. Every entry carries all 18
5
+
18 entries, 172,251 words. Every entry carries all 18
6
6
dimensions from [the entry contract](../../docs/ENTRY-TEMPLATE.md).
7
7
8
8
## Cloud and Distributed
9
9
10
10
| Pattern | Maturity | Words | Intent |
11
11
|---|---|---|---|
12
-
|[Cache-Aside](cache-aside.md)| canonical | 11,154| A service reads the same records far more often than it writes them, and the read path is expensive. |
12
+
|[Cache-Aside](cache-aside.md)| canonical | 11,151| A service reads the same records far more often than it writes them, and the read path is expensive. |
13
13
|[Gateway Aggregation](gateway-aggregation.md)| canonical | 7,007 | A client needs data or a decision that no single backend service owns end to end. |
14
-
|[Health Endpoint Monitoring](health-endpoint-monitoring.md)| canonical | 7,690 | A service that has crashed is easy to notice. |
15
14
|[Materialized View](materialized-view.md)| canonical | 8,521 | An application reads data far more often than it writes it, and the shape a write path needs is almost never the shape a read path wants. |
16
15
17
16
## Coordination
@@ -57,6 +56,12 @@ dimensions from [the entry contract](../../docs/ENTRY-TEMPLATE.md).
57
56
|---|---|---|---|
58
57
|[Strangler Fig](strangler-fig.md)| canonical | 10,348 | A system has been running in production for years. |
59
58
59
+
## Reliability
60
+
61
+
| Pattern | Maturity | Words | Intent |
62
+
|---|---|---|---|
63
+
|[Health Endpoint Monitoring](health-endpoint-monitoring.md)| canonical | 8,420 | A service running behind a load balancer, an orchestrator, or a service mesh can fail in ways that are invisible from outside the process. |
0 commit comments