Skip to content
This repository was archived by the owner on Mar 14, 2026. It is now read-only.

docs: restructure site nav for capability-neutral presentation (#181)#184

Merged
cdot65 merged 1 commit intomainfrom
cdot65/docs-restructure-181
Mar 14, 2026
Merged

docs: restructure site nav for capability-neutral presentation (#181)#184
cdot65 merged 1 commit intomainfrom
cdot65/docs-restructure-181

Conversation

@cdot65
Copy link
Owner

@cdot65 cdot65 commented Mar 14, 2026

Summary

Restructures the mkdocs documentation site to give all 5 capabilities equal weight. Previously, guardrail generation had 6 nested sub-pages while other capabilities had 1 page each.

Changes

  • Flatten Capabilities nav to 5 equal-weight pages (no nested sub-sections)
  • Move Core Loop, Memory System → Architecture section
  • Move Metrics, Topic Constraints, Resumable Runs → Reference section
  • Rewrite index.md: neutral 5-domain "Capabilities" grid + separate "Platform Features" grid
  • Remove guardrail-loop-only "How It Works" hero diagram
  • Rename "Examples" → "Guides" in nav
  • Update quick-start to use runtime topics/runtime profiles command paths

Testing

  • mkdocs build --strict passes
  • pnpm run build && pnpm run lint && pnpm test all pass (537 tests)
  • No broken internal links

Checklist

  • All pages still accessible (no content deleted, just reorganized in nav)
  • mkdocs build succeeds
  • Quality gates pass

Closes #181

🤖 Generated with Claude Code

- flatten Capabilities to 5 equal-weight pages (no nested guardrail sub-section)
- move Core Loop, Memory System → Architecture
- move Metrics, Topic Constraints, Resumable Runs → Reference
- rewrite index.md with neutral 5-domain feature grid
- remove guardrail-loop hero diagram, add "Capabilities" + "Platform Features" sections
- rename Examples → Guides in nav
- update quick-start to use runtime topics/profiles command paths

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cdot65 cdot65 merged commit 5728480 into main Mar 14, 2026
4 checks passed
@cdot65 cdot65 deleted the cdot65/docs-restructure-181 branch March 14, 2026 10:55
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

refactor: restructure docs nav for capability-neutral site

1 participant