Plynulý příspěvek, který nemohl znát pravidla

→ zrecenzoval dobře napsaný příspěvek, který porušil konvenci, již neměl jak objevit

cena, když k tomu dojde

vysoká

jak často

běžné

oblast

governance

kontext

rozpoznáno podle

open-source-maintainer

platform-team

agency

enterprise

before   review comment #11: "we don't use that pattern here, because ..."

after    $ majordomus context resolve lib/auth
         $ majordomus rules list
         project.no-claim-without-test   blocking   enforced by: review
         majordomus.scope-integrity      blocking   enforced by: check, finish, watch

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. Pull request s asistencí open-source-maintainer

   před

   Asistent přispěvatele vytvoří čistou, idiomatickou změnu, která porušuje rozhodnutí, jež projekt učinil před dvěma lety.

   po

   Konvence a rozhodnutí jsou objekty v repozitáři, dohledatelné z cest, které řídí, dřív, než je změna napsána.

2. Review jako jediný kanál platform-team

   před

   Objem příspěvků roste s asistenty a kapacita přezkumu ne; fronta se stává úzkým hrdlem a konvence cenou.

   po

   Pravidla lze načíst čímkoli, co píše, takže revize přestává být přenosovým mechanismem.

3. Práce zvenčí týmu enterprise

   před

   Externí příspěvek splní standardy, které viděl, a mine ty, které se drží interně.

   po

   Efektivní sada pravidel je čitelná — vendorovaný základ plus vlastní pravidla projektu — a u každého pravidla říká, zda ho něco vynucuje.

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.

• ◻ Přicházejí příspěvky, které jsou plynulé, věrohodné a špatné způsobem specifickým pro projekt. plausible-and-wrong
• ◻ Stejný komentář k revizi se opakovaně píše různým přispěvatelům. same-review-comment
• ◻ Jediným mechanismem, který přenáší konvence projektu, je review. review-is-the-gate

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 contextpouze pro čtení Co potřebuje vědět další pracovník právě teď, v pořadí autority a v rámci rozpočtu.
• majordomus rules Účinná sada pravidel: vendorovaný základ plus pravidla projektu.
• majordomus doctrineread-only Která pravidla se vynucují, čím a zda je každé skutečně zapojeno.

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

• objects.list
• objects.get

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

• Doctor
• Vrstva
• Politika

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

• ○zaručeno Kontext, který se vztahuje na cestu, se skládá z dokumentů vrstvy vázaných na rozsah, od kořene k cíli, v jednom deterministickém pořadí s původem, a strom, který neprojde validací, nevyřeší nic

  definováno v

  docs/CLI.md

  implementováno v

  lib/context_docs.sh

  dokázáno v

  test/cases/69_context_documents.sh

• ○zaručeno Efektivní sada pravidel se řeší jako graf závislostí v deterministickém pořadí a sadu, která se nevyřeší, neaplikuje nic

  definováno v

  docs/DOCTRINE.md

  implementováno v

  lib/rules.sh

  dokázáno v

  test/cases/67_rule_dag.sh

• ○zaručeno Základ pravidel je vendorován do repozitáře s manifestem jmenujícím každý soubor a jeho hash a ruční úprava se odhalí a odmítne

  definováno v

  docs/DOCTRINE.md

  implementováno v

  lib/rules.sh

  dokázáno v

  test/cases/67_rule_dag.sh

• ○zaručeno O tom, zda porušení zastaví příkaz, rozhoduje třída doktríny, ne štítek vedle ní

  definováno v

  docs/DOCTRINE.md

  implementováno v

  lib/doctrine.sh

  dokázáno v

  test/cases/17_doctrine_enforcement.sh

• ○zaručeno Dopad sady změn na kontext v rozsahu se hlásí z gitu — dokumenty, rozsahy pod nimi, přesuny s jejich původem, sledované zdroje ke kontrole a zastaralé projekce — a nesouvisející změna nehlásí nic

  definováno v

  docs/CLI.md

  implementováno v

  lib/context_docs.sh

  dokázáno v

  test/cases/70_context_impact.sh

pravidla, která jej řídí

• majordomus.context-integrity
• majordomus.rule-package-integrity
• project.context-locality
• majordomus.doctrine-wiring-integrity

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

• read-the-rules-the-tool-applies
• document-every-directory-of-the-layer
• adopt-an-existing-repository

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í.

• → našli pravidlo pro daný adresář v README, které žádná relace nikdy nenačetla
• → strávil první hodinu v neznámém repozitáři zjišťováním, co je tu normální
• → sledoval, jak relace vrátila rozhodnutí z minulého týdne, a to z důvodu, pro který padlo
• → sledoval, jak vždy načítaný instrukční soubor přerostl tisíc řádků
• → našel pravidlo, o kterém všichni věřili, že se vynucuje, a nic ho nikdy nevolalo
• → našli kód, který odporoval rozhodnutí, jež si repozitář zapsal
• → se zeptal, kdo změnu udělal a podle jaké politiky, a měl jen commit
• → otevřel CLAUDE.md a AGENTS.md a našel dvě různé sbírky pravidel pro jeden repozitář
• → přečetl tři plány rozvoje jednoho projektu a nevěřil žádnému

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