🧠 Research & Foundations phase — building the KB from the ground up. See the roadmap →
Reinit: first-principles KB convention + docs template
What changed
Section titled “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
Section titled “Structural changes”site/consolidated intodocs/— the Astro Starlight site is now atdocs/(matches crosswalker layout exactly). The old separatesite/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.mdthrough41-QUESTIONS-RESOLVED.md) as skeletons with TODO prompts
- Agent-context files:
Docs site changes
Section titled “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
Section titled “Root-level changes”CLAUDE.mdrewritten to point at.claude/as the first-read surface and updatecd site→cd docscommands.github/workflows/deploy.ymlupdated for the rename.gitignoreextended for.workspace/*,docs/playwright-report/,docs/test-results/
What’s next
Section titled “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
Section titled “Previous state”Before the reinit:
docs/held PARA-structured implementation notes (kebab-case, sub-foldersprojects/,areas/,resources/,archive/)site/held an Astro + Starlight prototype with the default Starlight welcome page and one emptykb/placeholder.claude/had onlysettings.local.json- No first-principles KB content anywhere
The reinit is the first commit where cyberbaser has a real self-explanatory structure.