Skip to content

Commit 4e0819e

Browse files
unionalclaude
andcommitted
docs: group the workflow instances under the model
The model section had grown two genres: pages 1-4 are the machinery, while waterfall and the catalog are instances expressed in it as evidence, leaving Open questions stranded behind three pages it does not follow from. Nest the instances as a Formal workflows group with the catalog as its index. Kept under model/ rather than promoted top-level: these pages exist to test whether the vocabulary generalises, and a peer section would read as a product surface cyber-truss does not have. Relationship to SDD stays outside the group — it is half instance and half positioning, and its peer-versus-beneath framing is not a catalog entry. Records the rule behind the asymmetry: an entry earns a page when expressing it changes the model, and stays a row when it confirms it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 7299438 commit 4e0819e

4 files changed

Lines changed: 36 additions & 7 deletions

File tree

apps/web/astro.config.mjs

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,13 @@ export default defineConfig({
3535
{ label: 'Confluence', link: '/model/confluence/' },
3636
{ label: 'Canonical execution', link: '/model/canonical-execution/' },
3737
{ label: 'Relationship to SDD', link: '/model/relationship-to-sdd/' },
38-
{ label: 'Waterfall in the model', link: '/model/waterfall/' },
39-
{ label: 'Formal workflows', link: '/model/formal-workflows/' },
38+
{
39+
label: 'Formal workflows',
40+
items: [
41+
{ label: 'The catalog', link: '/model/workflows/' },
42+
{ label: 'Waterfall in the model', link: '/model/workflows/waterfall/' },
43+
],
44+
},
4045
{ label: 'Open questions', link: '/model/open-questions/' },
4146
],
4247
},

apps/web/src/content/docs/model/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,8 @@ documentation are raised and discharged out-of-band.
5353
| [Confluence](/cyber-truss/model/confluence/) | What path-independence means precisely, and what it is claimed over |
5454
| [Canonical execution](/cyber-truss/model/canonical-execution/) | How confluence is bought: distill, replay, compare |
5555
| [Relationship to SDD](/cyber-truss/model/relationship-to-sdd/) | SDD as the two-set instance of this model |
56-
| [Waterfall in the model](/cyber-truss/model/waterfall/) | A staged, gated process expressed here — and the half of it that turns out to be unnecessary |
57-
| [Formal workflows](/cyber-truss/model/formal-workflows/) | The same exercise across eight fields, and the four parameters they all reduce to |
56+
| [Formal workflows](/cyber-truss/model/workflows/) | Staged processes across eight fields, and the four parameters they all reduce to |
57+
| [Waterfall in the model](/cyber-truss/model/workflows/waterfall/) | One of them worked in full — and the half of it that turns out to be unnecessary |
5858
| [Open questions](/cyber-truss/model/open-questions/) | What is unresolved, and what breaks if it resolves badly |
5959

6060
## What this model is not

apps/web/src/content/docs/model/formal-workflows.md renamed to apps/web/src/content/docs/model/workflows/index.md

Lines changed: 26 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ rather than a ratified part of it. See [the model overview](/cyber-truss/model/)
1010

1111
## What a formal workflow is
1212

13-
Expressing [waterfall](/cyber-truss/model/waterfall/) produced a reusable shape. Every
13+
Expressing [waterfall](/cyber-truss/model/workflows/waterfall/) produced a reusable shape. Every
1414
staged process examined since has fit it, which makes it worth stating as a definition:
1515

1616
> A **formal workflow** is a named policy over a lattice. It fixes four things: which
@@ -29,7 +29,7 @@ it was derived from has not been tested.
2929

3030
| Workflow | Field | Sets it spans | Shape | Strain policy |
3131
| --- | --- | --- | --- | --- |
32-
| [Waterfall](/cyber-truss/model/waterfall/) | software | requirements, design, code, verification | chain | zero at every gate |
32+
| [Waterfall](/cyber-truss/model/workflows/waterfall/) | software | requirements, design, code, verification | chain | zero at every gate |
3333
| [SDD](/cyber-truss/model/relationship-to-sdd/) | software | spec unit, implementation unit | one link | zero at the impl gate |
3434
| Trunk-based development | software | code, test, docs | star on `{code, test}` | completeness zero at merge; obligation carried |
3535
| Safety certification | avionics, medical devices | requirements, design, code, tests, review evidence | chain, traced both ways | zero, and the *edge set itself* is an artifact |
@@ -145,6 +145,30 @@ property without the constraint.
145145
depend on this catalog. It is evidence about whether the vocabulary generalises, which
146146
was the one thing running eight instances could establish.
147147

148+
## When an entry earns its own page
149+
150+
Only [waterfall](/cyber-truss/model/workflows/waterfall/) has one, and the rule that
151+
produced that asymmetry is worth stating so the catalog does not drift into eight thin
152+
pages.
153+
154+
> An entry earns a page when expressing it **changes** the model. Entries that confirm it
155+
> stay rows.
156+
157+
Waterfall changed it: the four-parameter definition at the top of this page came out of
158+
that exercise, along with the phases-are-not-sets distinction and the finding about entry
159+
restrictions. The remaining six confirm — each is evidence that the vocabulary reaches a
160+
field it was not derived from, and that evidence lives in the *comparison*. Split across
161+
pages, the strain-policy column can no longer be read down, which is where the first
162+
finding below actually comes from.
163+
164+
Two are the likeliest to be promoted if pushed further. **Safety certification** treats
165+
the edge set as a deliverable in its own right, which raises a question the model has not
166+
answered — whether a connection can itself be an artifact-set. **Double-entry
167+
bookkeeping** is the smallest complete instance in the catalog, which makes it the
168+
natural first thing an implementation is tested against.
169+
170+
**Status: Settled** as this section's editorial rule. Neither promotion has been argued.
171+
148172
## What has not been tested
149173

150174
The instances here are all **staged** — they exist because someone wanted a gate. That is

apps/web/src/content/docs/model/waterfall.md renamed to apps/web/src/content/docs/model/workflows/waterfall.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -211,5 +211,5 @@ makes it worse, which is the outcome that mattered.
211211

212212
The four parameters this exercise settled on — sets, shape, discharge, strain policy —
213213
turn out to describe staged processes well outside software.
214-
[Formal workflows](/cyber-truss/model/formal-workflows/) runs the same exercise across
214+
[Formal workflows](/cyber-truss/model/workflows/) runs the same exercise across
215215
eight fields.

0 commit comments

Comments
 (0)