Struktura Change Proposal¶

Adresářová struktura¶

openspec/changes/
├── add-barcode-scanning/          # Aktivní změna
│   ├── proposal.md                # Popis a zdůvodnění
│   ├── tasks.md                   # Implementační úkoly
│   ├── design.md                  # Technický design (volitelný)
│   └── specs/                     # Delta specifikace
│       ├── warehouse/
│       │   └── spec.md
│       └── product/
│           └── spec.md
│
├── fix-invoice-validation/        # Další aktivní změna
│   ├── proposal.md
│   ├── tasks.md
│   └── specs/
│       └── invoicing/
│           └── spec.md
│
└── archive/                       # Dokončené změny
    ├── 2025-01-15-add-mobile-app/
    ├── 2025-01-22-fix-login-bug/
    └── 2025-02-01-upgrade-workflow/

Povinné soubory¶

Soubor	Povinný	Popis
`proposal.md`	✅ Ano	Popis a zdůvodnění změny
`tasks.md`	✅ Ano	Seznam implementačních úkolů
`design.md`	❌ Ne	Technický design (pro komplexní změny)
`specs/*/spec.md`	✅ Ano	Delta specifikace pro dotčené moduly

Naming conventions¶

# Change IDs (verb-led, kebab-case)
good:
  - "add-barcode-scanning"
  - "fix-invoice-validation"
  - "update-workflow-triggers"
  - "remove-deprecated-fields"
  - "refactor-auth-module"

bad:
  - "barcode"           # Chybí verb
  - "new_feature"       # Underscore místo kebab
  - "FixBug123"         # PascalCase
  - "misc-changes"      # Příliš vágní

Scope management¶

# ✅ Správně: Jedna koherentní změna
change: "add-barcode-scanning"
affects:
  - Warehouse module
  - Product lookup (related)

# ❌ Špatně: Příliš mnoho nesouvisejících změn
change: "q1-updates"
affects:
  - Barcode scanning
  - Dark mode
  - New reports
  - Bug fixes

➡️ Pokračujte na Proposal.md.