gtkb-bridge-propose

What problem does it solve?

It helps you draft and persist implementation bridge proposals that are safe to store and reviewable by enforcing credential-scan redaction, mandatory specification linkage, and concurrency-safe updates to the bridge index.

Core Features & Use Cases

• Credential-safe proposal persistence: scans proposal bodies against credential catalogs and either aborts or redacts credential-shaped spans before any file is written.
• Mandatory specification linkage gate: requires a Specification Links section with concrete spec IDs or governing rule file paths and rejects placeholder-only submissions.
• Governance-ready bridge artifacts: writes the proposal to bridge/<topic>-001.md and inserts a Document + NEW entry into bridge/INDEX.md with atomic, retry-safe concurrency handling.
• Prior deliberations pre-population: optionally pre-populates the proposal’s Prior Deliberations section using glossary seeding plus best-effort semantic retrieval for faster review and pruning.

Quick Start

Use gtkb-bridge-propose to create a new bridge proposal for a topic by providing the topic slug and proposal body with a filled Specification Links section so the helper can write bridge/<topic>-001.md and update bridge/INDEX.md.