Veřejná stránka slibující něco, co nic netestuje

→ publikovali stránku, která slibovala víc, než mohl podpořit jakýkoli test

cena, když k tomu dojde

vysoká

jak často

běžné

oblast

dokumentace

ověření

rozpoznáno podle

open-source-maintainer

platform-team

enterprise

engineering-lead

before   page: "Majordomus verifies completion."      code: it verifies what you name.

after    claim finish-contract   guaranteed  lib/finish.sh  test/cases/06_finish.sh
         claim cost-per-outcome  planned     -              -
         (the page renders the status; a guaranteed row with '-' fails the build)

Jak to vypadá

Konkrétní situace, jedna pro každé publikum. Každá je deklarována v záhlaví okamžiku, takže stav před a po jsou data, ne próza, od které by se stránka mohla odchýlit.

1. Stránka napsaná před funkcí open-source-maintainer

   před

   Stránka popisuje schopnost tak, jak byla navržena; dodaná verze je užší a stránka se nikdy neopraví.

   po

   Každá věta o schopnosti je tvrzení se stavem, implementací a testem a stránka tento stav vykresluje.

2. Někdo na jeho základě nakupuje enterprise

   před

   Zveřejněná záruka se použije při rozhodování a ukáže se, že je jen přání.

   po

   `guaranteed`, `advisory`, `planned` a `rejected` jsou odlišné stavy zobrazené na stránce a zaručené tvrzení bez testu shodí build.

3. Publikování toho, co bylo zamítnuto platform-team

   před

   Přístup, který byl zvažován a odmítnut, je neviditelný, a proto ho znovu navrhne každý čtenář.

   po

   Zamítnuto je stav, který se publikuje se svým odůvodněním, ne absence.

Jak to poznáte

Pozorovatelné příznaky, které tento okamžik deklaruje. Jsou dotazníkem na indexu a vstupem pro majordomus why diagnose; nic jiného je nedefinuje.

• ◻ Veřejná stránka popisuje schopnost, kterou kód plně nemá. page-ahead-of-code
• ◻ Nic na veřejné stránce nerozlišuje, co je zaručeno, od toho, co je zamýšleno. no-status-on-claims
• ◻ Veřejný materiál se píše odděleně od kódu a nikdo ho nesjednocuje. written-separately

Kde to v nástroji najdete

Vše níže je načteno z vlastního záhlaví tohoto okamžiku a ověřeno proti repozitáři. Neexistující název by neprošel validací.

příkazy, které na to odpovídají

• majordomus doctorjen pro čtení Kontroluje pouze governance: je samotný Majordomus v pořádku a je každé vynucování, které deklaruje, tady skutečně zapojeno?
• majordomus usecase Spustitelné případy užití: vypsat, zobrazit, validovat, spustit proti skutečnému nástroji, pokrytí, dopad, kostra.

schopnosti spustitelného souboru, které na to odpovídají

• health.report
• objects.list

co dohlíží — odvozeno z tvrzení níže

• Doctor

tvrzení, která tuto stránku podpírají, a důkazy za každým z nich

• ○zaručeno Scénář případu užití se provede proti skutečnému nástroji v jednorázovém repozitáři, ověří se návratový kód a výstup každého kroku a web ukazuje normalizované důkazy

  definováno v

  docs/USE_CASES.md

  implementováno v

  lib/usecase.sh

  dokázáno v

  test/cases/94_use_cases.sh

• ○zaručeno Každý veřejný příkaz je pojmenován a spouštěn aktivním případem užití, zaručené tvrzení nebo nástroj MCP bez něj je pojmenovaná mezera a politika říká, které mezery shodí doctor, check a finish

  definováno v

  docs/USE_CASES.md

  implementováno v

  lib/usecase.sh

  dokázáno v

  test/cases/94_use_cases.sh

• ○zaručeno Stránka Registr webu se vykresluje ze site/data/registry/registry.json, datové sady, kterou majordomus generate site odvozuje z registru a indexu s jejich otisky, a generate --check zastaralou odmítne v CI

  definováno v

  docs/CAPABILITIES.md

  implementováno v

  apps/majordomus-cli/src/site.rs

  dokázáno v

  apps/majordomus-cli/tests/projections.rs

• ○zaručeno Odevzdané projekce, dokument OpenAPI, reference schopností a povolené seznamy se znovu generují z registru a schémat a generate --check zastaralou odmítne

  definováno v

  docs/CAPABILITIES.md

  implementováno v

  apps/majordomus-cli/src/generate.rs

  dokázáno v

  test/cases/76_capabilities_projections.sh

• ○zaručeno Každý nález nese příkaz, který jej reprodukuje

  definováno v

  docs/DESIGN.md

  implementováno v

  lib/common.sh

  dokázáno v

  test/cases/02_doctor_basic.sh

pravidla, která jej řídí

• project.no-claim-without-test
• project.use-case-evidence
• majordomus.use-case-coverage
• project.derived-files-regenerated

případy užití, které ukazují cestu ven

• add-a-use-case-and-prove-it
• gate-ci-on-the-tool-itself
• prove-a-rule-is-enforced

Pokud vám tohle zní povědomě, další také

Co tento okamžik pojmenovává, co pojmenovává jeho a co sdílí jeho oblast, publikum nebo štítky. Druhé a třetí je odvozeno; zapsáno je jen první.

• → přečetl slib v README, za kterým nestál žádný test
• → přijal "done", protože to řekl model, a zaplatil za to další ráno
• → měl zelený pipeline nad vygenerovanými soubory, které už neodpovídaly svým zdrojům
• → našel pravidlo, o kterém všichni věřili, že se vynucuje, a nic ho nikdy nevolalo
• → přečetl tři plány rozvoje jednoho projektu a nevěřil žádnému
• → uzavřel úkol, jehož kritéria přijetí nikdo skutečně neověřil
• → nasadil změnu rozhraní, jejíž kontraktový dokument stále popisoval to staré
• → nedokázal reprodukovat výsledek, protože nic nezaznamenalo stav, z něhož vzešel
• → změnil politiku na jednom místě a na třech dalších našel platit tu starou

Všech 38 a jak souvisejí s nástrojem →