Skip to content

docs(khal-os): home, narrative, IA rewrite — VC v1#5

Merged
namastex888 merged 1 commit into
devfrom
docs-khal-home
Apr 17, 2026
Merged

docs(khal-os): home, narrative, IA rewrite — VC v1#5
namastex888 merged 1 commit into
devfrom
docs-khal-home

Conversation

@namastex888

Copy link
Copy Markdown
Contributor

Summary

Foundational PR for the Khal-OS FDE Manual. Replaces the unmodified Mintlify Starter Kit with Khal-OS branding, the cross-org narrative, and the 20-page FDE manual IA.

What changed

  • docs.json — full rewrite. Branded (name: Khal OS, primary #18E299), 20-page IA in 4 tabs.
  • index.mdx — new Home with cross-org narrative, Day-1 CardGroup, Learn-by-Example cards, Frame placeholder for nmstx.khal.ai hero.
  • what-is-khal-os.mdx — FDE-facing framing. Kernel is a black box.
  • Deleted Mintlify Starter Kit boilerplate: ai-tools/, api-reference/, essentials/*, development.mdx, quickstart.mdx.

Kernel-protection guardrails (applied)

  1. No core/platform/brain/deploy source citations.
  2. Contracts exposed, mechanisms hidden.
  3. Secrets: FDE declares, platform provides.
  4. Pack-authoring ≠ pack-deployment.
  5. NATS surface only.

Sibling PRs (same sprint)

Remaining 7 pages (patterns + dev + release + reference) tracked separately — the docs-khal-ship team did not ship.

Generated with Claude Code.

- Rewrite docs.json with Khal OS brand + 20-page FDE manual IA
- Author index.mdx (Home) with cross-org narrative + Day-1 card
- Author what-is-khal-os.mdx (FDE framing, kernel black-boxed)
- Delete Mintlify Starter Kit boilerplate:
  ai-tools/*, api-reference/*, essentials/*, development.mdx, quickstart.mdx

Kernel-protection guardrails applied throughout.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@namastex888 namastex888 changed the base branch from main to dev April 17, 2026 05:22
@namastex888 namastex888 merged commit 1929d81 into dev Apr 17, 2026
2 checks passed
@namastex888 namastex888 deleted the docs-khal-home branch April 17, 2026 05:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants