Reinit: first-principles KB convention + docs template

Sat, 11 Apr 2026 00:00:00 GMT

What changed

After ~4 months dormant, cyberbaser was reinitialized to match the .claude/ numbered-file workspace convention from sibling projects crosswalker and cyberchaste.

Structural changes

site/ consolidated into docs/ — the Astro Starlight site is now at docs/ (matches crosswalker layout exactly). The old separate site/ folder is gone.
.workspace/ created as a tracked-but-ignored scratch folder. Personal notes live here; contents are gitignored so they don’t leak into commits.
.workspace/_archive-phase-0-docs/ holds the old PARA-structured dev docs (architecture, build scaling, deployment, testing workflow, translation layer notes). They’re preserved for mining, not in the critical path.
.claude/ populated with:
- Agent-context files: PROJECT_CONTEXT.md, FOCUS.md, KNOWLEDGE_BASE_PHILOSOPHY.md, DOCUMENTATION_STYLE.md, RESEARCH_SOURCES.md
- Numbered first-principles files (00-INDEX.md through 41-QUESTIONS-RESOLVED.md) as skeletons with TODO prompts

Docs site changes

Full template copy from siblings: Astro v6, Starlight v0.38, Nova theme, full plugin stack (site-graph, blog, announcement, image-zoom, heading-badges, tags)
Markdown pipeline: remark-obsidian-callout, remark-wiki-link, rehype-mermaid, rehype-external-links
Silver + emerald palette — distinct from sibling projects (crosswalker cyan, cyberchaste blue/yellow). Silver base with a hint of green as the only accent color; gradients on hero headline, CTAs, and card top borders.
Rotating hero copied from crosswalker’s pattern with cyberbaser-specific taglines
Custom SVG diagrams on Problem (triangle), Architecture (layer diagram), and Splash (contribution flow) pages — no Mermaid walls, every diagram hand-drawn in inline SVG with CSS styling
Content ported from .claude/: Problem, Ecosystem, Primitives, Vision, Principles, Roadmap, Architecture, Translation Layer, Contribution Workflows, Prior Art, Open Questions, Trade-offs, Existing Work — all rewritten as real prose, not TODO placeholders

Root-level changes

CLAUDE.md rewritten to point at .claude/ as the first-read surface and update cd site → cd docs commands
.github/workflows/deploy.yml updated for the rename
.gitignore extended for .workspace/*, docs/playwright-report/, docs/test-results/

What’s next

Phase R (Research & Foundations) is the only active phase. No shipping work until:

Problem page has a one-sentence TL;DR + articulated pain + scope boundaries (✅ drafted)
Ecosystem page has real paragraphs per tool (⚠️ first-pass draft, needs depth)
Concepts page has “What / Why / How” for each primitive (✅ drafted)
Prior Art has a “Lesson for cyberbaser” sentence per entry (✅ drafted for 6 entries)
Vision is rewritten from lived evidence (⚠️ first-pass, needs depth)
Principles has justified “Why” per principle (✅ drafted)

See Roadmap · Phase R exit criteria for the full list.

Previous state

Before the reinit:

docs/ held PARA-structured implementation notes (kebab-case, sub-folders projects/, areas/, resources/, archive/)
site/ held an Astro + Starlight prototype with the default Starlight welcome page and one empty kb/ placeholder
.claude/ had only settings.local.json
No first-principles KB content anywhere

The reinit is the first commit where cyberbaser has a real self-explanatory structure.