Skip to content

Retire PLAN.md, DEPLOYMENT.md, ORIGINAL-SPEC-DRAFT.md; add plan-remaining.md and remaining_manual_steps.md - #15

Merged
Adron merged 1 commit into
devfrom
docs/consolidate-planning
Oct 21, 2026
Merged

Adron merged 1 commit into
devfrom
docs/consolidate-planning

Conversation

@Adron

@Adron Adron commented Oct 20, 2026

Copy link
Copy Markdown
Member

Summary

  • infra/README.md — the deployment architecture as built (moved from DEPLOYMENT.md, plus the real AWS account setup). Unbuilt sections moved to plan-remaining.md; the finished build checklist dropped.
  • plan-remaining.md — everything specified but not built: test-mode User expiry (migration renumbered 0005, because 0004_protected_superadmin ships first in Protected superadmin, re-asserted on every deploy #14), first-party web pages, Phase 3, dedicated tenancy infrastructure, growth/scale-out, MCP scaling, production verification, rules for every change.
  • remaining_manual_steps.md — one-time steps left to go live.
  • Deleted PLAN.md, DEPLOYMENT.md, ORIGINAL-SPEC-DRAFT.md; every reference repointed (docs, README, Terraform, Go comments). Historical Changelog links use a permalink.

Targets dev because #12 also edits PLAN.md/DEPLOYMENT.md; building on it avoids a modify/delete conflict.

Test plan

  • Jekyll build + internal link/anchor check: 0 broken
  • Root-doc anchor check: 0 broken
  • go build, go vet, terraform fmt -check, make gen clean
  • CI green

🤖 Generated with Claude Code

Everything in them is either built and documented where it belongs, or
consolidated into plan-remaining.md.

- infra/README.md: DEPLOYMENT.md's as-built content, next to the Terraform
  that implements it, plus the real account setup (Projects Organization,
  the SCP exception for substratal-prod, aws login). The unbuilt sections
  (growth trajectory, scale-out, MCP scaling, dedicated tenancy
  provisioning and its migration runbook) moved out; the finished build
  checklist was dropped.
- plan-remaining.md: test-mode User expiry (its migration renumbered to
  0005, since 0004 is the protected superadmin), the first-party web pages
  (dashboard, hosted sign-in), Phase 3, dedicated tenancy infrastructure,
  growth trajectory, scale-out, MCP scaling, production verification of
  the phase exit criteria, and the rules for every change.
- remaining_manual_steps.md: the one-time steps left to go live (Lambda
  quota, redeploy, superadmin password, alert emails, SES production
  access, Stripe, push credentials, registering Applications, the plan-job
  fix, legal, the optional domain transfer).
- ORIGINAL-SPEC-DRAFT.md: fully superseded by the docs site; deleted.
- Every link and comment repointed: docs site, README, Terraform, Go.
  Historical Changelog links point at the last commit that had the files.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Adron
Adron merged commit 14f81ab into dev Oct 21, 2026
@Adron
Adron deleted the docs/consolidate-planning branch October 21, 2026 00:00
@Adron Adron mentioned this pull request Oct 21, 2026
1 of 2 tasks
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.

1 participant