Skip to content

chore: introspect-v2 migration incomplete on development — 28 deprecated docs/introspections records + write-target contradiction (needs operator) #214

Description

@domattioli

Problem

introspect-v2 (DomI #296) migrates session introspections from the repo-local docs/introspections/ to DomI's central corpus .introspect/CHILmesh/. PR #212 deleted docs/introspections/ on main and archived 32 CHILmesh records upstream. The migration is incomplete, in two compounding ways:

  1. development still carries 28 deprecated records that main deleted. Merging the rolling development → main PR (chore: rolling development → main (DomI pin a9b240f + docstring dedup) #213) would re-add them to main. They are already archived in DomI .introspect/CHILmesh/ (32 records), so this is the "v2 follow-up sweep" PR chore: migrate introspections to DomI central corpus (.introspect/) #212 explicitly deferred.

  2. main itself re-grew 5 records (development_2b6923e, 83f6229, ae77ee1, f06a0ad, fef9cf9) — created on development after chore: migrate introspections to DomI central corpus (.introspect/) #212 and carried into main by rolling PR chore: spec-010 v3 — DomI-managed workflow copies, label-sync dedup #210. So the dir is still actively written to.

Root cause — write-target contradiction

The reason it keeps re-growing: sessions still write introspections to docs/introspections/ because:

  • DomI CLAUDE.md (authority) says introspections go to .introspect/<RepoName>/ (central corpus) — but that path lives in the DomI repo.
  • CHILmesh is a pull-only consumer (DomI sync contract: "DomI never edits downstream; downstream never edits DomI").
  • The rotation invariant is one repo per session, no cross-repo writes (only the DomI slot edits DomI).
  • The overhaul rotation instructions say "introspection → own repo corpus" — which for CHILmesh can only mean docs/introspections/.

So a CHILmesh routine session has no compliant way to write to DomI's .introspect/CHILmesh/, and falls back to the deprecated dir. The migration cannot complete from autonomous CHILmesh sessions alone.

What's needed (operator / DomI-governance decision)

  1. Decide the durable write path for downstream-repo introspections under introspect-v2 (e.g. a DomI-side collector workflow that ingests from a downstream surface, or an explicit "downstream repos keep a local corpus" carve-out). Until decided, downstream sessions keep regrowing the deprecated dir.
  2. Sweep development: delete the 28 deprecated docs/introspections/* (and .planning/introspections/) once confirmed all are archived upstream, so chore: rolling development → main (DomI pin a9b240f + docstring dedup) #213 doesn't re-add them to main.
  3. Update CHILmesh CLAUDE.md + the rotation instructions to state the agreed write path unambiguously.

Filed by the hour-18 CHILmesh rotation session (maintenance track). Not auto-reconciled — CLAUDE.md warns against autonomous bulk reconciliation, and item 1 is a governance decision, not a code fix.

[repo: CHILmesh · session: 2026-06-15T18Z-rotation · refs: DomI#296, #212, #210, #213]

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

    domi-syncAuto-opened downstream sync issue; consumed by sync-from-domi. Do not strip.status: brainstormingDesign phase; not yet implementable. Agents do NOT open a PR while in this state.type: choreTooling/maintenance/dependencies.

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions