← graph

doc-sync-audit

Synthesis: harmonize doc-sync audit findings, resolve cross-doc conflicts, make final commits

Metadata

Statusdone
Assignedagent-1252
Agent identityf51439356729d112a6c404803d88015d5b44832c6c584c62b96732b63c2b0c7e
Modelclaude:opus
Created2026-04-30T02:03:31.874247460+00:00
Started2026-04-30T02:43:44.781543384+00:00
Completed2026-04-30T03:11:44.123177805+00:00
Tagsfix,docs, eval-scheduled
Eval score0.92
└ blocking impact0.90
└ completeness0.92
└ coordination overhead0.88
└ correctness0.95
└ downstream usability0.90
└ efficiency0.85
└ intent fidelity0.93
└ style adherence0.93

Description

Description

Fan-in synthesis task. Reads the 12 parallel audit tasks' findings (each covers one doc file or topic sweep) and produces:

  1. A consolidated audit report at docs/doc-sync-audit-2026-04-29.md (mirrors the 2026-04-12 audit structure)
  2. Resolution of conflicts where audits disagree (e.g., terminology drift — one doc says 'coordinator', another says 'dispatcher')
  3. ALL identified doc updates applied across files in coherent commits — this task EDITS the doc files, it doesn't just report
  4. A task-log note marking this run as suitable for wg func extract so the fan-out+synthesis pattern becomes a reusable doc-sync function for future application

Read these 12 audit task logs first

Per-file audits (8):

  • audit-readme-md
  • audit-docs-commands (COMMANDS.md vs wg --help-all)
  • audit-docs-key (KEY_DOCS.md link liveness + index coverage)
  • audit-claude-md (post-reorg layer-2 verification)
  • audit-skill-md
  • audit-wg-quickstart (quickstart text + setup wizard)
  • audit-wg-agent (the new bundled agent-guide)
  • audit-docs-config (config-ux-design.md + family)

Topic sweeps (4):

  • audit-every-wg (every wg command appears in some user-facing doc)
  • audit-terminology-consistency (dispatcher / chat agent / worker, nex: vs local:, etc.)
  • audit-docs-designs (contributor-only headers + supersession flagging)
  • audit-docs-research (historical / relevance assessment)

Synthesis steps

  1. wg log <each-audit-id> --list → collect each audit's structured delta list
  2. Identify conflicts between audits (same string referenced inconsistently across zones)
  3. For each conflict, pick the canonical version (usually whichever matches current CLI output / shipped behavior; refer to CLAUDE.md glossary for term canon)
  4. Apply ALL identified updates to the relevant doc files
  5. Group into logical commits (e.g., 'docs: update COMMANDS.md for new commands', 'docs: align role contract references with agent-guide bundle', 'docs: rename remaining local:/oai-compat: to nex:')
  6. Write the consolidated audit doc summarizing what was found and updated
  7. Note in task log that this run is a candidate for wg func extract

Validation

  • Consolidated audit doc exists at docs/doc-sync-audit-2026-04-29.md with structure matching the 2026-04-12 baseline
  • Every audit task's delta items either resolved (applied to docs) or explicitly noted as deferred with reason
  • Cross-doc terminology consistent — no doc says 'coordinator' where another says 'dispatcher'; nex: is the canonical model prefix everywhere user-facing
  • grep checks pass: zero local: or oai-compat: outside back-compat mentions; zero wgnext outside back-compat mentions; zero amplifier references unless remove-amplifier-executor task hasn't landed yet (then deferred to that task)
  • Every command in wg --help-all appears in COMMANDS.md
  • Every non-archive file in docs/ is indexed in KEY_DOCS.md OR has a 'contributor-only' / 'historical' header
  • Task log notes the wg func extract candidacy with the 12-audit list as the function template
  • cargo build + cargo test pass (in case any code-adjacent docs trigger build steps)
  • No source code changes (docs only)

Depends on

Required by

Log