docs-hygiene
/docs-hygiene
Porządkuje dokumenty źródłowe i tabele statusów w trzech miejscach prawdy oraz aktualizuje formuły godzin przy każdym przeglądzie.
- Autor
- shafthq ↗
- Repozytorium
- shaft_engine ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Porządkuje dokumenty źródłowe i tabele statusów w trzech miejscach prawdy oraz aktualizuje formuły godzin przy każdym przeglądzie.
Oryginalny opis (EN)
Use when editing source-of-truth docs or status tables: three sources, Done / In progress / Not started, and live hour formulas. On demand only.
Jak działa
- Three source-of-truth files
- Status vocabulary
- Hours
- Journey maps
- Delete-guard upstream
- SHA-bound review
Podgląd SKILL.md
--- name: docs-hygiene description: "Use when editing source-of-truth docs or status tables: three sources, Done / In progress / Not started, and live hour formulas. On demand only." license: MIT permissions: - read --- # Docs hygiene Load this skill when the deliverable edits the three source-of-truth documents, a status table, a journey map, or hour totals. On demand only. It does not publish product docs. Run `python3 .chaos-engine/tool.py retrieve --store graphify "docs hygiene status journey"` before a broad search and record `retrieve: used|skipped(<reason>)`. ## Three source-of-truth files Name the three source-of-truth files at the start. Edit those files. A summary, a slide, or a chat note is not a fourth source of truth. ## Status vocabulary Status cells use exactly one of: **Done**, **In progress**, **Not started**. Do not invent synonyms in the table. ## Hours For every Done row, completed hours equal planned hours. In progress and Not started rows are not forced to that equality. The cells are live formulas, not pasted numbers. A hand-typed total that can drift from the plan is a failure. ## Journey maps Journey maps agree with each other and with the source-of-truth status. Do not merge a partial journey as the full journey. A partial map stays labeled partial until the missing legs exist. ## Delete-guard upstream If a delete-guard requires an upstream, push a start commit first, then delete in a follow-up. That is an allowed exception to a single push. Never use `--no-verify`, and never edit allowlists to bypass the guard. ## SHA-bound review A review claim cites the head SHA it read. A review of an older SHA is not a review of the current head. Re-read after every new commit. Enforced by [`lessons_2026_11_06.py`](../../rules/lessons_2026_11_06.py) (`evaluate_docs_hygiene`). The closed ticket this skill completes stays closed; do not refile it.
Wersje
W bazie nie ma innych skilli o nazwie docs-hygiene.
Migawka bazy z 13.11.2026 · wersja paczki ed7c96553b2e (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90docs-single-source
Linkuje dokumentację do jednego źródła prawdy zamiast powtarzać treść, przy pisaniu i przebudowie docs, edycji README lub CLAUDE.md i kopiowaniu listy z kodu. - 84setup
Sprawdza, czy markdownlint-cli2 działa w repozytorium, i ustawia opcję kompresji artykułów dla higieny dokumentacji. - 100spreadsheet-formula-helper
Pisze i debuguje formuły arkuszy (Excel, Google Sheets), tabele przestawne i formuły tablicowe oraz tłumaczy je między dialektami, z przykładami i sprawdzeniem przypadków brzegowych. - 100xlsx
Czyta, tworzy i edytuje arkusze Excel, porządkuje nieuporządkowane tabele i dodaje kolumny, formuły, style oraz wykresy. - 100reference-docs
Opisuje wzorce dokumentacji referencyjnej dla API i symboli: dokumenty referencyjne, tabele parametrów i specyfikacje techniczne.