mcpField
E
explicit-identity

explicit-identity

github.com/parcadeiDevelopment3.9k479 installsUpdated 39w ago
Repository

About explicit-identity

A development skill for carrying explicit identifiers across process and asynchronous boundaries. It describes how to avoid race conditions and incorrect attribution by passing and storing distinct IDs.

Key features

  1. 01Pass explicit IDs through workflows
  2. 02Store IDs for later correlation
  3. 03Use full UUIDs
  4. 04Keep ID types distinct
  5. 05Avoid querying for the most recent session

Use cases

  1. 01Correlating spawned processes with a session
  2. 02Preventing attribution to the wrong session
  3. 03Avoiding race conditions across asynchronous boundaries

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill explicit-identity

After installing, type/explicit-identityin Claude Code to confirm it loaded.

Details

From the project README

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

// 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

Comments

Markdown supported