These records explain decisions shared by more than one Resident Council service. Product-specific records live beside the product they affect.
ADR-001: Keep independently deployed repositories
Status: Active
Decision: Keep each product in its own repository while deployments, runtimes, access, and release ownership remain independent.
Consequence: Shared documentation must be checked against every relevant repository rather than assuming one release represents the whole platform.
ADR-002: Put an identity boundary in front of administration
Status: Active
Decision: Use Cloudflare Access as the first identity boundary for protected browser administration, then enforce service-specific authorization in application code.
Consequence: A route is not treated as private until its edge policy and application checks are both verified. Recovery paths stay narrow and service-specific.
ADR-003: Use one Markdown source for Obsidian and Quartz
Status: Active
Decision: Treat quartz/content as the canonical Resident Council documentation vault. Edit the same Markdown in Obsidian and publish it through Quartz.
Consequence: Content stays in frontmatter, Markdown, wikilinks, callouts, tables, and Mermaid. Layout belongs in shared CSS, not page-specific HTML.
ADR-004: Separate documentation by product stewardship
Status: Active
Recorded: August 30, 2026
Decision: Keep Resident Council governance and product documentation at docs.ihnyc-rc.org. Publish House Desk, Pub, and their shared Affective Technologies platform documentation at docs.ihnyc.affectivetech.com.
Consequence: The RC site may link to those products for discovery, but it does not present them as RC-controlled. Old product-documentation URLs permanently redirect to their new canonical pages.
Documentation rules
- Current service code is authoritative for implementation details.
- Active pages state shipped behavior; dated design documents preserve intent and history.
- Contributing and maintaining defines the writing and visual standard.
- Naming conventions defines technical labels used in diagrams.