planning-with-files-lean-spec-bridge

Generate COORDINATION_LEANSPEC.md and align SpecRef and ExecutionPlan references.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/sunzhk/shared-skills --skill planning-with-files-lean-spec-bridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-with-files-lean-spec-bridge
Source: https://github.com/sunzhk/shared-skills/tree/main/planning-with-files-lean-spec-bridge
Command: npx skills add https://github.com/sunzhk/shared-skills --skill planning-with-files-lean-spec-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridges LeanSpec specifications with execution plans across specs/ and doc/plans/ to reduce manual coordination and keep references in sync.

Core Features & Use Cases

  • One-click bridge between LeanSpec specs and execution plans, creating and aligning SpecRef/ExecutionPlan.
  • Copy coordination documents into the repository for local access and collaboration.
  • Maintain bidirectional references while avoiding overwriting user-maintained plans.
  • Clear guidance for users and agents to operate with LeanSpec and planning-with-files-ext in tandem.

Quick Start

Run the bootstrap-bridge.sh to generate COORDINATION_LEANSPEC.md in your repo and begin bridging LeanSpec with doc/plans.

Frequently Asked Questions about planning-with-files-lean-spec-bridge

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

FAQPage Schema
How do I keep LeanSpec specs and execution plans in sync across a monorepo?

To keep LeanSpec specs and execution plans in sync, you can bridge them by generating SpecRef and ExecutionPlan references across the specs/ and doc/plans/ directories. This creates bidirectional links to coordinate requirements and progress with minimal manual steps.

What is the bridge between LeanSpec specifications and doc/plans used for?

The LeanSpec bridge consolidates specification governance and execution planning. It aligns SpecRef and ExecutionPlan references so humans and AI agents can coordinate requirements, plans, and progress without overwriting user-maintained plans.

How do I generate coordination documents for LeanSpec and execution plans?

You generate coordination documents for LeanSpec and execution plans by running the bootstrap-bridge.sh tooling. This script creates the COORDINATION_LEANSPEC.md file in your repository, establishing bidirectional references between your specs and plans.

Do I need existing LeanSpec specs and doc/plans directories to use the bridge?

Yes, bridging LeanSpec specs with execution plans requires existing LeanSpec specs under specs/ and execution plans under doc/plans/. The bootstrap-bridge.sh tooling uses these directories to generate and maintain bidirectional references.

Will bridging LeanSpec specs overwrite my manually maintained execution plans?

Bridging LeanSpec specs maintains bidirectional references while specifically avoiding overwriting your user-maintained execution plans. It aligns SpecRef and ExecutionPlan references to keep coordination documents synchronized without destroying existing content.

Can AI agents use the LeanSpec bridge to coordinate execution plans?

Yes, AI agents can use the LeanSpec bridge to coordinate execution plans. The workflow generates a COORDINATION_LEANSPEC.md file and bidirectional references, enabling both humans and AI agents to coordinate requirements and track progress with minimal manual steps.