Files
Bo 631b34465d docs(3.0): ag-p7j W3 — reframe peripheral docs to in-session (ag-p7j) (#528)
## What

Worker 3 of the ag-p7j 3-way swarm reconciling stale daemon/scheduler
references for AgentOps 3.0. This worker owns the **peripheral docs**
(comparisons, examples, runbooks, plans, brainstorms, the daemon-jobspec
RFC) — pure prose edits only.

The standalone daemon (`ao daemon` / `agentopsd`), scheduler (`ao
schedule`), and overnight runner (`ao overnight`) were **deleted** in
the 3.0 rearchitecture
([ADR-0009](https://github.com/boshu2/agentops/blob/main/docs/adr/ADR-0009-daemon-deletion-in-session-only.md)).
AgentOps is **in-session only**; out-of-session orchestration is
delegated to the **Gas City reference City**. This PR mirrors
`docs/3.0.md` across the peripheral surface.

## Files changed (12)

- **Comparisons** — reframe the "off-API daemon" *feature* claim to
off-API/off-vendor **in-session operation + Gas City out-of-session
dispatch**; drop the deleted `dream-run-contract` link:
  - `docs/comparisons/competition-rpi-memory-pipelines.md`
  - `docs/comparisons/competitive-radar.md`
  - `docs/comparisons/vs-everything-claude-code.md`
  - `docs/comparisons/vs-tons-of-skills.md`
- **Examples** — replace `ao daemon`/`ao schedule` snippets with
mayor-driven `ao rpi` dispatch on the reference City; reframe
"daemon-first" → "automation-first out-of-session orchestration":
  - `docs/examples/agentops-3-council-demo-storyboard.md`
  - `docs/examples/agentops-3-domain-practice-packet.md`
  - `docs/agentops-3-explainer-kit.md`
- **Patterns** — rewrite Pattern C from `ao daemon` log tailing to
**substrate (Gas City) event tailing**:
  - `docs/patterns/completion-notifications.md`
- **Runbooks** — add 3.0 historical banners, neutralize `ao daemon jobs
submit`/`agentopsd`/`ao overnight` instructions, drop deleted
daemon-contract refs; host systemd timer reframed as host-OS timing (not
an AgentOps scheduler):
  - `docs/runbooks/nightly-evolution.md`
  - `docs/runbooks/autonomy-runtime-cycle-1.md`
- **Plans / Brainstorms** — dated historical artifacts: one-line
historical note + neutralize only active "use `ao overnight`"
instructions; remove the deleted `agentopsd` code-map reference:
  - `docs/plans/2026-05-11-evolution-roadmap.md`
-
`docs/brainstorms/2026-04-12-compiled-knowledge-workspace-requirements.md`

`docs/rfcs/0002-jobspec-openapi-v0.md` already carried the requested
superseded/historical banner (body retained), so it needed no change.

## Gate results

- `markdownlint --config .markdownlint.json` (12 changed files):
**PASS**
- `tests/docs/validate-doc-release.sh`: **PASS**
- `mkdocs build --strict`: **PASS** (0 warnings/errors attributable to
changed files)
- All 13 new ADR/contract relative links resolve; **no links to deleted
daemon contracts** remain.
- Grep of changed files for `ao daemon|agentopsd|ao schedule|ao
overnight|ao plans|ao watch`: only historical banners, explicit
disavowals ("no AgentOps daemon"), surviving real script names
(`scripts/install-nightly-scheduler.sh`), and dated-brainstorm
descriptive context covered by its banner. No active "use X"
instructions remain.
- diff stat: 164 insertions / 101 deletions — proportionate, no
anomalous data loss.

Closes-scenario: ag-p7j#w3-peripheral
Bounded-context: BC1-Corpus
Evidence: docs/comparisons/competitive-radar.md
2026-05-24 21:20:11 -04:00
..