Table of Contents
Status: Active | Owner: @roof | Updated: 2026-06-11
Meta – Template ADR
This is a copy-only skeleton. To use it: copy the full content into a new page named ADR – NNN Short Title.md (use the next available number), fill in each section, and delete this notice.
ADRs record significant architectural decisions — choices that are non-obvious, have consequences, or would be puzzling to a future maintainer without context.
> **Status:** Active | **Owner:** @username | **Updated:** YYYY-MM-DD
# ADR – NNN Short Title of the Decision
## Context
What situation or problem forced this decision? Include:
- What existed before (the old approach, or the absence of one).
- What constraints apply (security, performance, compatibility, team size).
- What would happen if no decision were made.
---
## Options Considered
List the realistic options that were evaluated.
### Option A — <Name>
What it is. Why it was considered. Key trade-offs.
**Rejected because:** <reason>.
### Option B — <Name>
What it is. Why it was considered. Key trade-offs.
**Rejected because:** <reason>.
### Option C — <Name> (chosen)
What it is. Why it was considered. Key trade-offs.
---
## Decision
State the decision in one or two sentences. Be specific.
> We chose Option C because <reason>. This means <concrete consequence>.
---
## Consequences
What changes as a result of this decision?
- List positive consequences (what it enables, what risk it removes).
- List negative consequences or trade-offs (what becomes harder, what is now constrained).
- List migration or compatibility concerns.
- List what must stay true for this decision to remain valid (invariants).
Personal Internet Cell
New here?
Users
User – Connect to the VPN User – Use Your Services User – Troubleshooting
Admins
Admin – Overview Admin – Install and First Run Admin – Configure Domains and TLS Admin – Manage Services Admin – Configure Connectivity Admin – Manage Peers Admin – Back Up and Restore Admin – Logging and Audit Admin – Monitor and Troubleshoot
Developers
Dev – Overview Dev – Architecture Dev – Build a Store Service Dev – Service Manifest Reference Dev – API Reference Dev – Testing Dev – Install Internals
Decisions (ADRs)
ADR – 001 Store Images Are Signed and Verified by Cells ADR – 002 Named Connection Instances for Connectivity ADR – 003 All Optional Functionality Ships as Store Services
Meta
Meta – Glossary Meta – Template Runbook Meta – Template ADR
Archive
Archive – User Guide Archive – ADR 004 The Wiki Is the Single Documentation Source