Přeskočit na obsah

/docs-sync — Dopad změny na dokumentaci

Dopad změny na dokumentaci: Zjistí, kterou dokumentaci, lekci nebo referenci provedená změna zasáhla, a odděluje přitom generované soubory (ty se nepíšou, ty se generují) od těch k ručnímu projití. Claude skill, kontrola výstupů.

Claude skill kontrola výstupů

Volání

/docs-sync

Argumenty: "[changed | <co se změnilo>]"

Zdroj: .claude/skills/docs-sync/SKILL.md

Zjistí, kterou dokumentaci, lekci nebo referenci provedená změna zasáhla, a odděluje přitom generované soubory (ty se nepíšou, ty se generují) od těch k ručnímu projití. Nese mapu dopadů pro stav tvrzení, schéma, npm příkaz, redakční pravidlo, autorizační model, architekturu, novou schopnost, UI doktrínu a Claude Code capability.

Kdy ho spustit

Po změně, která se dotkla něčeho popsaného jinde, a před /quality — dokumentační drift je běžný nález.

Pro koho a s jakým rizikem

  • Persona: vývojář, editor, údržbář
  • Riziko: jen čte
  • Zapisuje do souborů: ne

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Zastaralá technická lekce je horší než žádná: čtenář podle ní pracuje a neví, že popisuje neplatný stav.
  • Katalog příkazů se NEOPISUJE do lekcí ani do README. Odkazuje se na něj.
  • Když se mění význam pojmu, mění se v content/koncepty. Ostatní místa ho jen aplikují.
  • ADR a implementační reporty se nepřepisují. Historické rozhodnutí zůstává a doplní se odkaz na aktuální stav.

Jak se skill popisuje sám

Zjistí, kterou dokumentaci, lekci nebo referenci zasáhla provedená změna, a projde je — aby text nezůstal popisovat stav, který už neplatí. Použij ho po změně schématu, redakčního pravidla, npm příkazu, architektury nebo po přidání schopnosti, a když se někdo ptá „co ještě musím aktualizovat".

Doslovný text z .claude/skills/docs-sync/SKILL.md.

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.