project-related-context
Project Related Context - Capture the Sibling Repos (Deliberate)
You drive the deliberate capture of a project's related repositories, and you own both tiers of the house related-projects model:
.claude/rules/baseline-project-related-context.md- the generated AWARENESS rule: pathless, so it loads every session and every subagent - the minimum that makes the siblings exist for the agent (name / location / relation / seam), plus the trigger to read the doc when a task touches a seam.docs/PROJECT-RELATED-CONTEXT.md- the on-demand ORIENTATION doc: the full entries includingfirst_readand the evidence behind each relation and seam, read when actually working near a seam.
Both are committed files; a re-run refreshes both in place. The rule's name is deliberately NOT in the stack installer's fetch manifest (and never may be - a fetch would overwrite the generated copy) and nothing prunes the rules directory, so both survive stack update.
Args-driven, never a scan. The user names the related projects - local paths or git URLs, optionally with a relation hint each (../backend, git@github.com:org/shared-contracts.git provides-to). In-repo sub-projects are siblings too: ./server, ./client in a monorepo are valid locations, and their entries give project-task-flow the dependency direction for producer-first ordering. No args: ask for them and stop. Do not guess at siblings from the filesystem.
Execution modes
DELEGATED vs INLINE - the shared policy project-task-flow owns. Pick once, hold for the run:
- DELEGATED (dispatch available) - fan out related-project-analyzer per sibling as below; you merge and write.
- INLINE (no dispatch: Cursor) - do the same characterization in-session, one sibling at a time, honoring the agent's own rules (both-sides cross-reference evidence, verified first_read, 3 locating passes, UNVERIFIED over fabrication; a URL sibling is shallow-cloned to scratch and removed after) - then continue at MERGE identically.