bcs-website/docs/adr/README.md
Brad Rodgers cd91c4b97c Initial commit: BlueCap Strategies Astro site
Static Astro 5 site for BlueCap Strategies with exact live-site content
parity, deployed to k3s via GitOps (ArgoCD).

- Page copy in Markdown content collections (services, focus-areas, pages,
  insights) with a Zod SEO schema enforced at build time
- Homepage + About restored to exact live copy; real live-site imagery
- Build-time SEO linter (scripts/seo-lint.mjs) and Playwright e2e suite
- Multi-stage Dockerfile (nginx serves dist/) and Kustomize manifests (k8s/)
- Per-agent robots.txt; config-driven PostHog + Umami analytics scaffold
- ADRs and engineering docs under docs/

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-15 17:40:46 -04:00

1.1 KiB

Architecture Decision Records

Short, immutable records of significant decisions on the BlueCap Strategies rebuild. Each ADR captures the context, the decision, and its consequences at a point in time. Supersede rather than edit: to change a decision, add a new ADR and mark the old one Superseded by ADR-XXXX.

Format: Status · Context · Decision · Consequences. Statuses: Proposed · Accepted · Superseded.

ADR Title Status
0001 GitOps deployment via ArgoCD (not Flux) Accepted
0002 Page copy in Astro Content Collections (Markdown) Accepted
0003 Enforce SEO rules with Zod + build linter (not Pydantic) Accepted
0004 Reuse the monylog stack for ops monitoring (not Uptime Kuma) Accepted
0005 Visitor analytics: PostHog + Umami side-by-side trial Accepted
0006 Launch a blog at /insights/ Accepted