Skip to content

[DOCS] Standaryzacja dokumentacji, uzgodnienie historii i deduplikacja #5

Description

@tom-sapletta-com

Cel i etap

Kampania wellmanifest/docs v0.4.0 dla autogrammar/codot. 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: a362431de207652dfc3fe005a8104f7fee9ab580; liczba śledzonych Markdown pod docs/: 8.
  • To inwentaryzacja ścieżek, nie aktualny audyt treści ani dowód duplikacji. Ponowić względem aktualnej gałęzi domyślnej main.
  • docs/01-cqrs-url-platform-status.md
  • docs/02-market-comparison.md
  • docs/02-protocol-registry-status.md
  • docs/03-multi-agent-architecture.md
  • docs/03-policy-engine-status.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:autogrammar/codot
  • campaign: wellmanifest-docs-v04
  • standard_revision: 867241833a7e69188d595505d116115736438c7a
  • phase: PLAN

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docs-standard-v04Auto-created label for docs-standard-v04documentationImprovements or additions to documentationmanagedAuto-created label for managedplanfileAuto-created label for planfileplanning-onlyAuto-created label for planning-onlypriority-normalAuto-created label for priority-normal

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions