Výzkum // Výzkumná poznámka 06 Technické

Metoda: stavba artefaktu podloženého důkazy s Majordomem

Publikováno 2026-09-14 · 5 min čtení

Koncepční obrazovky · ilustrativní data

  • Koncepční obrazovka pohledu Sezení v cockpitu Majordomu: seznam pracovních sezení a časová osa jednoho sezení od začátku po aktualizaci dokumentace, se zdroji kontextu, které načetlo.

    Sezení Každé sezení uchovává časovou osu, zdroje kontextu, rozhodnutí a předávku.

  • Koncepční obrazovka pohledu Pravidla v cockpitu Majordomu: seznam vynucovaných pravidel repozitáře s pokrytím, detail jednoho pravidla, stav jeho validace a místa, kde se vynucuje.

    Pravidla Spustitelná pravidla s místy vynucení: příkazová řádka, CI, pre-commit hook.

  • Koncepční obrazovka pohledu Worktrees v cockpitu Majordomu: paralelní větve se stavem, rozdíl změněných souborů, commity napřed a terminál.

    Worktrees Paralelní větve ve vlastních worktrees, každá navázaná na issue a sezení.

  • Koncepční obrazovka pohledu Issues v cockpitu Majordomu: seznam issues a detail jednoho z nich s navázaným worktree, sezením, pull requestem, testy a dokumentací.

    Issues Issue propojené s prací, která ho implementuje a ověřuje.

  • Koncepční obrazovka pohledu Testy v cockpitu Majordomu: počty úspěšných a neúspěšných testů, vývoj výsledků, pokrytí, kvalitativní brány a živý výstup testů.

    Testy Běhy testů, selhání a kvalitativní brány na jednom místě, propojené s issues a commity.

  • Koncepční obrazovka pohledu Dokumentace v cockpitu Majordomu: strom dokumentů a záznam architektonického rozhodnutí s kontextem, rozhodnutím a důsledky.

    Dokumentace Dokumentace a architektonická rozhodnutí vedle pravidel, která naplňují.

  • Koncepční obrazovka pohledu Milníky v cockpitu Majordomu: tři milníky s ukazateli postupu, graf kumulativního postupu, časová osa a závislosti.

    Milníky Milníky s postupem, harmonogramem a závislostmi odvozenými z plánu issues.

  • Koncepční obrazovka pohledu Modely v cockpitu Majordomu: poskytovatelé AI modelů s využitím, latencí, rozpisem nákladů a živými požadavky.

    Modely Které modely se použily k čemu, s jakou latencí a za jakou cenu.

Koncepční obrazovky cockpitu Majordomu: pohledy na sezení, pravidla, worktrees, issues, testy, dokumentaci, milníky a využití modelů. Všechna jména, čísla a data v nich jsou ilustrativní a nepopisují tento projekt; jeho skutečné záznamy uvádí časová osa v této poznámce.

Co vzniklo

Web je dvojjazyčná statická publikace generovaná nástrojem Zola, nasazená na GitHub Pages a při každé změně ověřená proti živé URL. Vznikl během jednoho pracovního sezení; vytvořil ho AI agent pro programování (Claude Code) řízený jedním člověkem a mezi agentem a repozitářem stál jako dozorová vrstva Majordomus.

Tato poznámka dokumentuje proces se stejným nárokem, jaký výzkumné poznámky kladou na psychologii: uvést, co bylo naměřeno, oddělit to od interpretace a říct, co z toho vyvodit nelze.

Zaznamenaná časová osa prvního vydání

Všechny časy jsou v UTC ze 14. září 2026 a pocházejí z historie Gitu, API GitHubu, ledgeru Majordomu a záznamů pipeline.

ČasUdálostZdroj
09:45Začátek pracovního sezení přestavbou plakátučasová razítka lokálních souborů
09:54:06Vytvořen repozitář na GitHubu; commit plakátuAPI GitHubu, Git
10:26:23Inicializace vrstvy Majordomus; start první dozorované úlohyledger Majordomu
10:29:16Nahlášena odchylka od rozsahu po přesunu souborů; úloha restartovánaledger Majordomu
10:39:39Chybně zadaný rozsah zachycen kontrolou před pushem; úloha restartována dřív, než proběhl jakýkoli pushledger Majordomu
10:42:45Commit webu; pre-commit hook spustil kontrolu zdraví Majordomu s nulou chybGit, výstup hooku
10:43:02–10:45:45Pipeline Pages: 7 jobů, 2 minuty 43 sekund, všechny prošlyGitHub Actions
10:45:42Vydání v0.1.0 publikováno po ověření živého webuAPI GitHubu
10:47:25Úloha uzavřena jako dokončená; ověřovacím příkazem byl smoke test živého webu (exit 0, 7 sekund)ledger Majordomu

Odvozené doby:

  • od vytvoření repozitáře k prvnímu ověřenému vydání: 51 min 36 s
  • od inicializace Majordomu k prvnímu ověřenému vydání: 19 min 19 s
  • od pushe k ověřenému vydání: 2 min 57 s

V době tohoto vydání web kontrolovalo 7 validačních kroků a 30 prohlížečových testů. Další fáze (náhledy odkazů a strukturovaná data, poté tato výzkumná knihovna a knihovna rad) proběhly ve stejné smyčce a jsou vidět v historii vydání repozitáře.

Druhy zadání

Práci řídilo zhruba patnáct zpráv od jednoho člověka. Dělily se do pěti typů:

  1. Jednořádková žádost o založení projektu na GitHubu.
  2. Výtvarné zadání plakátu, po kterém následovala volba mezi třemi nabídnutými přístupy.
  3. Strukturovaná prováděcí zadání. Tři dlouhé specifikace rostoucího rozsahu: statická stránka s dílem, interaktivní microsite a vícejazyčný publikační systém s desítkami číslovaných požadavků a výslovnou podmínkou dokončení.
  4. Krátké pokyny během práce: nasadit, ověřit v prohlížeči, vydávat automaticky, použít Majordomus a vynucovat ho.
  5. Redakční směr: zavést postupy HTML5 Boilerplate, zlepšit náhledy odkazů a dohledatelnost ve vyhledávačích a nahradit propagační texty seriózní psychologií se zdroji.

Žádná z těchto zpráv neurčovala detaily implementace, jako je syntaxe šablon nebo testovací případy. Ty byly rozhodnutím agenta a úkolem dozorové vrstvy bylo udržet je ověřitelné.

Co přinesl Majordomus

Majordomus nepsal kód. Práci vymezoval a zaznamenával:

  • Úlohy s vymezeným rozsahem. Každá změna běžela jako úloha s deklarovanými cestami. Když se soubory přesunuly mimo rozsah, majordomus watch nahlásil odchylku a úloha se restartovala se správným rozsahem. Když byl pozdější rozsah zadán chybně, majordomus check před pushem nahlásil všechny soubory jako mimo rozsah; jinak by push odmítl pre-push hook.
  • Kontrola zdraví při každém commitu. majordomus doctor běží v pre-commit hooku. Před prvním commitem nahlásil, že README neodkazuje na bootstrap soubor pro agenty; chyba byla opravena dřív, než se dostala do repozitáře.
  • Smlouva o dokončení. majordomus finish odmítne uzavřít úlohu jako dokončenou, pokud neprojde její ověřovací příkaz. U tohoto webu je to smoke test živé verze, takže „dokončeno“ znamená „nasazeno a zkontrolováno“, ne „napsáno“.
  • Kontinuita. Checkpointy a handovery zaznamenaly aktuální stav a další krok při každém restartu úlohy, takže restart trval sekundy a opíral se o zaznamenaná fakta, ne o paměť agenta.
  • Pravidla v repozitáři. Projektová pravidla jako „žádné tvrzení o nasazení bez ověření živého webu“ leží v .ai/repo/rules/ vedle kódu, který řídí.

Zrychlilo to vývoj?

Poctivá odpověď zní, že žádný násobek zrychlení uvést nelze. Proběhlo jedno sezení a žádné srovnatelné sezení bez dozoru, takže chybí kontrolní podmínka.

Záznamy ale ukazují, kde se čas neztratil. CI neodmítlo žádný push, žádné nasazení se nemuselo vracet a první běh pipeline prošel všemi sedmi joby. Tři chyby (dvě chyby rozsahu a selhání bootstrapu dokumentace) se staly lokálními nálezy místo neúspěšných běhů pipeline. Každá by stála nejméně jeden další cyklus pushe a čekání v délce několika minut a neúspěšné nasazení by stálo víc.

Větší účinek je na důvěryhodnost než na samotnou rychlost. Každé „hotovo“ v tomto projektu je podložené zaznamenaným příkazem a jeho návratovým kódem, což si čtenář může v repozitáři ověřit příkazem majordomus history.

Limity této zprávy

  • Časová osa začíná prvním zaznamenaným souborem; plánování, které proběhlo před ním, není zahrnuto.
  • Doby závisí na nástrojích, hardwaru a latenci sítě v tomto sezení.
  • Sezení se opíralo i o běžné pojistky nezávislé na Majordomu, včetně lokální validace, prohlížečových testů a průběžné integrace. Jejich účinky zde nejsou odděleny.

Tvrzení na této stránce

Každé tvrzení je ohodnoceno v registru důkazů i se zdroji a daty revizí. Důkazy →

TechnickéÚroveň EJistota HIGH

Časová osa v poznámce o metodě, včetně 51 min 36 s od založení repozitáře po první ověřené vydání, pochází ze záznamů Gitu, GitHubu, pipeline a Majordomu a žádný faktor zrychlení se neuvádí, protože chyběla kontrolní podmínka.

Platnost
Jedno pracovní sezení 14. září 2026.
Výhrada
Plánování před prvním zaznamenaným souborem není zahrnuto a délky závisejí na nástrojích, hardwaru a latenci sítě.

Naposledy ověřeno · Příští revize · build-timeline-from-records

Literatura

  1. Majordomus (2026). Majordomus: A lightweight supervisory control layer for AI-assisted work (version 0.6.0). https://majordomus.dev
  2. Sig Nihl (2026). catharsis-as-a-service: repozitář, běhy workflow Pages a historie vydání. GitHub. https://github.com/korczis/catharsis-as-a-service