Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Milníky a úkoly jako data; stav se odvozuje, nikdy neukládá

Úkol zaznamenává, co se s ním stalo, a engine z grafu závislostí odvodí, zda je blokovaný, připravený, aktivní, ověřovaný nebo hotový, takže plán rozvoje nemůže být v rozporu s plánem.

status
stav funkce: stabilní
doména
Koordinace

Co dělá

majordomus plan validate odmítne cyklus, hranu, která nevede nikam, a záznam porušující schéma; plan next odpoví, které úkoly lze nyní provést; plan roadmap nakreslí graf milníků, který web vykresluje. Větev vytvořená pro úkol je po něm pojmenována, takže topologie worktree umí úkol z větve přečíst zpět, a úkol je hotov jen s důkazy, které vyžaduje jeho kontrakt. Nad větví se táž hrana čte v obou směrech a nikde se neukládá: modul schopností trace odvozuje větve a commity úkolu z gitu, scripts/traceability připojí pull requesty, které drží GitHub, a commit, který nezohledňuje žádný kontrakt provádění, se hlásí jako nepřiřazený, a ne potichu vynechává.

Nad milníky záměr říká, co se musí stát pravdou, a jaké důkazy to rozhodnou. majordomus intent odvozuje jeho stav z plánu a každé kritérium z knihy důkazů, odpovídá, kterému záměru slouží práce na úkolu, když se pracovník zeptá, odmítá kritérium, kterému neslouží žádný úkol, a práci, která začala dřív, než byl plán podroben kritice, a spojuje práci, která jej realizuje, napříč relacemi a poskytovateli; Cockpit ukazuje stejné odpovědi na /cockpit/intents.

Co nedělá

Samo s GitHubem nemluví: projekce úkolů a milníků se vykresluje offline a použije se, až když člověk spustí synchronizaci s tokenem. Nic tu neodhaduje pracnost ani neplánuje data. Záměr se při zahájení práce vynucuje jen tam, kde politika vyžaduje vazbu (intent.binding: required); jinde se posuzuje zpětně. Projekce na GitHub uzavře milník, aniž by četla záměry, které naplňuje.

Proč existuje

Provozní okamžiky z katalogu Why, které pojmenovávají některý z mechanismů této funkce. Nic zde nebylo přiděleno: okamžik se objeví, protože pojmenovává pravidlo, příkaz, schopnost nebo tvrzení, které pojmenovává i tato funkce.

Princip

Moduly schopností spustitelného souboru, které tato funkce pojmenovává, každý se schopnostmi, které skládá. Rozhraní, jichž každý dosahuje, jsou uvedena níže v části Rozhraní: jde o projekce jedné deklarace, ne o samostatné registrace.

Dohledatelnost trace ověřeno chováním

Které větve a commity realizovaly úkol a kterému úkolu a milníku commit sloužil — odvozeno z gitu a z kanonického projektového modelu při každém volání, nikde se neukládá. Větev pojmenovává úkol, když je některá z jejích složek cesty identifikátorem úkolu; commit patří úkolu, jehož větve ho drží; commit, který žádná taková větev nedrží, se hlásí jako nepřiřazený, a ne vynechává, protože práce bez prováděcího kontraktu je přesně to, co má zpráva o dohledatelnosti zviditelnit. Pull requesty jsou fakt GitHubu a tento spustitelný soubor nevolá síť: čte je a k této odpovědi je připojuje podle názvu větve `scripts/traceability`.

Plán a jeho odvozeniny plan ověřeno chováním

Model milníků a úkolů tohoto repozitáře a vše, co se z něj odvozuje a co nikdo nenapsal: stav každého záznamu, grafy závislostí nad hranicí milníku i pod ní, topologické vlny provádění, pořadí podle plánu rozvoje, právě prováděný milník a jeden úkol, který vzít jako další. Stav se nikdy neukládá — záznam říká, co se s ním stalo, a stav z toho a ze stavu jeho závislostí vyplývá — takže žádný soubor nemůže odporovat grafu. Tato schopnost čte; zápis značky životního cyklu do záznamu je `plan.transition`, která deklaruje, že zapisuje do repozitáře.

Spustitelné vývojové rozsahy devtask ověřeno chováním

Úkol a milník se čtou jako práce, kterou je třeba udělat, ne jako metadata: co napsal člověk, kam ho řadí graf plánu, co se s ním stalo lokálně, v jakém stavu je jeho externí projekce a zda ho worker smí začít — s původem každé hodnoty přímo na hodnotě. Nic zde není druhý projektový model: záznamy jsou kanonické, stav a graf jsou z `plan`, větve a commity z `trace`, slovník připravenosti upřesňuje tři kanonické stavy, aniž by kterýkoli nahradil, a projekce na GitHub zůstává věcí `scripts/github-sync`. Nic zde nic nezapisuje, a proto je hodnota od uživatele z GitHubu před tím v bezpečí.

Záměr intents ověřeno chováním

Co se musí stát pravdou nad milníky, které to realizují: výrok každého záměru, invarianty a kritéria splnění, jeho fáze odvozená ze stavu milníků plánu, stav každého kritéria odvozený z ledgeru důkazů a jeho verdikt odvozený z těchto kritérií samotných. Nic se neukládá a nic nepřechází; záměr přidaný pod model projektu je zodpovězen vším tímto bez registrace kdekoli.

Realizace záměru intent_realization ověřeno chováním

Která práce realizuje který záměr: každá úloha ledgeru tohoto checkoutu s epizodami, providery a předávkami, které ji nesly, každý uzavřený záznam relace a každý claim na nástěnce peerů, spojené přes plán se záměry, kterým slouží, každý odkaz označený jako deklarovaný, pozorovaný, odvozený nebo odhadnutý; nesplněná kritéria každého záměru s úkoly, které jim slouží; a rozpor mezi uzavřenou prací a aktuálními důkazy. Odvozeno při každém čtení a nikde neuloženo, takže záměr přežije každou relaci a providera, kteří na něm pracovali.

Objekty, z nichž se skládá

Druhy objektů vrstvy. Každý je schéma, třída zdroje a soubor na disku; číslo vedle něj říká, kolik jich tento repozitář dnes obsahuje, spočítáno při sestavení.

  • milestone100
  • issue802
  • intent33
  • gap4
  • critique29

Kde se nachází

doména
Koordinace — Každý worker deklaruje cesty, kterých se dotkne, vidí, kdo jiný pracuje a kde, a o kolizi se dozví ještě před commitem.
oblasti práce
work-tracking

Rozhraní

Každá schopnost za ní, na každém rozhraní, na které je promítnuta. Odkaz vede na referenci tohoto webu pro dané rozhraní; HTTP route a nástroj MCP odpovídá běžící majordomus serve, ne tento web.

Schopnosti za touto funkcí podle rozhraní
schopnostpříkazová řádkaHTTPnástroj MCP
trace.commit —žádné GET /api/v1/trace/commit majordomus_trace_commit
trace.issue —žádné GET /api/v1/trace/issue majordomus_trace_issue
trace.report —žádné GET /api/v1/trace majordomus_traceability
plan.delivery majordomus plan delivery GET /api/v1/plan/delivery majordomus_plan_delivery
plan.drift majordomus plan drift GET /api/v1/plan/drift majordomus_plan_drift
plan.flight —žádné GET /api/v1/plan/flight majordomus_plan_flight
plan.issues —žádné GET /api/v1/plan/issues majordomus_plan_issues
plan.model —žádné GET /api/v1/plan majordomus_plan
plan.next —žádné GET /api/v1/plan/next majordomus_plan_next
plan.record —žádné GET /api/v1/plan/record majordomus_plan_record
plan.roadmap —žádné GET /api/v1/plan/roadmap majordomus_plan_roadmap
plan.status —žádné GET /api/v1/plan/status majordomus_plan_status
plan.transition —žádné POST /api/v1/plan/transition majordomus_plan_transition
plan.validate —žádné GET /api/v1/plan/validate majordomus_plan_validate
plan.waves —žádné GET /api/v1/plan/waves majordomus_plan_waves
devtask.issue majordomus devtask issue GET /api/v1/devtask/issue majordomus_devtask
devtask.milestone majordomus devtask milestone GET /api/v1/devtask/milestone majordomus_devtask_milestone
intents.binding majordomus intent binding GET /api/v1/intents/binding majordomus_intent_binding
intents.coverage majordomus intent coverage GET /api/v1/intents/coverage majordomus_intent_coverage
intents.list majordomus intent list GET /api/v1/intents majordomus_intents
intents.preflight majordomus intent preflight GET /api/v1/intents/preflight majordomus_intent_preflight
intents.propose majordomus intent propose POST /api/v1/intents/propose majordomus_intent_propose
intents.record majordomus intent show GET /api/v1/intents/record majordomus_intent_record
intents.validate majordomus intent validate GET /api/v1/intents/validate majordomus_intent_validate
intent_realization.explain majordomus intent explain GET /api/v1/intents/explain majordomus_intent_explain
intent_realization.work majordomus intent realization GET /api/v1/intents/realization majordomus_intent_realization
v Cockpitu, běžícího serveru
/cockpit/intents Záměry

Důkazy

Co je zaručeno

Každé tvrzení, které tato funkce pojmenovává, se stavem, který deklaruje jeho řádek, verdiktem, který podporují zaznamenané běhy, a testem, který o něm rozhoduje.

Spustitelné případy užití

Pravidla, která jej drží

Použití

Příkazy, které to spouštějí

  • majordomus plan begin

    Model milníků a úkolů — ověřte ho, přečtěte ho a proveďte jím jeden úkol.

Z příkazové řádky spustitelného souboru

Synopse každého, jak ji vypisuje nápověda samotného spustitelného souboru.

Odkud tato stránka pochází

soubor
.ai/repo/features/planning.md
stejná odpověď
majordomus product show planning

Prohledává názvy a popisy všech stránek, které tento web publikuje.