session-start-check

Detect overlapping code-path edits between concurrent Claude sessions.

Updated May 14, 2024
One-click install
npx skills add https://github.com/wagnerra23/oimpresso.com --skill session-start-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-start-check
Source: https://github.com/wagnerra23/oimpresso.com/tree/main/.claude/skills/session-start-check
Command: npx skills add https://github.com/wagnerra23/oimpresso.com --skill session-start-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents avoidable merge conflicts and duplicated effort by passively alerting when another developer’s Claude session has recently touched overlapping code paths.

Core Features & Use Cases

  • Session-aware coordination (non-blocking): Calls the MCP tool to check whether another session is active in the recent time window and raises a one-line overlap warning only when relevant.
  • Targeted overlap heuristic: Compares the other session’s touched paths with the module/file you intend to modify, then either stays silent or emits a brief confirmation prompt.
  • Operational safety guardrails: Skips checks for very short sessions, tool unavailability, or explicit instructions to ignore during debugging, and avoids repeated tool calls within the same session.

Quick Start

After running brief-fetch, ask your system to run session-start-check so it calls whats-active and issues a short overlap warning only if needed.

Frequently Asked Questions about session-start-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent merge conflicts when running multiple Claude coding sessions in parallel?

To prevent merge conflicts during parallel Claude coding sessions, run a session-start-check to detect recent overlapping code-path edits. This passive alert warns you early if another concurrent session has touched the same files, reducing duplicated effort.

How does concurrent session coordination work for Laravel module development?

Concurrent session coordination for Laravel modules works by calling the whats-active MCP tool to check recent developer activity. It performs a path-overlap comparison against your intended files and issues a brief warning only if another session recently modified the same code paths.

Do I need a specific MCP tool to check for code overlap between sessions?

Yes, you need to call the whats-active MCP tool to check for code overlap between sessions. It queries recent active sessions within default time windows, allowing the system to perform path-overlap comparisons and decide whether to emit a passive coordination alert.

When should I skip session overlap warnings during development?

You should skip session overlap warnings during very short sessions, when the MCP tool is unavailable, or when explicitly instructed to ignore checks during debugging. The system also avoids repeated tool calls within the same session to maintain operational safety.

Can I use session-start-check for Tier-1 parallelism scenarios in the oimpresso project?

Yes, you can use session-start-check for Tier-1 parallelism scenarios defined in ADR 0119 within the oimpresso project. It is designed to run after brief-fetch for any agent or human session to coordinate overlapping code paths.

What is the best way to avoid duplicated work with AI-driven coding agents?

The best way to avoid duplicated work with AI-driven coding agents is to passively alert developers about overlapping code paths at session start. By comparing intended file modifications with recent concurrent session activity, it prevents duplicated effort before it happens.