ODF docs
GitHub ↗
Documentation menu

ODF Docs

2 min read

Everything about ODF — spec-driven Odoo delivery on OpenCode. Pick what you need:

I want to… Read
Start using ODF — mental model, commands, workflow, stopping safely Intended usage
Understand the system — stages, components, data flow Architecture
Check a route — every work type, stage, artifact, and gate Route & stage contract
Extend the plugin — the 29 tools, odf_delegate path Plugin reference
Write a skill — structure, frontmatter, compact rules, validation Skill style guide
Measure routing quality — decision report, local reviews, cadence Decision evaluation

#What changed in 1.6.2

Area Change
Docs site Every documentation link renders as a styled page with a grouped sidebar, in-page TOC, breadcrumbs, prev/next, reading time, search palette, 404, sitemap, and robots.
Generation npm run docs:build renders 25 sources; npm run docs:check runs in CI and fails on stale output.
Privacy No personal paths in shipped files: the installers rewrite any /home/<user>/.config/opencode, skill metadata uses the project handle, and the timesheet binary is rebuilt with -trimpath.
Guardrails A privacy test fails the suite when a published file gains a home path, provider email, private key, token format, URL with credentials, or literal password.

1.6.1 introduced feature-inline with its conditional ASSESS gate, the Context Manifest, decision-quality evaluation, stop_disposition, persisted next_handoff, and project-scoped activation. Full detail: CHANGELOG.md.

#Diagrams

Interactive, self-contained HTML (open locally or via GitHub Pages):

Diagram Shows
Phase flow & agent routing full pipeline, fast routes, capability routing
Harness architecture operator → orchestrator → plugin → fleet → Odoo
One-call delegation efficiency ODF single round-trip vs naive context loop

Sources next to each HTML: *.workflow.json / *.spec.json (Archify schema).

#Contracts

Normative rules enforced by the pipeline — agents and tests read these.

Doc Governs
Route & stage contract work types, route matrix, stage/artifact/gate requirements
Design contract closed-design rules before BUILD
Expectations contract human-owned Expectations, revisions
Context contract bounded, reference-only Context Manifest
Safety contract pre-tool safety, DB guardrails
Judge shadow contract adversarial review shadow
Learning loop contract Engram learning loop

#Operations

Doc Covers
Metrics & Engram maintenance telemetry upkeep, evaluation commands
Decision evaluation decision-quality report, local reviews, agreement, cadence, proposals

#History

Doc Was
Archive completed roadmaps, fast-lane plans, baselines