Skip to content
Alistigo Alistigo

Architecture Decision Records

Architecture Decision Records capture every significant architectural choice made for Alistigo. Each ADR explains the context, the decision, the alternatives considered, and the trade-offs accepted.

Source of truth: packages/architecture/adrs/

# Title Status Date
0001 ADR 0001 — UI Library & i18n Stack accepted 2026-05-02
0002 ADR 0002 — Branch Protection & Security accepted 2026-06-10
0003 ADR 0003 — npm Publishing via OIDC Trusted Publisher superseded 2026-06-10
0004 ADR-004: Artifact Delivery Strategy — npm/jsDelivr over GitHub Pages accepted 2026-06-02
0005 ADR-005: Storage in Claude Artifact Context — window.storage over localStorage accepted 2026-06-02
0006 ADR-006: GitHub Pages Scope — Testing/Demos Only accepted 2026-06-02
0007 ADR 0007 — Logging Library accepted 2026-06-03
0008 ADR 0008 — Error Monitoring accepted 2026-06-09
0009 ADR 0009 — Browser Debug API accepted 2026-06-09
0010 ADR 0010 — Product Analytics accepted 2026-06-09
0011 ADR 0011 — jsDelivr CDN Versioning Strategy accepted 2026-06-12
0012 ADR 0012 — Component Documentation Standard accepted 2026-06-12
0013 ADR 0013 — Release Strategy accepted 2026-06-10
0014 ADR 0014 — npm Publishing via NPM_TOKEN accepted 2026-06-11
0015 ADR 0015 — Agent Skills Standard (agentskills.io) accepted 2026-06-30
0016 ADR 0016 — Composable Artifact Plugin System accepted 2026-07-09
0017 ADR 0017 — Storage Plugin System accepted 2026-07-24
0018 ADR 0018 — Alistigo as a Platform for AI Artifacts accepted 2026-07-27
0019 ADR-0019: Claude Artifact Lifecycle — Draft vs. Published Storage Behavior accepted 2026-08-06
0020 ADR 0020 — Claude Artifact `window.fetch` is Anthropic-API-Only accepted 2026-08-09
0021 ADR-0021: AI Input Action — Markdown as Document Source Format accepted 2026-08-15
0022 ADR 0022 — Artifact User Plugin: Device-Scoped Identity accepted 2026-08-20
0023 ADR 0023 — Entity IDs: TypeID as the Preferred Format accepted 2026-08-20
0024 ADR 0024 — Shared-List View: Actor Registry in Document accepted 2026-08-25
0025 ADR 0025 — Checkbox Plugin: First Domain-Contribution Plugin accepted 2026-08-25
0026 ADR 0026 — Alistigo Document Format: JSON-LD + schema.org Foundation and Package Standard accepted 2026-08-29
0027 ADR 0027 — Architecture as Code: Adopting CALM (Common Architecture Language Model) accepted 2026-09-04
0028 ADR 0028 — Package-First Repository Structure accepted 2026-09-08
0029 ADR 0029 — Alistigo.com Public Website via Astro Starlight accepted 2026-09-09
0030 ADR 0030 — PM2 Server Dev Mode accepted 2026-09-14