bridge-file

Read and write shared bridge directories to coordinate work between Claude sessions.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/pandaworks-software-plt/pandahrms-skills --skill bridge-file
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bridge-file
Source: https://github.com/pandaworks-software-plt/pandahrms-skills/tree/main/skills/bridge-file
Command: npx skills add https://github.com/pandaworks-software-plt/pandahrms-skills --skill bridge-file

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridge-file coordination enables cross-project communication by reading and writing to shared bridge directories, ensuring work between Claude sessions is synchronized and traceable.

Core Features & Use Cases

  • Reads and writes to ~/.claude/bridge to pass issues, notes, specs, and decisions between projects
  • Auto-detects project pairs and provides a structured bridge directory for cross-project collaboration
  • Ensures all bridge-originated tasks are closed with a final "Response" appended to the bridge file

Quick Start

Instruct the Bridge File skill to check or write a bridge message and follow prompts to complete the task.

Frequently Asked Questions about bridge-file

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

FAQPage Schema
How do I coordinate tasks between multiple Claude sessions working on different projects?

Cross-project communication is automated by reading and writing to a shared bridge directory at ~/.claude/bridge, passing issues, notes, specs, and decisions between concurrent Claude sessions to keep work synchronized.

How does cross-project communication handle traceability for passed issues and specs?

Traceability is maintained through an append-only log history within the bridge files, and all bridge-originated tasks must be explicitly closed with a final response appended to the log. This ensures a permanent, sequential record of all cross-project decisions and interactions.

Do I need to manually configure project pairs to use bridge file coordination?

No manual configuration is needed for project pairs because the system auto-detects them and provides a structured bridge directory automatically. You simply instruct the skill to check or write a bridge message and follow the prompts to complete the cross-project task.

What are the rules for safely writing to a shared bridge directory?

Safe bridging requires explicit actions for both reads and writes to the shared directory, preventing accidental overwrites or data loss. This strict interaction protocol ensures that open bridge tasks are properly managed and closed with a final appended response.

What happens if a bridge-originated task is left open without a final response?

Leaving an open bridge task incomplete breaks the open-loop coordination rules, which require all bridge-originated tasks to be explicitly closed with a final response appended to the bridge file to maintain strict traceability.