[DOCS] Standaryzacja dokumentacji, uzgodnienie historii i deduplikacja

[tom-sapletta-com]

Cel i etap

Kampania wellmanifest/docs v0.4.0 dla semcod/goal. Etap: PLAN / poczekalnia.
To zgłoszenie nie uruchamia wykonawcy ani nie nadaje uprawnień do usuwania danych, zmiany chronionego CI lub samodzielnego merge.

Standard: https://github.com/wellmanifest/docs/tree/867241833a7e69188d595505d116115736438c7a
Przed rozpoczęciem sprawdzić, czy istniejąca adopcja i zadania już realizują ten zakres; wznowić pasujące zadanie zamiast tworzyć konkurencyjne.

Obserwacja wejściowa (2026-09-14, lokalny checkout)

• Rewizja: f344e9df780cddd8a1065d597b3ac4b7b13b32a6; liczba śledzonych Markdown pod docs/: 26.
• To inwentaryzacja ścieżek, nie aktualny audyt treści ani dowód duplikacji. Ponowić względem aktualnej gałęzi domyślnej main.
• docs/AGENTS.md
• docs/ARCHITECTURE.md
• docs/GOAL_KORU_SUBACTOR_REFACTORING_PLAN.md
• docs/LOGIC_FLOW.md
• docs/README.md

Zakres i kryteria odbioru

• AC-01: Zmapować docs, indeksy, changelogi, obecne i historyczne tickety (Planfile/project/SQLite), issues i PR-y. Uzgodnić statusy z kodem oraz dowodami scalenia; nie zamykać zadań na podstawie starego TODO.
• AC-02: Dla każdej rodziny dokumentów wskazać właściciela, kanoniczną ścieżkę i decyzję: zachować / zaktualizować / scalić / superseded. Podobieństwo tekstu nie jest dowodem zbędności; nie usuwać unikalnych wymagań, dowodów ani zarządzanych kopii standardów.
• AC-03: Migrować małymi partiami do krótkich plików WIELKIMI_LITERAMI.md w odpowiednich kategoriach FEATURE, BUGFIX, SERVICE, INFORMATION, ANALYSIS, REFACTORING lub DECISION. Pilność zapisać jako P0–P3, nie jako typ dokumentu. Zachować wyjątki organizacyjne i zgodność historycznego v1.
• AC-04: Zachować stare linki i kotwice przez poprawne mapy dawnych ścieżek; zaktualizować docs/README.md i odnośniki z changeloga bez powielania treści. Udokumentować każdą usuniętą kopię i dowód zachowania jej unikalnej treści; nie kasować historii ticketów.
• AC-05: Przyjąć immutable pin standardu w procesie właściwym dla repo i podłączyć preflight oraz finalny checker do istniejącego CI. Sprawdzić zaufane base/HEAD. Globalny filtr fleet standardu ograniczony do subactor/* nie dowodzi pokrycia semcod/autogrammar; raportować i rozwiązać tę lukę bez obejścia bramy.
• AC-06: DSL jest opcjonalny tylko dla formalnych FEATURE/BUGFIX; użyć parsera przypiętego przez policy-dsl.lock.json. DSL nie wykonuje testów ani nie zatwierdza zmiany. Nie przepisywać całej dokumentacji na DSL.
• AC-07: Sprawdzić linki i kotwice, zachowanie wymagań, governance, testy projektu i ponowne uruchomienie bez dodatkowych zmian. Oddzielić liczbę plików od jakości i kompletności migracji.
• AC-08: Osobny ograniczony ticket/worktree/PR zgodnie z zasadami repo; niezależny review i chroniona publikacja. Raport końcowy: pokrycie, pominięcia, konflikty, model rzeczywiście użyty, wyniki kontroli i URL scalonego PR.

Kolejność

Audyt read-only → uzgodnienie istniejących zadań → plan migracji → pilotaż → małe partie → przegląd i publikacja.
Pierwsza grupa pilotażowa: semcod/koru, semcod/goal, semcod/taskand-glm53. Pozostałe repo oczekują oceny pilotażu; samo utworzenie issue nie włącza automatyzacji.
Nie nadpisywać brudnych checkoutów, nie zmieniać aplikacji ani statusów historycznych zadań w ramach samego porządkowania docs.

Powiązane wcześniejsze zgłoszenia

• Audyt GitHub nie znalazł powiązanego zgłoszenia po tytule; nadal sprawdzić lokalne i historyczne zadania.

---

Strategy Metadata:

• deduplication_key: wellmanifest-docs-v04:semcod/goal
• campaign: wellmanifest-docs-v04
• standard_revision: 867241833a7e69188d595505d116115736438c7a
• phase: PLAN

---

Wynik etapu standardu i pilotaży — 2026-09-14

Scalono wellmanifest/docs 0.5.0: https://github.com/wellmanifest/docs/pull/11; pełny pin 71c296aab28bceec709722f59078ca86ac48dca7.

Naprawiono lukę AC-05 w standardzie: jawne --namespace semcod/autogrammar i powtarzalne --fleet, z pominięciami, kopiami, HEAD i dirty state. Audyt lokalny: 106 checkoutów / 104 deklarowane origin; brak zgodnej adopcji nie został pominięty.

117 testów PASS, w tym przypięty parser Policy DSL oraz pilotaże 12 opublikowanych dokumentów i 5 map z Koru, Goal i Taskand. Testy w izolowanych fixture potwierdzają zgodność/idempotencję i odmowę przy braku adopcji, błędnym pinie, usuniętych metadanych lub celu mapy. Nie jest to wdrożenie CI konsumenta.

Wyniki i granice: https://github.com/wellmanifest/docs/blob/71c296aab28bceec709722f59078ca86ac48dca7/docs/ANALYSIS/FLEET_COVERAGE_PILOT.md

Zadanie pozostaje otwarte: uzgodnić aktualne tickety i zakresy, naprawić wcześniejsze niezgodności, adoptować pin w zaufanym procesie i wykazać negatywne canary preflight/final w istniejącym CI. Nie uruchomiono masowej refaktoryzacji ani usuwania dokumentacji. Chroniony Validator standardu użył doradczo zai/glm-5.3; sam ten wpis nie nadaje uprawnień.