Skip to content

Commit 1a8b105

Browse files
committed
Add US House 1-2-3-4 Mermaid founding and document-order specification
1 parent e1b474b commit 1a8b105

1 file changed

Lines changed: 68 additions & 0 deletions

File tree

docs/US-HOUSE-1-2-3-4.mmd

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: "US House — 1, 2, 3, 4 Document Order"
3+
format: mermaid
4+
version: "1.0"
5+
companion: "docs/US-HOUSE-1-2-3-4.hsss"
6+
---
7+
8+
# US House — 1, 2, 3, 4
9+
10+
## Founding paragraph
11+
12+
The US House is a software-house organization for turning an idea into a traceable, usable result: **1 Origin, 2 Custody, 3 Production, 4 Release**. The order is the central improvement: every program action should have a beginning, a controlled state, an actual production record, and a separately identifiable release state. Convenience is added without losing provenance, and software operations such as installation, deletion, update, repair, and deployment remain attributable and reviewable.
13+
14+
```mermaid
15+
flowchart LR
16+
O["1 — Origin\nIdea / Request / Source"] --> C["2 — Custody\nHold / Control / Version"]
17+
C --> P["3 — Production\nBuild / Execute / Install / Update / Remove"]
18+
P --> R["4 — Release\nDeploy / Deliver / Verify"]
19+
R --> N["Next revision / next Origin"]
20+
21+
P --> W["Windows\nPowerShell / CMD"]
22+
P --> U["Ubuntu / Linux\nShell"]
23+
P --> MS["Microsoft software\npackage lifecycle"]
24+
P --> AP["Apple software\npackage lifecycle"]
25+
26+
O -.-> E["Evidence"]
27+
C -.-> E
28+
P -.-> E
29+
R -.-> E
30+
```
31+
32+
## The four documents
33+
34+
| Order | Document | Meaning | Typical evidence |
35+
|---|---|---|---|
36+
| 1 | Origin | Why and from where | request, source, proposal |
37+
| 2 | Custody | Where and under whose control | repository, package, version, hash |
38+
| 3 | Production | What actually happened | command, build, install, update, remove, test |
39+
| 4 | Release | What became available | artifact, deployment, verification |
40+
41+
## Improvement rule
42+
43+
The system improves by adding precision without breaking the order. A convenience command is still a production event; an installation is still production; a deletion is still production; an update creates a new state; and a release is not assumed merely because production succeeded.
44+
45+
## Evidence rule
46+
47+
Every important operation SHOULD be representable as:
48+
49+
`origin → custody → production → release → verification`
50+
51+
Unknown information remains explicitly unknown. A proposition remains a proposition until supported by an appropriate source or verification record.
52+
53+
## Software-house scope
54+
55+
The US House software layer can organize:
56+
57+
- Windows installation, update, removal, repair, and status operations.
58+
- Ubuntu/Linux equivalents.
59+
- Microsoft and Apple software catalog entries.
60+
- Convenience menus and command wrappers.
61+
- Source/build/deployment tracking.
62+
- Evidence and integrity records.
63+
64+
Vendor inclusion is a technical catalog decision and does not imply endorsement, ownership, or governmental affiliation.
65+
66+
## Relationship to .hsss
67+
68+
The companion `.hsss` document is the hierarchical specification. This `.mmd` document is the visual/order document. The `.hsss` explains the system; the `.mmd` makes its four-stage structure directly renderable.

0 commit comments

Comments
 (0)