docs: rewrite architecture overview

[s-adamantine]

Summary

• Restructured around a narrative flow: Three Layers → How Data Flows → Why It's Trustworthy → Why This Architecture
• Merged the duplicate "Stack" and "Data Layer" sections into one
• Collapsed 4 repeated "Planned — see Funding & Value Flow" references into 1
• Shortened Key Design Decisions to one sentence each
• Cut "What This Enables" section (points woven into body text)
• Cut "Next Steps" link dump
• Fixed misleading tamper-evidence claim (user edits don't "break" signatures — third-party tampering does)
• All 4 architecture sub-pages (Account & Identity, Data Flow, Indexers, Portability) linked in context

Fixes https://linear.app/hypercerts/issue/HYPER-158/architecture-overview-page

Summary by CodeRabbit

• Documentation
  • Reorganized the architecture overview for improved clarity and conciseness
  • Streamlined content to highlight core concepts: data portability, trustworthiness, and architectural rationale
  • Condensed multi-section design details into a focused narrative emphasizing high-level value and planned on-chain anchoring capabilities

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hypercerts-atproto-documentation	Ready	Preview, Comment	Mar 5, 2026 0:47am
hypercerts-v0.2-documentation	Ready	Preview, Comment	Mar 5, 2026 0:47am

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b50c2975-c376-4029-b8f4-bbdbf750e78b

📥 Commits

Reviewing files that changed from the base of the PR and between ffb0c77 and d87645d.

📒 Files selected for processing (1)

• pages/architecture/overview.md

---

📝 Walkthrough

Walkthrough

The architecture overview documentation has been restructured and condensed, consolidating multi-part sections into a streamlined narrative. The three-layer model is reframed with visual hierarchy, and content on data flows, security model, and design decisions is reorganized into unified sections focused on the core value proposition.

Changes

Cohort / File(s)	Summary
Architecture Documentation Restructure pages/architecture/overview.md	Condensed and reorganized content by reframing the three-layer model as a visual header section, merging Data Layer Deep Dive and Lexicons into a unified data narrative, consolidating Security Model into "Why It's Trustworthy", replacing "Key Design Decisions" with "Why This Architecture" and "Why not fully on-chain/off-chain", and streamlining data flow descriptions. Net reduction of 88 lines.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• docs: remove orphaned the-hypercerts-infrastructure page #63: Removes an orphan page whose content was consolidated into architecture/overview.md and data-flow-and-lifecycle.md, directly related to this restructuring effort.

Suggested reviewers

• Kzoeps

Poem

🐰 A doc that wandered, lost in detail's maze,
Now hops with purpose through a clearer gaze,
Three layers refined, the narrative refined,
Architecture's essence, elegantly aligned! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title directly addresses the main change: rewriting the architecture overview documentation file.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/architecture-overview

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}