From 9b990aebff958adbd957293c99edf326af64c47b Mon Sep 17 00:00:00 2001 From: Jordan Burger Date: Tue, 23 Jun 2026 14:10:00 -0400 Subject: [PATCH] feat(claude-sessions): narrate the instance's own development MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Upstreamed from accumulated instance experience into the claude-sessions outbound-scan (assembles into SKILL only, requires: claude_sessions): Work on the system itself — commits/PRs against the engine/plugin or a companion app, sessions spent building the instance — is invisible to the standard connector scans, which target the user's work product. Sweep the instance's own dev repos' git deltas each run and narrate them, surfacing an instance-owned open/stale PR like any work-product PR. The repo set is parameterized: read from this instance's configuration, never hardcoded — no user paths, no private-repo names. Generic rule; originating example (which named specific repos/paths) dropped. Co-Authored-By: Claude Opus 4.8 (1M context) --- CHANGELOG.md | 3 +++ phases/connectors/claude-sessions.md | 13 +++++++++++++ 2 files changed, 16 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index ee62a93..57839fd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,9 @@ this project adheres to [Semantic Versioning](https://semver.org/). ## [Unreleased] +### Added +- **Narrate the instance's own development** (`phases/connectors/claude-sessions.md`) — a rule upstreamed from accumulated instance experience: work *on the system itself* (commits/PRs against the engine/plugin or a companion app, sessions spent building the instance) is invisible to the standard connector scans, which target the user's work product. Sweep the instance's own dev repos' git deltas each run and narrate them, surfacing an instance-owned open/stale PR like any work-product PR. The repo set is **parameterized** — read from this instance's configuration; no hardcoded user paths or private-repo names. + ## [0.7.2] - 2026-06-22 diff --git a/phases/connectors/claude-sessions.md b/phases/connectors/claude-sessions.md index 89e34b9..9ac437a 100644 --- a/phases/connectors/claude-sessions.md +++ b/phases/connectors/claude-sessions.md @@ -62,6 +62,19 @@ A session may have changed files that were never committed — invisible to `git cd && git status --porcelain && git log --since='' --oneline ``` +### Narrate {{INSTANCE_NAME}}'s Own Development + +{{INSTANCE_NAME}} maintains its own codebase, and {{USER_NAME}}'s work *on the system itself* is a real signal the standard connector scans miss — those scans target {{USER_NAME}}'s work product (the repos and trackers tied to projects), not the instance's own development. So commits and PRs against the engine/plugin or a companion app, and sessions spent building {{INSTANCE_NAME}}, go invisible unless swept explicitly. + +The vault's own git delta is already narrated (see the Git Setup phase). Extend the **same treatment to the instance's other repositories** — an engine/plugin checkout, a desktop or mobile app — each run: + +```bash +# For each instance-owned dev repo (read from this instance's configuration, not hardcoded): +git -C log --since='' --oneline --shortstat +``` + +Narrate the deltas in the run summary, and surface an instance-owned PR that's open and waiting on review (or stale ≥48h) in the action items just as a work-product PR would be. **Parameterize the repo set** — read it from this instance's configuration; never hardcode an absolute user path or a specific private-repo name. An instance whose only repo is its vault simply relies on the vault narration. + ### Claim Gate — No "Actively Building X" Without a Cited Signal Do not assert that {{USER_NAME}} "is actively building / working on X" unless you can cite a concrete signal: a session JSONL with matching prompts, a commit SHA, an open PR, or dirty working-tree files. A session *title* or a single prompt is weak evidence — tie the claim to the tangible artifact, or downgrade it to "{{USER_NAME}} opened a session about X" rather than asserting active work.