Skip to content

docs(architecture): release and deploy area doc (#109) - #130

Merged
plainprogrammer merged 24 commits into
mainfrom
109-release-deploy-area-doc
Oct 24, 2026
Merged

plainprogrammer merged 24 commits into
mainfrom
109-release-deploy-area-doc

Conversation

@plainprogrammer

Copy link
Copy Markdown
Owner

Closes #109. Spec 027 slice C for release and deploy.

What it does

  • New area doc docs/architecture/release-and-deploy.md, in the shape docs/architecture/README.md sets, every statement sourced inline and checked against the code on main. It covers the container, Compose and Kamal (spec 001), image publishing and digest cleanup (012, 013), the README introduction (020), the 40 MB request body limit (025 decision 6), the stored import upload's retention, sweep and gated routes (028 decisions 8 and 9, ADR 0022), and backup and restore (030, ADR 0024). Specs 001 (stack, CI, hooks), 003 and 014 describe the development environment: their facts stay in CLAUDE.md, and they freeze with this area.
  • Areas table: the release and deploy row links the doc, with docs/releasing.md and docs/backup-restore.md as reference docs.
  • CLAUDE.md: the Deploy and Backup bullets, and the release parts of Local CI and Import preview, become pointers to the area doc (spec 027 R5).
  • Frozen specs (frozen line only, one commit each, spec 027 D4): 001, 003, 012, 013, 014 and 020 whole. 025, 028 and 030 are now frozen whole by the two area docs together; each has one frozen line naming both.
  • Retired plans, each in a commit of its own with a pointer commit after it: 001 (96d5e65), 003 (8498f1b), 012 (a41bd08), 013 (5a1e2eb), 014 (4691f7b), 020 (4347416).

Open issues recorded in the doc

Merge with main

main (with #129, the data portability area doc) was merged in, not rebased, because this branch retires plans (25dd756). The conflicts were the shared rows: specs 025, 028 and 030 got one frozen line naming both area docs, the areas table takes each doc's own row, and CLAUDE.md keeps #129's pointer bullets with the stored upload and the request caps pointing here.

Checks

  • bin/ci passed before the merge (2006 examples, 0 failures, 1 pending) and again in the pre-push hook after it.
  • The edits to shipped specs are only their Frozen: lines and retirement pointers.

Merge with a merge commit (never squash or rebase), so the six retirement commits stay in main's history as written.

🤖 Generated with Claude Code

plainprogrammer and others added 24 commits October 23, 2026 22:07
… 025, 028, 030 into release and deploy

Adds docs/architecture/release-and-deploy.md, fills its row in the areas table, turns CLAUDE.md's
Deploy and Backup and restore bullets (and the release parts of two others) into pointers, and
freezes the covered specs in the index (spec 027 slice C, #109).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…(spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…(spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…(spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…(spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…(spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…(spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…rea doc (spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…rea doc (spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…rea doc (spec 027 D4)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…'s tags

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…bility area doc (#129)

Conflicts, resolved so both area docs stand:
- specs 025, 028 and 030: each spec's two frozen lines become one naming both
  area docs and their parts; in the index they are now Frozen, by data
  portability and release and deploy;
- docs/architecture/README.md: main's data portability row and this branch's
  release and deploy row;
- CLAUDE.md: main's pointer bullets, with the stored upload's retention and
  the 40 MB caps pointing to the release and deploy area doc.
The release and deploy doc's scope now links the data portability doc.
Merged, not rebased: this branch retires plans (docs/git-convention.md).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@plainprogrammer plainprogrammer self-assigned this Oct 24, 2026
@plainprogrammer
plainprogrammer merged commit ae593b2 into main Oct 24, 2026
4 checks passed
@plainprogrammer
plainprogrammer deleted the 109-release-deploy-area-doc branch October 24, 2026 02:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Area doc: release and deploy

1 participant