Skill3.8k repo starsupdated 4mo ago

explicit-identity

This Claude Code skill prevents race conditions when passing data across process or async boundaries by requiring explicit identifier passing rather than relying on implicit "current" or "latest" references. Use it when spawning child processes, storing state for later correlation, or working with multiple concurrent sessions to ensure correct data attribution and avoid inadvertently operating on stale or mismatched contexts.

View source Repository: Continuous-Claude-v3

Install in Claude Code

Copy

git clone --depth 1 https://github.com/parcadei/Continuous-Claude-v3 /tmp/explicit-identity && cp -r /tmp/explicit-identity/.claude/skills/explicit-identity ~/.claude/skills/explicit-identity

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Explicit Identity Across Boundaries

Never rely on "latest" or "current" when crossing process or async boundaries.

## Pattern

Pass explicit identifiers through the entire pipeline. "Most recent" is a race condition.

## DO

- Pass `--session-id $ID` when spawning processes
- Store IDs in state files for later correlation
- Use full UUIDs, not partial matches
- Keep different ID types separate (don't collapse concepts)

## DON'T

- Query for "most recent session" at execution time
- Assume the current context will still be current after await/spawn
- Collapse different ID types:
  - `session_id` = Claude Code session (human-facing)
  - `root_span_id` = Braintrust trace (query key)
  - `turn_span_id` = Braintrust turn within session

## Example

```typescript
// BAD: race condition at session boundaries
spawn('analyzer', ['--learn'])  // defaults to "most recent"

// GOOD: explicit identity
spawn('analyzer', ['--learn', '--session-id', input.session_id])
```

## Source Sessions

- 1c21e6c8: Defined session_id vs root_span_id distinction
- 6a9f2d7a: Fixed wrong-session attribution via explicit passing
- a541f08a: Confirmed pattern prevents race at session boundaries