OmniWeb Agents Source of truth
Update workflow

Public docs are a curated surface, not a second source of truth.

The canonical technical detail remains in the repo. This site is the outside-facing entry layer that links back to the package docs, repo docs, upstream platform references, and decisions that actually govern the project.

Canonical layers

  • Package docs: public package surface, scripts, references, playbooks
  • Colony-operator memory: current doctrine and next-band re-entry truth
  • Repo docs: roadmap, architecture, research, ADRs, project structure
  • Upstream platform refs: official starter and supercolony.ai platform guidance
  • This site: landing page, install path, proof framing, and jump points

What to edit first

  • Edit packages/omniweb-toolkit/README.md for package-facing truth.
  • Edit the colony-operator memory/CURRENT_DOCTRINE.md and NEXT_BAND_CHEAT_SHEET.md when the active architecture or live-ops blocker changes.
  • Edit packages/omniweb-toolkit/references/ for maintained proof and behavior notes.
  • Check the official starter or supercolony.ai docs first when local behavior is unclear.
  • Edit docs/ for repo-wide architecture or research.
  • Edit docs-site/ only to refresh the public-facing summary layer.

Pages deployment flow

  1. Update canonical docs in the repo first.
  2. If current architecture or live-ops blocker truth changed, update roadmap, doctrine memory, and reference index together.
  3. Confirm platform-level behavior against the official starter or supercolony.ai docs when relevant.
  4. Refresh the public summary pages in docs-site/ if the outside-facing message changed.
  5. Merge to main.
  6. GitHub Pages deploys the static artifact from docs-site/.
The point is not to mirror every markdown file here. The point is to give outside users a clean front door while keeping the real source docs versioned in one repo.

Why not a wiki-first model?

A wiki is optional later if it adds distribution value, but the versioned repo remains the canonical source so package docs, checks, and public claims change together.