feat: bootstrap design kit and vaporwave demo baseline

kit/docs/bible-skeleton/README.md

@@ -0,0 +1,20 @@
+# Project Bible
+
+The Bible is the single source of truth for this project's architecture.
+
+## Documentation Rules
+
+- All architecture decisions must be recorded in this Bible.
+- The documentation language is English only.
+- If a decision is superseded, update the Bible immediately and remove or mark obsolete content.
+- Do not duplicate architecture documentation in `README.md`, `CLAUDE.md`, or other files.
+
+## Structure
+
+- `governance/documentation-policy.md` - mandatory rules for maintaining architecture docs.
+- `architecture/system-overview.md` - current scope, boundaries, and high-level system composition.
+- `architecture/api-surface.md` - HTTP API and UI route contracts.
+- `architecture/runtime-flows.md` - critical runtime behavior and failure invariants.
+- `architecture/ui-information-architecture.md` - required UI structure and semantics.
+- `decisions/README.md` - how to capture new and updated architecture decisions.
+

kit/docs/bible-skeleton/architecture/api-surface.md

@@ -0,0 +1,10 @@
+# API Surface
+
+Document all HTTP endpoints and UI routes that are part of the active contract.
+
+## Rules
+
+- Keep request/response shapes explicit.
+- Record compatibility aliases and deprecations.
+- Update this file when route behavior changes.
+

kit/docs/bible-skeleton/architecture/runtime-flows.md

@@ -0,0 +1,11 @@
+# Runtime Flows
+
+Document the critical runtime flows and failure invariants.
+
+Recommended sections:
+
+- Startup flow
+- Request handling flow
+- Background tasks
+- Failure / retry / cancellation behavior
+

kit/docs/bible-skeleton/architecture/system-overview.md

@@ -0,0 +1,32 @@
+# System Overview
+
+## Product
+
+Describe the product in one paragraph.
+
+## Active Scope
+
+- List current in-scope modules/features
+- List user-visible surfaces
+- List operational responsibilities
+
+## Explicitly Removed / Out of Scope
+
+- List legacy or excluded modules to avoid accidental restoration
+
+## Runtime Composition
+
+- HTTP server package(s)
+- Domain/service orchestration
+- Persistence layer(s)
+- Migrations / background workers (if any)
+
+## Local Execution
+
+- `make run`
+- `go run ./cmd/<binary>`
+
+## Verification
+
+- `go test ./...`
+

kit/docs/bible-skeleton/architecture/ui-information-architecture.md

@@ -0,0 +1,7 @@
+# UI Information Architecture
+
+Document page structure, required section order, UI interaction contracts, and list/filter/
+pagination behavior.
+
+Use explicit route names and action contracts so AI agents can implement changes consistently.
+

kit/docs/bible-skeleton/decisions/README.md

@@ -0,0 +1,18 @@
+# Architecture Decision Records
+
+Use this directory to capture architecture decisions and significant updates.
+
+## Required
+
+- Every architecture decision must be recorded in the Bible.
+- If a decision replaces an older one, update the older document in the same change.
+- Keep entries short, explicit, and linked to the affected architecture files.
+
+## Minimal Entry Template
+
+- Date (`YYYY-MM-DD`)
+- Decision
+- Context
+- Consequences
+- Supersedes (if any)
+

kit/docs/bible-skeleton/governance/documentation-policy.md

@@ -0,0 +1,21 @@
+# Documentation Policy
+
+## Purpose
+
+This policy defines how architectural knowledge is captured and maintained.
+
+## Mandatory Rules
+
+- Record every architecture decision in the Bible before or together with implementation.
+- Use English for all architecture documentation.
+- Keep only current architecture in active sections.
+- When a solution is replaced, update or remove obsolete guidance in the same change.
+- Keep architecture details centralized in `bible/`; other top-level docs should only reference it.
+
+## Change Workflow
+
+1. Update the relevant file(s) in `bible/architecture/`.
+2. If behavior changed, add or update a decision note in `bible/decisions/`.
+3. Remove duplicated or outdated statements from non-Bible docs.
+4. Validate consistency against current code paths.
+