Skip to content

chore: document Serena's *-mirror projects for cross-repo query_project - #366

Closed
jordigilh wants to merge 1 commit into
mainfrom
chore/serena-mirror-query-guidance
Closed

chore: document Serena's *-mirror projects for cross-repo query_project#366
jordigilh wants to merge 1 commit into
mainfrom
chore/serena-mirror-query-guidance

Conversation

@jordigilh

Copy link
Copy Markdown
Owner

Summary

  • Points agents at the pinned, read-only, auto-synced mirror worktrees
    (kubernaut-mirror, kubernaut-release-v1.5-mirror, etc.) instead of the
    ambiguous interactive dev clone names when a query_project call needs a
    guaranteed branch's state.
  • Prompted by a live incident: a query_project("kubernaut") call silently
    returned stale pre-merge content because that interactive clone happened
    to be checked out on release/v1.5 at the time — none of the
    kubernaut-family's Serena-registered clones are pinned to their namesake
    branch.
  • Full incident/root-cause + the Engram-side mirror registration: see
    jordigilh/engram docs/findings/2026-08.md, 2026-08-16 entry.

Test plan

  • Pre-commit anti-pattern/sensitive-data hook passed
  • Reviewer: docs-only change to .cursor/rules/hindsight-memory.mdc, no
    functional code changes

Points agents at the pinned, read-only, auto-synced mirror worktrees
(kubernaut-mirror, kubernaut-release-v1.5-mirror, etc.) instead of the
ambiguous interactive dev clone names when a query_project call needs a
guaranteed branch's state, after a live incident where a query against
"kubernaut" silently returned stale pre-merge content because that clone
was checked out on release/v1.5 at the time. See jordigilh/engram
docs/findings/2026-08.md, 2026-08-16 entry, for the full incident and fix.
@jordigilh

Copy link
Copy Markdown
Owner Author

Closing without merging: this documents personal Engram/Serena mirror-project tooling (paths like ~/.hindsight/watch, personal serena_config.yml) that other contributors don't have installed, so it shouldn't be persisted into the shared repo history.

@jordigilh jordigilh closed this Aug 17, 2026
@jordigilh
jordigilh deleted the chore/serena-mirror-query-guidance branch August 17, 2026 12:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant