ditc B3 edit-pass: app parts + scaffold + first deploy (310 + 320 + 330) #5

Merged

jsutter merged 2 commits from ditc-b3 into main

2026-09-22 05:34:01 +00:00

jsutter commented

2026-09-22 05:32:55 +00:00

Owner

B3 edit-pass per the program contracts (EDIT-PASS-template + COMMON-ditc), pages 310/320/330 sequential, one author.

Pages

310-app-parts (explanation): description sheet → the manifest everywhere; narrative metaphor struck, mechanism kept; four topic headings → claim sentences; frontmatter doc_type/requires: [your-tenant]/introduces: [working copy, repo, manifest, shape, release, "release tag"].
320-scaffold (tutorial): scaffold defined once in product terms; building-frame/skeleton metaphor struck (incl. keyword); headings → imperative; ASK callout now names all three procedure commands; requires: [app-parts, pick-tenant], introduces: [scaffold].
330-first-deploy (tutorial): git gloss added once, plainly (git, tag, push, origin); reassurance "being careful, not broken" struck, mechanism kept; all four headings → claim form; requires: [scaffold], introduces: [deploy, channel, stable, "the checks", "the runner"]. Runner auto-restore + dry-run trust content kept verbatim.

Glossary: +working copy (defined_in: app-parts), +scaffold (defined_in: scaffold).

Integration (2nd commit): 110/120 used "working copy" before its defining page — FIRST-USE/CONCEPT fail on 110:115/120:79 once 310 registers the term. Reworded to the plain description ("the copy that you and your assistant edit"); meaning unchanged; the term's first use now lands on 310 per the page map.

Gates (all green, coordinator-verified): build-docs --no-coverage --draft 0; check-prose --manual ditc clean (exit 0); check-lockstep --synthesize 0 fail (15 warn/18 skip unchanged); build-docs --draft 0; armada check-prose.sh exit 0 per page (310/320/330).

Read: the Operator reads 330 (per the batch table). Do not merge until that read lands.

B3 edit-pass per the program contracts (EDIT-PASS-template + COMMON-ditc), pages 310/320/330 sequential, one author. **Pages** - 310-app-parts (explanation): description sheet → the manifest everywhere; narrative metaphor struck, mechanism kept; four topic headings → claim sentences; frontmatter `doc_type/requires: [your-tenant]/introduces: [working copy, repo, manifest, shape, release, "release tag"]`. - 320-scaffold (tutorial): scaffold defined once in product terms; building-frame/skeleton metaphor struck (incl. keyword); headings → imperative; ASK callout now names all three procedure commands; `requires: [app-parts, pick-tenant]`, `introduces: [scaffold]`. - 330-first-deploy (tutorial): git gloss added once, plainly (git, tag, push, `origin`); reassurance "being careful, not broken" struck, mechanism kept; all four headings → claim form; `requires: [scaffold]`, `introduces: [deploy, channel, stable, "the checks", "the runner"]`. Runner auto-restore + dry-run trust content kept verbatim. **Glossary**: +`working copy` (defined_in: app-parts), +`scaffold` (defined_in: scaffold). **Integration (2nd commit)**: 110/120 used "working copy" before its defining page — FIRST-USE/CONCEPT fail on 110:115/120:79 once 310 registers the term. Reworded to the plain description ("the copy that you and your assistant edit"); meaning unchanged; the term's first use now lands on 310 per the page map. **Gates (all green, coordinator-verified)**: build-docs --no-coverage --draft 0; check-prose --manual ditc clean (exit 0); check-lockstep --synthesize 0 fail (15 warn/18 skip unchanged); build-docs --draft 0; armada check-prose.sh exit 0 per page (310/320/330). **Read**: the Operator reads 330 (per the batch table). Do not merge until that read lands.

jsutter added 2 commits

2026-09-22 05:32:56 +00:00

ditc 310+320+330: B3 edit-pass — one vocabulary, claim/imperative headings, git gloss d4ff7dd51c

Assisted-by: author:synthetic/hf:moonshotai/Kimi-K3

ditc 110+120: drop pre-emptive 'working copy' uses — the term's first use lands on 310 per the page map eba226e7f9

The B3 batch registers 'working copy' in the glossary (defined_in:
app-parts), which activates FIRST-USE/CONCEPT on the B1 pages' earlier
colloquial uses. Reworded to the plain description ('the copy that you and
your assistant edit'); meaning unchanged.

Assisted-by: deepnet:synthetic/hf:zai-org/GLM-5.3-Flash

jsutter merged commit 30ec77b93f into main

2026-09-22 05:34:01 +00:00

jsutter referenced this pull request from a commit

2026-09-22 05:34:02 +00:00

Merge pull request 'ditc B3 edit-pass: app parts + scaffold + first deploy (310 + 320 + 330)' (#5) from ditc-b3 into main

jsutter referenced this pull request

2026-09-22 05:39:54 +00:00

ditc B4 edit-pass: Channels + Promote/rollback + Checks/approval (410 + 420 + 430) #7