docs(arch): scaffold engineering docs and seed three rules - #70

Merged

codewizdave merged 21 commits into

stagingfrom

architecture/internal-documentation

Aug 11, 2026

Commits on Aug 11, 2026

docs(arch): scaffold engineering docs and seed three rules
claude
committed
fd6f93a
docs(arch): add rules 0004 and 0005 — code that defends and reads
claude
committed
d5a19cb
docs(arch): add rules 0006 and 0007 — assumptions and reading order
claude
committed
fad4017
docs(arch): add rules 0008-0010 — type discipline layer
claude
committed
a1996ea
docs(arch): add rule 0011 — filenames are kebab-case
claude
committed
fd2a4ac
docs(arch): enrich rules with examples and cross-references, add INDEX
claude
committed
d7aec3f
docs(arch): add rule 0012 — prefer type over interface
claude
committed
cafaf9c
docs(arch): enrich rule 0008 with bad/good pairs and a positive example
claude
committed
1662fac
docs(arch): ground rule 0008 in senior practitioner consensus
claude
committed
e5401a2
docs(arch): ground rule 0004 in senior practitioner consensus
claude
committed
e1017de
docs(arch): promote trust-the-type as the project slogan
claude
committed
00ed5d7
docs(arch): refine rule 0005 with three-category diminutive framework
claude
committed
7f5ef4d
docs(arch): add rule 0013 — entity-first naming
claude
committed
53262d9
docs(arch): tighten rule 0013 — refuse qualified suffixes too
claude
committed
79a8ef5
docs(arch): add rule 0014 — functions over classes for public API
claude
committed
71f70c2
docs(arch): add rule 0015 — domain-specific types over primitives
claude
committed
a3f4ffb
docs(arch): add Sources section to every rule
claude
committed
61206d8
docs(arch): refine rule 0015 example with named union types
claude
committed
f5eae52
docs(arch): clarify when branded types apply in rule 0015
claude
committed
9581426
docs(arch): add rule 0016 — no generic verbs
claude
committed
61da01d
docs(arch): resolve internal inconsistencies across rules 0001-0016
martyy-code
committed
5016fa3

Navigation Menu

Uh oh!

docs(arch): scaffold engineering docs and seed three rules - #70

docs(arch): scaffold engineering docs and seed three rules#70
codewizdave merged 21 commits into
stagingfrom
architecture/internal-documentation

Commits on Aug 11, 2026

docs(arch): scaffold engineering docs and seed three rules

docs(arch): add rules 0004 and 0005 — code that defends and reads

docs(arch): add rules 0006 and 0007 — assumptions and reading order

docs(arch): add rules 0008-0010 — type discipline layer

docs(arch): add rule 0011 — filenames are kebab-case

docs(arch): enrich rules with examples and cross-references, add INDEX

docs(arch): add rule 0012 — prefer type over interface

docs(arch): enrich rule 0008 with bad/good pairs and a positive example

docs(arch): ground rule 0008 in senior practitioner consensus

docs(arch): ground rule 0004 in senior practitioner consensus

docs(arch): promote trust-the-type as the project slogan

docs(arch): refine rule 0005 with three-category diminutive framework

docs(arch): add rule 0013 — entity-first naming

docs(arch): tighten rule 0013 — refuse qualified suffixes too

docs(arch): add rule 0014 — functions over classes for public API

docs(arch): add rule 0015 — domain-specific types over primitives

docs(arch): add Sources section to every rule

docs(arch): refine rule 0015 example with named union types

docs(arch): clarify when branded types apply in rule 0015

docs(arch): add rule 0016 — no generic verbs

docs(arch): resolve internal inconsistencies across rules 0001-0016