gitops/docs/en/design.md

Design

This repository organizes declarative GitOps assets for infrastructure delivery.

Use this page to consolidate design decisions, ADR-style tradeoffs, and roadmap-sensitive implementation notes.

Current code-aligned notes

• Documentation target: gitops
• Repo kind: infra-repo
• Manifest and build evidence: repository structure and scripts only
• Primary implementation and ops directories: scripts/, StackFlow/, config/
• Package scripts snapshot: No package.json scripts were detected.

Existing docs to reconcile

• stackflow/README.md

What this page should cover next

• Describe the current implementation rather than an aspirational future-only design.
• Keep terminology aligned with the repository root README, manifests, and actual directories.
• Link deeper runbooks, specs, or subsystem notes from the legacy docs listed above.
• Promote one-off implementation notes into reusable design records when behavior, APIs, or deployment contracts change.