Skip to content

Synchronize documentation with integrated behavior #185

Description

@metaphorics

Question

After the integrated public surface settles, run sync-docs in before-release scope against the repository's remote default branch. Enumerate changed public source, manifests, configuration, and CLI surfaces; derive exact filenames, import paths, exported symbols, flags, versions, and observable behavior; then map them to README.md, CHANGELOG.md, root Markdown, and docs/**/*.md. Apply only mechanically exact version-label replacements and a restrained ## [Unreleased] entry. Flag every semantic example, removed export, import-path, behavior, and prose change for deliberate repair with source and line evidence. Then repair those flagged items under their owning refactor tickets and re-run the mapping until no drift remains.

Do not guess replacement examples, mass-replace version-looking numbers, rewrite generated snapshots, or treat append-only changelog history as drift.

Blocked by


Child issue mapping (2026-08-31)

The ten documentation/residue children that feed this ticket:

Symbolic name Issue Title Blockers
DRB-1 #189 [DRB-1] Correct false release-gate prose in runbook and changelog #163, #179
DRB-2 #190 [DRB-2] Consolidate volatile package and product status claims #163, #168, #183, #180
DRB-3 #191 [DRB-3] Reconcile CLI docs against parser and dispatch evidence #163, #168, #179, #170
DRB-4 #192 Prove .agents/ reachability and strip copied facts from developer-audience-context external harness convention
DRB-5 #195 Compress documentation hierarchy to one owner per fact #190 (DRB-2), #191 (DRB-3)
DRB-6 #193 Purge regenerable ignored cache/worktree residue under recovery rules workspace-owner consent, idle window
DRB-8 #196 DRB-8: Unify bench/ E5 and perf/ schema-v2 performance authority #163, #170, #191 (DRB-3)
DRB-9 #194 DRB-9: Compress formal policy and generated-output carriers through the formal integrator formal cluster integrator, P0.7 freeze
DRB-11 #197 DRB-11: Reset CHANGELOG.md to user-visible history #189 (DRB-1), #190 (DRB-2, minor), #187 (DRB-7/root-ownership, minor)
DRB-12 #198 DRB-12: Classify missing stage-1 and S1-S11 baseline/scorecard artifacts #196 (DRB-8), #193 (DRB-6, minor)

Not children (reused, not duplicated):

Dependency ordering note: DRB-8 (#196) → DRB-12 (#198). DRB-8 does not depend on DRB-12. No cycle.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    wayfinder:taskDecision prerequisite ticket

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions