Skip to content

Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) for the spec-bridge-v2 project.

Format

Each ADR follows this structure:

  • Status: Proposed | Accepted | Deprecated | Superseded
  • Date: YYYY-MM-DD
  • Deciders: Team or person responsible
  • Context: Why was this decision needed?
  • Decision: What was decided?
  • Rationale: Why this option over alternatives?
  • Consequences: What are the positive and negative effects?

Index

ADR Title Status Date
0001 spec-bridge-skill-tool as a Separate Binary Accepted 2026-03-07
0002 Two-Responsibility Model: Schema Validation and Outcome Verification Only Accepted 2026-03-07
0003 Skill Module Isolation: No Cross-Skill Imports Accepted 2026-03-07
0004 Schema-First Artifact Design: YAML Schemas to Pydantic Models Accepted 2026-03-07
0005 spec-bridge.conf as Single Configuration Source Accepted 2026-03-07
0006 Structured Stdout-Only Output Accepted 2026-03-07
0007 Adapter Pattern for Agent-Specific File Generation Accepted 2026-03-07