Skip to content

Commit da88ca5

Browse files
codeyogi911claude
andcommitted
feat: add "Digging Deeper" guidance to skill for active exploration via entire CLI
Agents consuming context.md now get explicit instructions on when and how to use entire explain/sessions to trace checkpoint references back to raw session evidence, rather than acting on briefing summaries alone. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Entire-Checkpoint: 28a662cc1363
1 parent 7aa4e33 commit da88ca5

2 files changed

Lines changed: 74 additions & 0 deletions

File tree

.claude/skills/reflect/SKILL.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,43 @@ tunes sections to match what their project actually needs.
160160
161161
---
162162
163+
## Digging Deeper from context.md
164+
165+
The injected `context.md` is a briefing — a starting point, not the full story.
166+
When an entry is relevant to your current task, **go deeper before acting on it**.
167+
168+
Each entry includes a checkpoint reference like `(checkpoint 90e2641946db)`.
169+
Use the `entire` CLI to explore the raw evidence behind any signal:
170+
171+
- **Expand a checkpoint** — get the full session context behind a context.md entry:
172+
```bash
173+
entire explain --checkpoint <id> # detailed view with prompts + files
174+
entire explain --checkpoint <id> --full # full parsed transcript
175+
```
176+
177+
- **Browse recent sessions** — find relevant sessions for a topic:
178+
```bash
179+
entire explain # list checkpoints on current branch
180+
entire explain --session <id> # filter to a specific session
181+
entire sessions list # list all sessions across worktrees
182+
```
183+
184+
- **Explain a commit** — understand what happened around a specific change:
185+
```bash
186+
entire explain --commit <sha>
187+
```
188+
189+
**When to dig deeper:**
190+
- An **Open Work** item matches what you're about to do → read the checkpoint transcript to understand what was tried and where it left off
191+
- A **Gotcha** or **Abandoned Approach** seems relevant → verify it's still current and understand the full failure context before working around it
192+
- A **Key Decision** informs your design → read the original discussion to understand constraints that may not fit in a bullet
193+
194+
**When the briefing is enough:**
195+
- The entry gives you a clear, actionable fact (e.g., "use os.path.realpath not abspath")
196+
- You're doing unrelated work and the entry is just background context
197+
198+
---
199+
163200
## Rules
164201
165202
- NEVER read `.entire/metadata/` directly — use `reflect` CLI or `entire` CLI

skill/SKILL.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,43 @@ tunes sections to match what their project actually needs.
160160
161161
---
162162
163+
## Digging Deeper from context.md
164+
165+
The injected `context.md` is a briefing — a starting point, not the full story.
166+
When an entry is relevant to your current task, **go deeper before acting on it**.
167+
168+
Each entry includes a checkpoint reference like `(checkpoint 90e2641946db)`.
169+
Use the `entire` CLI to explore the raw evidence behind any signal:
170+
171+
- **Expand a checkpoint** — get the full session context behind a context.md entry:
172+
```bash
173+
entire explain --checkpoint <id> # detailed view with prompts + files
174+
entire explain --checkpoint <id> --full # full parsed transcript
175+
```
176+
177+
- **Browse recent sessions** — find relevant sessions for a topic:
178+
```bash
179+
entire explain # list checkpoints on current branch
180+
entire explain --session <id> # filter to a specific session
181+
entire sessions list # list all sessions across worktrees
182+
```
183+
184+
- **Explain a commit** — understand what happened around a specific change:
185+
```bash
186+
entire explain --commit <sha>
187+
```
188+
189+
**When to dig deeper:**
190+
- An **Open Work** item matches what you're about to do → read the checkpoint transcript to understand what was tried and where it left off
191+
- A **Gotcha** or **Abandoned Approach** seems relevant → verify it's still current and understand the full failure context before working around it
192+
- A **Key Decision** informs your design → read the original discussion to understand constraints that may not fit in a bullet
193+
194+
**When the briefing is enough:**
195+
- The entry gives you a clear, actionable fact (e.g., "use os.path.realpath not abspath")
196+
- You're doing unrelated work and the entry is just background context
197+
198+
---
199+
163200
## Rules
164201
165202
- NEVER read `.entire/metadata/` directly — use `reflect` CLI or `entire` CLI

0 commit comments

Comments
 (0)