Skip to content
🧠 Research & Foundations phase — building the KB from the ground up. See the roadmap →

Reinit: first-principles KB convention + docs template

CreatedUpdated

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

  • 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
  • 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
  • CLAUDE.md rewritten to point at .claude/ as the first-read surface and update cd sitecd docs commands
  • .github/workflows/deploy.yml updated for the rename
  • .gitignore extended for .workspace/*, docs/playwright-report/, docs/test-results/

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.

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.