This repository was archived by the owner on Apr 15, 2026. It is now read-only.
docs: initialize Docusaurus documentation site#28
Merged
Conversation
Set up documentation site using Docusaurus with the Diataxis methodology (Tutorials, How-to Guides, Reference, Explanation). - Configure Docusaurus for docs-only mode at root path - Migrate ADRs to docs/docs/decisions/ with frontmatter - Create stub files for all planned documentation pages - Remove old design documents (content to be extracted) - Set up sidebar navigation with collapsible categories Structure includes: - 4 tutorials (getting started, first task, parallel agents, custom image) - 15 how-to guides (install, auth, spawning, management) - 19 reference pages (CLI commands, config, images) - 8 explanation pages (architecture, concepts) - 6 ADRs with index page 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add comprehensive intro.md landing page including: - Project description and value proposition - Key concepts (Instance, Session, Agent) - Quick usage examples - Links to Getting Started tutorial and CLI Reference 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Configure caching and security headers for Cloudflare Pages: - Aggressive caching for versioned assets (1 year, immutable) - Week-long caching for images - Security headers (nosniff, DENY framing, strict referrer) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
headjack | 44de801 | Commit Preview URL Branch Preview URL |
Jan 02 2026, 07:19 PM |
Configure wrangler.jsonc to point to the build directory for static asset deployment via Cloudflare Workers Builds. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Write comprehensive documentation using Diataxis methodology: Tutorials (4 pages): - Getting started, first coding task, parallel agents, custom images How-To Guides (8 pages, consolidated from 15): - Install, authenticate (combined 3 agent guides), manage sessions (combined 4 guides), stop/cleanup, recover from crash, build custom images (combined 2 guides), troubleshoot auth Reference (17 pages): - All CLI commands, configuration, environment, storage, image overview and labels Explanation (8 pages): - Architecture, isolation model, CLI agents vs API, worktree strategy, session lifecycle, authentication, image customization, version managers Also fix bug in run.go where --agent flag help text was unclear. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
jmgilman
added a commit
that referenced
this pull request
Jan 3, 2026
Current behavior: N/A - new feature New behavior: Complete documentation site using Docusaurus with Diataxis methodology including tutorials, how-to guides, reference pages, and architectural explanations. Includes comprehensive content for all CLI commands, configuration options, and development workflows with Cloudflare Pages deployment configuration. Closes: #28
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation Structure
Test plan
🤖 Generated with Claude Code