When should I use explicit identity patterns?

You should use these patterns whenever you are spawning child processes, using IDs as database query keys, or passing state through a long-running pipeline.

Why avoid 'latest' session queries?

Querying for the 'most recent' session is a race condition. If two processes start nearly simultaneously, the wrong context could be retrieved by the second process.

How does this skill help with observability?

It enforces strict separation between session IDs, root span IDs, and turn span IDs, allowing tools like Braintrust to accurately map every action to the correct trace.

What are async boundaries?

Async boundaries occur when code waits for a task (await) or spawns a new process. In these moments, the 'current' state might change before execution finishes, leading to errors.

Explicit Identity Management

Name: Explicit Identity Management
Author: scooter-lacroix

byscooter-lacroix

0•

Analytics & Monitoring

Enforces unique identifier usage across process and asynchronous boundaries to eliminate race conditions and ensure data integrity.

The Explicit Identity skill provides Claude with specialized architectural guidance to prevent common state-related bugs in complex software systems. By mandating the use of explicit UUIDs and session identifiers instead of relying on fragile 'latest' or 'current' references, it ensures that logs, traces, and state transitions are accurately attributed across execution contexts. This pattern is essential for developers working with distributed systems, multi-process architectures, or advanced observability tools where precise correlation between disparate tasks is critical for reliability.

Key Features

01Eliminates race conditions by banning 'latest' state references

02Distinguishes between session, root span, and turn span identifiers

03Enforces the use of full UUIDs for precise data correlation

040 GitHub stars

05Mandates explicit session ID passing across process boundaries

06Standardizes state file storage for reliable later correlation

Use Cases

01Managing concurrent developer sessions without data leakage or overlap

02Debugging complex asynchronous pipelines with reliable audit trails

03Implementing distributed tracing in microservices or multi-process applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add scooter-lacroix/maestro explicit-identity

For use in Claude.ai and ChatGPT

Download Skill