Skip to content

Restructure into a tiered progression (tier-0 through tier-5) - #21

Open
magnusp wants to merge 3 commits into
mainfrom
task/scale-down
Open

magnusp wants to merge 3 commits into
mainfrom
task/scale-down

Conversation

@magnusp

@magnusp magnusp commented Sep 15, 2026

Copy link
Copy Markdown
Owner

Summary

  • Splits the single "final state" GitOps showcase into six isolated, self-contained tiers (tier-0 through tier-5), each with its own kind cluster, OpenTofu stack, and manifests, peeling back one capability at a time from tier-5 (which matches today's main): raw manifests → Flux GitOps → Helm chart/platform-app split → OCI-published app values → SpiceDB ReBAC → full governance and supply-chain verification.
  • Converges TIERS.md and README.md into a single root README.md with a "Tiers" section, and repoints every cross-reference (tier READMEs, CLAUDE.md, CI workflow comments) accordingly.
  • Adds a status-matrix infographic (docs/team-conflicts-infographic.html) showing how developer/platform/security friction points resolve across the tiers.
  • Records the restructure as a new phase in TIMELINE.md, consistent with how prior architectural decisions are documented there.
  • Adds a CLAUDE.md documenting the tiered layout for future agent sessions.

Test plan

  • cd tier-0/kind-cluster && ./cluster.sh up && ./cluster.sh check && ./cluster.sh down
  • cd tier-1/kind-cluster && ./cluster.sh up && ./cluster.sh check && ./cluster.sh down
  • cd tier-2/kind-cluster && ./cluster.sh up && ./cluster.sh check && ./cluster.sh down
  • cd tier-3/kind-cluster && ./cluster.sh up && ./cluster.sh check && ./cluster.sh down
  • cd tier-4/kind-cluster && ./cluster.sh up && ./cluster.sh check && ./cluster.sh down
  • cd tier-5/kind-cluster && ./cluster.sh up && ./cluster.sh check && ./cluster.sh down (full original showcase runbook)

🤖 Generated with Claude Code

magnusp and others added 3 commits September 15, 2026 15:53
Splits the single "final state" GitOps showcase into six isolated,
self-contained tiers that each peel back one capability from tier-5
(today's main): raw manifests -> Flux GitOps -> Helm chart/platform-app
split -> OCI-published app values -> SpiceDB ReBAC -> full governance
and supply-chain verification.

Every tier has its own kind cluster, OpenTofu stack, and README
explaining what it demonstrates and what changes on the way to the
next tier. Root README and new TIERS.md act as the landing page and
tier index; CI workflows stay at the repo root (a GitHub Actions
requirement) but are noted as relevant from a given tier onward.

Also adds a status-matrix infographic (docs/) showing how developer,
platform, and security friction points resolve across the tiers.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
TIERS.md and README.md covered overlapping ground now that the repo is
tiered; converge on a single root README with a "Tiers" section, and
repoint every cross-reference (tier READMEs, CLAUDE.md, CI workflow
comments) at it. Also documents the tier-0..tier-5 restructure as a
new phase in TIMELINE.md, consistent with how prior architectural
decisions are recorded there.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Old tier-0 (raw manifests, hand kubectl-applied, no Flux) didn't match
the real starting point in our environment, where Flux already
reconciles a cluster repo and a custom deployer tool already templates
manifests and commits them on merge. Collapse old tier-0 and tier-1
into a new tier-0 that reflects that baseline (Flux + deployer-tool
commits, no platform/app split yet), and renumber everything else down
by one (tier-2..tier-5 -> tier-1..tier-4). tier-4 is now the final,
full-governance tier.

Updates every cross-reference accordingly: root README's Tiers table
and throughline, CLAUDE.md, the three CI workflows' hardcoded paths
and "relevant from" comments, the team-conflicts infographic (6
columns -> 5, tier-0 statuses re-derived for the new baseline), and a
new addendum bullet in TIMELINE.md's existing restructure entry
documenting the renumbering and why.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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