Skip to content
Sri Guru Granth Sahib Ji — Knowledge Base

Decisions

Decisions

Updated

Page actions

ChatGPT and Claude are third-party services. The link gives them this page's public address and a short instruction. This site records nothing.

The architecture decision records on a timeline: what was decided, when, and its status — twelve decisions from the trunk branch to the docs site, each with context, decision and consequences.

https://docs.gurbanisoul.com/adr/

An ADR records one decision that shaped the system: the context, the decision, the consequences. They are numbered in the order they were written and never edited after acceptance — a later decision that changes course gets its own number and says so. The sibling repositories keep their own ADRs (sggs-data, gurbani-soul-ios).

  1. 2026-09-15 · ADR-0001: integration is the trunk; main is productionaccepted
  2. 2026-09-15 · ADR-0002: Fold heading runs into the composition, keeping the last heading's comp_idaccepted
  3. 2026-09-15 · ADR-0003: The engineering wiki lives in docs/accepted
  4. 2026-09-15 · ADR-0004: One unified SemVer across web, API, and iOSaccepted
  5. 2026-09-15 · ADR-0005: Production deploys are performed by CI after gates, not by platform git hooksaccepted
  6. 2026-09-18 · ADR-0006: Banis are a registry of pointers over the verbatim corpus; non-SGGS text is a separate labelled layeraccepted
  7. 2026-09-24 · ADR-0007: Three repositories — data, platform, app — joined by pinned artifactsaccepted
  8. 2026-09-24 · ADR-0008: The platform consumes the dataset by pin, never by copyaccepted
  9. 2026-09-24 · ADR-0009: Production is verified continuously, and logs never carry what people searchaccepted
  10. 2026-09-25 · ADR-0010: One image per context, behind a gateway generated from the code (staging first)accepted
  11. 2026-09-25 · ADR-0011: The API runs as Vercel functions inside the web project (staging first)accepted
  12. 2026-09-25 · ADR-0012: The wiki is rendered as a docs site over the Markdown in docs/accepted
  13. 2026-10-11 · ADR-0013: The wiki links out to assistants; it does not embed oneaccepted

On the rendered wiki this is a timeline; on GitHub, the records are the numbered files in this directory.

Writing one

Copy the newest record, take the next number, keep the three headings, and state the status with its date (**Status:** accepted (YYYY-MM-DD)). Exercise 04 walks through it.

Sri Guru Granth Sahib Ji — Knowledge Base wiki. Generated from commit c3d9360. Updated 25 September 2026. This copy may be out of date; the page is at https://docs.gurbanisoul.com/adr/