This directory contains design specifications and reference materials for Orbit.
| Prefix | Category | Description |
|---|---|---|
spec- |
Design specification | Detailed internal design decisions and structural contracts |
| (none) | Reference material | Comparisons, guides, and other supplementary information |
| Document | Description |
|---|---|
| spec-worktree.md | The worktree model: root decision, config ownership, fetch discipline, branching strategy, push routing, git dependency closure |
| spec-commands.md | Command interface design and argument conventions |
| spec-directory.md | Directory structure layout and anchor rules |
| spec-knowledge.md | Knowledge system: progressive loading, staleness detection, and memo lifecycle |
| spec-lifecycle.md | Workspace lifecycle (new → add → done → prune, reactivation via goal) |
| spec-metadata.md | Metadata formats (git-config INI + Markdown) |
| spec-warnings.md | Registry of stderr guidance warnings (the steering channel) and their format contract |
| Document | Description |
|---|---|
| comparison.md | Comparison with workspace management and agent context tools |
| recipes.md | Common scenario cookbook |