Nepal Dev VerseGitHub

Architecture Decision Records

Every decision about how this site is built and run, with its status, from the first ADR to the latest.

Every feature and functional change starts here (ADR-0001). Template: ../_templates/adr.mdx.

Next free number: 0038

Conventions

  • File name: ADR-NNNN-kebab-title.mdx, numbered from the next free number above. Add the index row and bump the number in the same change that creates the file, so ADRs in flight cannot collide.
  • Title: a short imperative statement of the decision ("Keep private project docs out of the public build").
  • Status: Proposed → Approved (by the owner, with name and date) → optionally Superseded by ADR-NNNN. A rejected proposal is marked Rejected and kept.
  • An approved ADR's Decision is never edited. Supersede it with a new ADR and cross-link both.
  • The Security considerations section is mandatory (ADR-0005).

Index

ADRTitleStatusDate
0001Every change starts with an approved ADRApproved2026-10-31
0002Design documents are living snapshots, published as this site's Maintain trackApproved2026-10-31
0003Comments explain why; every branch takes a blockApproved2026-10-31
0004Resolve ambiguity by asking, never by guessingApproved2026-10-31
0005Security and privacy are a standing practiceApproved2026-10-31
0006Agent skills are advisory; this repository's documentation is bindingApproved2026-10-31
0007Tests are part of every changeApproved2026-10-31
0008A UI change ships an app flow, drawn in MermaidApproved2026-10-31
0009Trusted agent skills are vendored in .claude/agent-skills/, routed by an indexApproved2026-10-31
0010Projects document themselves here through a git submodule, one folder eachApproved2026-10-31
0011Archify diagrams are embedded in pages from sandboxed HTML filesApproved2026-10-31
0012Every page in content/docs is MDXApproved2026-10-31
0013Packages and projects share one catalogue shape: two tracks, version lines and demosApproved2026-10-31
0014The home page is a search-first map of every releaseApproved2026-10-31
0015Every package and project lives at the root, in one shape and one lookApproved2026-10-31
0016Home search is the Fumadocs dialog, and private projects render server-sideApproved2026-11-01
0017The whole site is one solar systemApproved2026-11-01
0018Docs pages get orbit stations, a trajectory and the full horizonApproved2026-11-01
0019ADR folders show as a constellation in the sidebarApproved2026-11-01
0020People in ADRs are GitHub usernames, shown as profile chipsApproved2026-11-01
0021Tests run with Bun's built-in test runnerApproved2026-11-01
0022Diagrams show their Archify view on the page and their Mermaid in MarkdownApproved2026-11-01
0023Sidebar stations open one at a timeApproved2026-11-01
0024A project can span several repositoriesApproved2026-11-01
0025The overview has the same sidebar as its tracksApproved2026-11-01
0026The moon picker on an overview opens a line's first pageApproved2026-11-01
0027The sidebar is a scale ladder with one lifted orbitApproved2026-11-01
0028The site is named Puncoz VerseApproved2026-11-01
0029The Verse is a still sky you zoom throughApproved2026-11-01
0030The horizon rises over the page, and its sky comes aliveApproved2026-11-01
0031The sidebar sets without dimmingApproved2026-11-01
0032The hero's system comes aliveApproved2026-11-01
0033The footer says you've reached the horizonApproved2026-11-03
0034The proxy answers unknown paths with a true 404Approved2026-11-03
0035Every page is ready for search and sharingApproved2026-11-03
0036The site is Nepal Dev Verse, part of nepal-dev.comApproved2026-11-03
0037The Horizon is the HimalayaApproved2026-11-03

Maintainer documentation

How this site is built and decided: a map of its decisions, design documents and security documents, and what lives where.

ADR-0001 — Every change starts with an approved ADR

Every feature and functional change starts with a written decision, and no implementation begins until the owner approves it.

On this page

7 min read
  1. Conventions
  2. Index