Skip to content

DECISIONS.md

Latest commit

 

History

History
64 lines (55 loc) · 2.69 KB

DECISIONS.md

File metadata and controls

64 lines (55 loc) · 2.69 KB
Raw

Architecture Decision Records

D-001: LLM Model Version

  • Date: 2026-04-29
  • Context: BUILD_MANIFEST specified claude-sonnet-4-5; at build time claude-sonnet-4-6 is the latest stable Sonnet
  • Decision: Use claude-sonnet-4-6 in all code; keep ANTHROPIC_MODEL env var as override
  • Alternatives considered: Pin to 4-5 as manifest specified
  • Reversible: yes (env var override)

D-002: Python Management via uv

  • Date: 2026-04-29
  • Context: Python 3.11+ not in PATH on build machine; uv 0.11.7 is available
  • Decision: Use uv python install 3.11 to install Python and manage entirely through uv; no system Python required
  • Alternatives considered: winget install Python 3.11
  • Reversible: yes

D-003: Git Repo Initialized Locally Before GitHub

  • Date: 2026-04-29
  • Context: gh CLI not installed at session start; git is available
  • Decision: Init local repo first, install gh CLI via winget in background, push to GitHub once authenticated
  • Alternatives considered: Wait for gh CLI before any work
  • Reversible: yes

D-004: Model Reference Updated

  • Date: 2026-04-29
  • Context: Manifest has claude-sonnet-4-5; current latest is claude-sonnet-4-6
  • Decision: All code references use claude-sonnet-4-6; ANTHROPIC_MODEL var in repo variables set to match
  • Alternatives considered: Keep 4-5 as manifest literal
  • Reversible: yes

D-G01: Repo Visibility — Public

  • Date: 2026-04-29
  • Context: Billing status for GitHub org unknown; manifest says default PUBLIC if billing unresolved
  • Decision: Create repo as public
  • Alternatives considered: Private (requires paid plan for org private repos)
  • Reversible: yes (can flip to private via settings)

D-G02: Branch Protection — 0 Reviewers

  • Date: 2026-04-29
  • Context: Solo founder phase
  • Decision: required_approving_review_count=0; bump to 1 when teammates join
  • Alternatives considered: Require 1 reviewer from start
  • Reversible: yes

D-G03: Squash Merge + Linear History

  • Date: 2026-04-29
  • Context: Cleaner git history for a monorepo with many small atomic commits
  • Decision: squash merge only, linear history enforced on main
  • Alternatives considered: allow all merge types
  • Reversible: yes

D-G04: Two GitHub Environments

  • Date: 2026-04-29
  • Context: Need to gate production deploys while allowing staging to flow freely
  • Decision: production requires manual approval; staging auto-deploys from main
  • Alternatives considered: single environment
  • Reversible: yes

D-G05: Org .github Repo

  • Date: 2026-04-29
  • Context: Org-level profile and default files need a dedicated repo
  • Decision: Create MENA-intelligence-Platform/.github as public repo with org profile README
  • Alternatives considered: Skip org profile for now
  • Reversible: yes