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.