 Bo
|
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 |
|
|
Bo
|
dde214825b
|
docs(3.0): ag-p7j W1 — delete daemon contracts, regen generated docs, reframe skills (ag-p7j) (#529)
W1 (structural) of the 3-way ag-p7j doc-sweep. Owns
shared/generated/structural artifacts + skills + contracts. Disjoint
from W2 (#527, core narrative) and W3 (#528, peripheral docs), both
already merged; this branch is rebased on top of them.
## Deleted (deleted-surface docs)
-
`docs/contracts/{agentops-daemon,ao-watch,daemon-idempotency,dream-run-contract,agent-worker,ao-outcomes,openclaw-consumer-api,gascity-integration}.md`
- `docs/code-map/agentopsd-codebase-map.md`
- `gascity-integration.md` deleted because it described the OLD
daemon↔GasCity adapter (`ao daemon run --executor-policy=gascity`,
daemon ledger, OpenClaw consumer endpoints). The current GC story is the
using-gc skill + the reference City.
- Removed every deleted doc's row from `docs/documentation-index.md`,
`docs/contracts/index.md`, and `mkdocs.yml` nav.
## Regenerated (generators, not hand-edited)
- `docs/cli-surface.{md,json}` via `check-cmdao-surface-parity.sh
--write-surface` — daemon/schedule/overnight/plans/watch/factory rows
gone (live `ao` binary no longer registers them; the docs were stale).
- `registry.json`, `skills/catalog.json`, SKU catalog, codex
`.agentops-generated.json` hashes + manifest.
- Skill counts verified in sync (81 skills).
## Reframed to in-session / GC / hookless
- Skills: `dream` (+codex twin, neutralized literal `agentopsd`/`ao
schedule`/`ao overnight`/`ao watch`/`ao plans` while keeping the
retirement message), `compile` (+codex), `scaffold/recommended-reading`
(+codex), `discovery/best-practices`, `validation/best-practices`.
- Generated narrative: `docs/SKILLS.md` /dream block,
`docs/ARCHITECTURE.md` dream paragraph, `skills/SKILL-TIERS.md` dream
row.
- Contracts prose: `docs/contracts/ubiquitous-language.md`,
`docs/contracts/agents-write-surfaces.md` (kept catalog rows for
surviving load-bearing-lane subdirs; dropped deleted-command references
in descriptions).
## 3.0.md:150
Restored the strong claim: "...gone from the CLI **and from live doc
prose** (only historical surfaces — ADRs, the CHANGELOG, release notes,
and the 3.0 migration record — still name them, by design)"; kept the
`validate-sku-catalog-drift` linkage-gate mention.
## Collateral (minimal dead-link repairs to my deleted targets)
- `docs/daemon-migration.md` (gascity-integration link →
dependencies.md), `cli/README.md` (dropped dream-run-contract link). The
comparisons-file dead link was resolved by W3's merge.
## Gates (all green locally)
doc-release (2765 links, 0 broken) · contract-compatibility (0 failures)
· structural-floor · agents-write-surfaces · registry --check ·
validate-sku-catalog-drift · validate-ci-policy-parity ·
validate-skill-cli-snippets · validate-codex-runtime-sections · codex
parity (5 skills) + regen-codex-hashes --check · skill-catalog drift ·
cli-skills-map · markdownlint (changed files) · mkdocs --strict · `cd
cli && go build ./...`
Closes-scenario: ag-p7j#w1-structural
Bounded-context: BC1-Corpus
Evidence: docs/3.0.md
|
2026-05-24 21:55:17 -04:00 |
|