032998a11c
docs: reconcile narrative docs with retired daemon/Gas-City + reframe Anthropic claim (ag-6v3j #convergent) ( #708 )
...
## What
Second-wave staleness fixes for **removed infrastructure presented as
live**, plus the operator-approved PRODUCT.md reframe (ag-6v3j).
Verified against `cli/**` (`ao daemon`/`ao overnight` → "unknown
command"), `docs/3.0.md`, and `docs/dependencies.md` (canonical
out-of-session substrate = **NTM + MCP + managed-agents**; Gas City is
not a substrate option — only the gc-*bridge* existed, and it was
removed).
| File | Fix |
|---|---|
| daemon-migration.md | ARCHIVED banner — `agentopsd`/`ao daemon`/`ao
overnight` deleted (soc-2rtm0); body kept only as pre-3.0 record |
| strategic-direction.md:22 | "skills + hooks + ao CLI + scheduling
daemon" → "skills + ao CLI + CDLC loop; hookless, no daemon;
NTM/MCP/managed-agents" |
| agentops-3-explainer-kit.md | "Gas City reference City" out-of-session
lane → NTM + MCP + managed-agents |
| UPGRADING.md:71 | superseded-daemon banner's "Gas City reference City"
→ swappable substrate |
| PRODUCT.md (ag-6v3j) | line 65 "April 2026 Claude Code source analysis
confirmed..." → "appear to converge … convergent, not derived-from" (no
in-repo source; matches the doc's own hedging at 73/270/331);
`last_reviewed` 2026-05-15 → 2026-06-03; line 205 Gas City → substrate |
## Verification
- `ao daemon --help` / `ao overnight --help` → "unknown command"
(confirmed removed)
- `scripts/sync-skill-counts.sh --check` → clean (PRODUCT.md is a count
target; untouched)
- Residual `agentopsd` mentions remain only under ARCHIVED/Superseded
banners (historical, correct)
## Bead status
- **ag-6v3j** — fully resolved (reframe + temporal).
- **ag-ph6h** — partial: daemon + Gas-City done here; the local-8B "Tier
1" framing (philosophy.md/PRODUCT.md) and `local-compute-routing.md`
relocation remain open (aspirational/structural — left for follow-up).
Closes-scenario: ag-6v3j#convergent
Bounded-context: BC5-Runtime
Evidence: PRODUCT.md
2026-06-03 21:33:26 -04:00
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
ee763750ba
docs: rename PRACTICE.md to PRACTICE-REGISTRY.md + add CDLC narrow-waist doctrine
...
Rescope PRACTICE.md into PRACTICE-REGISTRY.md: it now owns only the
practice-slug lineage registry, not product positioning or CDLC doctrine.
Update all references (schema, validate-practice-citations.sh, bats test,
architecture-terms.md, documentation-index.md, aggregate.go comment).
Introduce the Context Density Rule as a canonical domain concept: every
high-value context token carries intent, boundary, evidence, decision,
constraint, or next action. New domain entry context-density-rule.md (+
codex mirror). Thread the BDD/Gherkin + DDD + Hexagonal + TDD narrow waist
through cdlc.md, README.md, PRODUCT.md, GOALS.md, and the rpi/domain/
post-mortem skills. Sync codex artifacts.
2026-05-15 20:16:53 -04:00
Bo