Skip to content

docs: add quick-start and comparison pages - #12

Merged
miles-on-nightshift merged 2 commits into
mainfrom
docs/quick-start-comparison
Aug 28, 2026
Merged

miles-on-nightshift merged 2 commits into
mainfrom
docs/quick-start-comparison

Conversation

@miles-on-nightshift

Copy link
Copy Markdown
Collaborator

Summary

  • Adds docs/quick-start.md — five-minute walkthrough covering workspace loading, task querying, task creation, concurrency, and dependency plans
  • Adds docs/comparison.md — factual comparison vs orgparse and organice for developers choosing a library

Verification

All code examples API-audited against v0.5.3 (installed locally). Every method signature, argument name, and return type verified:

  • OrgWorkspace, Query, Plan, TaskClaim, OptimisticLock, StateConfig
  • ws.create_node, ws.transition, ws.save
  • q.ai_tasks, q.overdue, q.by_property, q.next_action
  • tc.claim, tc.release
  • plan.ready_tasks, plan.blocked_tasks

Context

Timed to support Show HN on Sep 2 and r/emacs post today (Aug 28). Part of H001 (org-workspace 100+ downloads/month) distribution wave.

🤖 Generated with Claude Code

miles-on-nightshift and others added 2 commits August 28, 2026 22:22
API-verified against v0.5.3. Adds docs/ directory with:
- quick-start.md: five-minute walkthrough for AI agent developers
- comparison.md: factual comparison vs orgparse and organice

Timed to support Show HN (Sep 2) and the r/emacs post (Aug 28).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@miles-on-nightshift
miles-on-nightshift merged commit 0f3729b into main Aug 28, 2026
5 checks passed
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.

1 participant