0.30.2 Řídicí vrstva pro vývoj s podporou AI
Vaši AI agenti říkají, že je práce hotová. Majordomus je přiměje to dokázat.
Majordomus udržuje AI programovací agenty poctivé. Pamatuje si, co se naučila každá relace, drží paralelní agenty z cesty jeden druhému a úlohu přijme jako hotovou, jen když projdou vaše vlastní kontroly. Funguje po boku agenta, kterého už používáte, a nikdy nevolá model.
Open source. Instalace jedním příkazem. Bez účtu, bez registrace. Podívejte se, jak odmítne nedokončenou práci →
- Funguje po boku nástrojů, které váš tým už používá
- Jakýkoli nástroj, který čte AGENTS.mdbbClaude CodeCodexGemini CLIWorker bez vlastní konvence
produkt · vlastní dodávka tohoto projektu
Vlastní plán a releasy tohoto projektu, přečtené z jeho záznamů u commitu, ze kterého byl tento web sestaven.
Delivery the history proves, inferred at 9129c66
Úkoly plánu podle stavu, který deklarují jejich záznamy
Changes the release record of v1.0.0-alpha.1 carries, 2026-10-20
- přidáno
- 4
- opraveno
- 20
- dokumentace
- 2
- pipeline
- 1
- úklid
- 4
Otevřít produkt → A snapshot, read once at this site's commit. 905159d
01problém
Agenti jsou rychlí. Důvěra je pomalá.
AI agenti dokážou psát kód celý den. Těžké je vědět, co změnili, na co zapomněli a jestli něco z toho vůbec funguje.
- Kontext Agenti zapomínají. Co se naučila jedna relace, zaniká s její konverzací a další začíná od nuly.
- Koordinace Agenti kolidují. Paralelní workery upravují stejné cesty nebo staví totéž dvakrát, aniž by o sobě věděli.
- Dokončení Hotovo je zadarmo. Worker může ohlásit úspěch dřív, než projdou kontroly samotného repozitáře.
Majordomus řeší všechny tři na jediném místě, kde už každý agent pracuje: ve vašem repozitáři.
Postaveno pro lidi, kteří odpovídají za výsledek
- Samostatný tvůrce
- Vývojový tým postavený na AI
- Vedoucí vývoje
- Platformní tým a tým produktivity vývojářů
- Správce open-source projektu
- Agentura nebo konzultační firma
- Podnikový vývoj
- Výzkum a experimentální vývoj
Poznáváte konkrétní okamžik? Podívejte se, na která selhání odpovídá
- znovu vysvětloval stejný kontext zbrusu nové relaci
- zjistil, že dva agenti opravují stejnou chybu ve dvou branchích
- sledoval, jak nejsilnější model na maximální úsilí přejmenoval proměnnou
- přijal "done", protože to řekl model, a zaplatil za to další ráno
- otevřel CLAUDE.md a AGENTS.md a našel dvě různé sady pravidel pro jeden repozitář
- sledoval, jak relace zrušila loňské rozhodnutí z důvodu, kvůli kterému bylo přijato
- našel úlohu "in progress", které se tři týdny nikdo nedotkl
- se zeptal, co workeři dělali včera v noci, a měl jen přepisy, které by mohl prohledávat
- našel pravidlo pro daný adresář v README, které žádná relace nikdy nenačetla
- četl tři plány rozvoje jednoho projektu a nevěřil žádnému z nich
Všech 38, podle toho, kdo jste, a podle oblasti provozu, do které patří →
02jak to funguje
Od prvního promptu po ověřené dokončení
Každá úloha jde po stejné krátké cestě, ať ji dělá kdokoli a cokoli. Váš repozitář odpovídá v každém kroku, takže nic nezávisí na tom, že si agent vzpomene chovat se slušně.
- 1 start zahájí úlohu s rozsahem pod zvoleným profilem Podívejte se, jak běží →
- 2 kontext co další worker potřebuje vědět teď, v rámci rozpočtu Podívejte se, jak běží →
- 3 kontrolní bod zaznamená stručný průběh uvnitř aktivní úlohy Podívejte se, jak běží →
- 4 check je aktuální úloha v souladu s politikou, rozsahem a stavem? Podívejte se, jak běží →
- 5 handover zapíše záznam pokračování určený jen k připisování (tělo na stdin) Podívejte se, jak běží →
- 6 finish vyhodnotí kontrakt finish; pokud není splněn, odmítne Podívejte se, jak běží →
Žádné triky s prompty ani slepá víra. Pokud kontrola selže, úloha není hotová a záznam říká proč.
03co získáte
Vše, co práce s podporou AI potřebuje, v jedné vrstvě
Věci, které si každý tým nakonec staví ručně, připravené od prvního dne. Otevřete kteroukoli a uvidíte, co dělá a jaké jsou za ní důkazy.
-
1 · 4 funkce
Kontext
Každý worker začíná u toho, co už repozitář ví: kontext platný pro jeho cestu, předávka, kterou zanechala poslední relace, a rozhodnutí, která už padla.odpovídá na
Agenti zapomínají. Co se naučila jedna relace, zaniká s její konverzací a další začíná od nuly.- tvrzení zaručená pojmenovaným testem
- 29 z 32
- spustitelné případy užití
- 17
- pravidla, o která se opírá
- 19
-
2 · 6 funkcí
Koordinace
Každý worker deklaruje cesty, kterých se dotkne, vidí, kdo další kde pracuje, a o kolizi se dozví dřív, než se commitne.odpovídá na
Agenti kolidují. Paralelní workery upravují stejné cesty nebo staví totéž dvakrát, aniž by o sobě věděli.- tvrzení zaručená pojmenovaným testem
- 40 z 41
- spustitelné případy užití
- 6
- pravidla, o která se opírá
- 13
-
3 · 3 funkce
Governance
Pravidla se napíšou jednou, v repozitáři, promítnou se do instrukcí každého nástroje a blokující pravidlo příkaz zastaví, místo aby jen radilo.odpovídá na
Pravidla se rozjíždějí. Každý nástroj má vlastní soubor s instrukcemi a pravidlo, které nikdo nezapojil do vynucování, je jen návrh.- tvrzení zaručená pojmenovaným testem
- 25 z 29
- spustitelné případy užití
- 8
- pravidla, o která se opírá
- 17
-
4 · 5 funkcí
Důkazy
Tvrzení jmenuje test, který o něm rozhoduje, zaznamenaný běh se posuzuje proti commitu, nad nímž proběhl, a tvrzení bez zaznamenaného běhu to přímo říká.odpovídá na
Tvrzení předbíhají důkazy. Dokumentace říká jedno, runtime dělá druhé a nikdo neumí ukázat, co z toho platí.- tvrzení zaručená pojmenovaným testem
- 30 z 34
- spustitelné případy užití
- 4
- pravidla, o která se opírá
- 13
-
5 · 3 funkce
Dokončení
Hotovo je smlouva, kterou repozitář vyhodnocuje řádek po řádku. Dokud některý řádek selhává, práce se nepřijme a odmítnutí zůstává v záznamu.odpovídá na
Hotovo je zadarmo. Worker může ohlásit úspěch dřív, než projdou kontroly samotného repozitáře.- tvrzení zaručená pojmenovaným testem
- 16 z 16
- spustitelné případy užití
- 8
- pravidla, o která se opírá
- 12
-
6 · 7 funkcí
Povrchy
Jedna deklarace v repozitáři se stává příkazovou řádkou, HTTP API, MCP, UI, Cockpitem, dokumentací i tímto webem a projekce, která se s ní rozchází, shodí build.odpovídá na
Rozhraní se rozcházejí. Příkazová řádka, API, dokumentace i web mají každé svou kopii a ty se rozjíždějí.- tvrzení zaručená pojmenovaným testem
- 35 z 35
- spustitelné případy užití
- 10
- pravidla, o která se opírá
- 15
Produkt podle domén → Všech 28 funkcí → Každá funkce proti každému rozhraní →
04funguje po vašem
Jeden zdroj pravdy, ať pracujete kdekoli
Manažeři sledují dodávku v prohlížeči. Agenti se ptají přes své vlastní nástroje. Inženýři zůstávají v terminálu. Všichni dostanou stejnou odpověď, protože každý pohled se generuje ze stejných záznamů.
-
UI
Pro každého, kdo sleduje dodávku: zdraví projektu, releasy, plán rozvoje, otevřenou práci, důkazy a pravidla na jednom místě.
Na vašem vlastním repozitáři je živý: spusťte lokální server a odpoví na
/ui -
Cockpit
Pro každého, kdo chce detail: každé pravidlo, záznam a kontrola za číslem, s jeho zdrojem.
Na vašem vlastním repozitáři je živý: spusťte lokální server a odpoví na
/cockpit -
Příkazová řádka
Pro každého, kdo práci dělá, člověka i agenta: zahájit úlohu, zkontrolovat ji, předat ji, dokončit ji.
-
HTTP API
Pro vaše vlastní nástroje a dashboardy: tytéž odpovědi přes HTTP.
-
MCP
Pro programovací agenty: tytéž odpovědi jako nástroje, které agent může volat.
-
Dokumentace
Pro všechny: průvodce, reference a rozhodnutí, která za nimi stojí.
- schopností v registru
- 3161
- nástroje MCP
- 196
- HTTP routy
- 201
- objektů vrstvy
- 2955
Každá funkce proti každému rozhraní → Registr, ze kterého se generuje každé rozhraní →
Přineste si vlastní AI. Zachovejte si vlastní pravidla.
Majordomus nikdy nevolá model; rozhoduje, co se workerovi řekne, čeho se smí dotknout a zda lze věřit jeho tvrzení, že je hotov.
Pro inženýry: jedna deklarace dosáhne každého rozhraní
- deklarováno jako
- brief.session
- příkazová řádka
- majordomus brief
- nástroj MCP
- majordomus_brief
05důkaz
Podívejte se, jak řekne ne.
Agent se zatoulá mimo svou úlohu, řekne, že je hotov, a je odmítnut. Uklidí a je odmítnut znovu, protože váš vlastní test pořád selhává. Práce se přijme, teprve když projdou všechny kontroly. Je to záznam skutečného nástroje, ne demo skript.
- worker Worker provede změnu, o kterou byl požádán, a upraví také poznámku v docs, kterou úloha nikdy nenárokovala.
- odmítnuto check pojmenuje soubor mimo zabraný rozsah a skončí nenulovým kódem. Je to selhání, ne varování.
- odmítnuto Worker ohlásí úlohu jako dokončenou. finish smlouvu vyhodnotí, místo aby jí věřil, a odmítne.
- worker Zbloudilá úprava je vzata zpět.
- odmítnuto Rozsah je teď čistý, ale vlastní test repozitáře stále selhává. finish jej spustí a znovu odmítne.
- worker Pracovník udělá to, co předávka označila jako zbývající.
- přijato Každý řádek smlouvy projde, takže se výsledek zaznamená spolu s ověřením, které jej dokázalo.
zaznamenaný běh · worker říká, že je hotov
Worker ohlásí úlohu jako dokončenou. finish smlouvu vyhodnotí, místo aby jí věřil, a odmítne.
$ majordomus finish --outcome completed --verify-command 'sh test/parse.sh'
- úspěch blockers
- selhání poznámka
- selhání scope
- úspěch state
- selhání ověření
finish: odmítnuto, 3 nesplněné
Přijme se, jen když projdou všechny řádky: finish: t-<id> completed
Kterýkoli nástroj umí agentovi říct, co má dělat. Majordomus rozhoduje, zda se to, co udělal, počítá, a záznam vede v obou případech.
Celá výzva a jak si ji spustit sami → Kontrakt, proti kterému se hodnotí každé odmítnutí →
Všechna ostatní zaznamenaná odmítnutí (12)
- $ majordomus context resolve .ai/repo/zones exit 10 Odmítnout adresář vrstvy, který nic nedokumentuje →
- $ majordomus context validate exit 10 Odmítnout adresář vrstvy, který nic nedokumentuje →
- $ majordomus context --budget-lines 30 exit 10 Číst jen kontext, který se vejde do rozpočtu, a vědět, co bylo vynecháno →
- $ majordomus check exit 10 Předat práci s otevřenou otázkou a nechat ji blokující →
- $ majordomus check exit 10 Přistihněte agenta, který tvrdí, že je hotov, a není →
- $ majordomus check exit 12 Pokračovat ve správném worktree, nikdy proti cizí úloze →
- $ majordomus finish --outcome completed --verify-command 'test -d .ai' exit 10 Rozhodněte, zda je hotová práce skutečně hotová →
- $ majordomus finish --outcome completed --verify-command 'test -d .ai' exit 10 Předat práci s otevřenou otázkou a nechat ji blokující →
- $ majordomus finish --outcome completed --verify-command 'sh test/parse.sh' exit 10 Přistihněte agenta, který tvrdí, že je hotov, a není →
- $ majordomus finish --outcome completed --verify-command 'sh test/parse.sh' exit 10 Přistihněte agenta, který tvrdí, že je hotov, a není →
- $ majordomus finish --outcome completed --note done exit 10 Doložit, co úloha dlužila, než ji prohlásíte za hotovou →
- $ majordomus finish --outcome completed --note done exit 10 Říct, co se dostalo na remote a co ne →
06důkazy, ne reference
Žádná loga. Žádná doporučení. Důkazy.
Každé číslo zde se počítá z repozitáře, nikdy se nepíše ručně. Každý slib jmenuje test, který ho má dokázat; ty, které podporuje zaznamenaný běh, se počítají zvlášť od těch, které jsou jen deklarované, a co je plánované nebo odmítnuté, je ukázáno otevřeně.
Dvě čísla, záměrně držená zvlášť. Deklarováno je slib zapsaný spolu s testem, který ho má dokázat. Podloženo znamená, že tento test proběhl proti přesně této revizi a běh byl zaznamenán. Slib bez zaznamenaného běhu se počítá jako slib a nic víc.
- ověřte, co jste nainstalovali
- majordomus --version
Model záměrů, tvrzení po tvrzení
9 zaručeno2 plánováno
Model záměrů, tvrzení po tvrzení
9 zaručeno2 plánováno
Každé tvrzení, které model záměrů činí, je níže uvedeno pod stavem, který pro něj deklaruje docs/CLAIMS.yaml, a každé se otevírá na testu, který o něm rozhoduje. Tvrzení povýšené z plánovaného na zaručené se přesune mezi seznamy bez jakékoli úpravy této stránky a cokoli, co návrh požaduje a žádné tvrzení nejmenuje, je věta v podmiňovacím způsobu, ne schopnost.
zaručeno
- Fáze záměru se odvozuje z milníků, které jej realizují, a každé kritérium z knihy důkazů; záměr je naplněn, jen dokud má každé kritérium aktuální úspěšný běh
- Záměr, jehož kritérium jmenuje důkaz, který se nikam nevyřeší, se odmítne s uvedením jména
- Jakmile pod záměrem existuje práce, odmítne se s uvedením jména kritérium, kterému neslouží žádný úkol, úkol pod jeho milníky, který neslouží ničemu, i odkaz na neexistující kritérium
- Mezera, která nechává kritérium bez odpovědi, se odmítne a úkol sloužící záměru, který začal bez kritiky nebo při otevřeném blokujícím nálezu, neprojde validací záměru
- Práce realizující záměr se spojuje napříč relacemi, poskytovateli a předávkami a záměr, jehož milníky jsou všechny uzavřené, zatímco důkaz kritéria selhává, se odmítne s uvedením tohoto kritéria
- Zeptáte-li se před prací na úkolu, `intent preflight` jmenuje záměry, kterým úkol slouží, s platnou správou, nebo odmítne s uvedením příčiny
- Cockpit zobrazuje každý záměr s odvozenou fází na /cockpit/intents a kritéria, důkazy, sloužící úkoly a realizující práci jednoho záměru na /cockpit/intents/<id>
- Úloha, která jmenuje úkol nebo záměr, jemuž slouží, dostane briefing o tom, co ten záměr od práce žádá, a předávka sdělí dalšímu pracovníkovi, že se záměr změnil
- Kde politika vyžaduje navázání, zahájení úkolu nebo úlohy, která slouží záměru bez kritiky nebo s otevřeným blokujícím nálezem, se odmítne už při zahájení, ne až dodatečným hlášením
Milníky v pořadí, v jakém je odvozuje jejich graf → Model fázi po fázi →
Každé tvrzení s testem, který ho rozhoduje → Každé pravidlo, s jeho validátorem → Co nedělá →
07začínáme
Běží na vašem repozitáři během pár minut
Jeden příkaz ho nainstaluje a jeden nastaví váš repozitář. Přidá jediný sledovaný adresář, čitelný i bez nástroje, a nic dalšího.
instalace · jeden příkaz
Nainstalujte majordomus jedním příkazem
Žádný git, Rust, Node ani root. Jeden archiv pro váš stroj, jeho digest se ověří před rozbalením čehokoli, do $HOME/.local/bin.
curl -fsSL https://majordomus.dev/install.sh | sh2 · v repozitáři, který chcete dozorovat
majordomus initZapíše .ai/ — politiku, profily, pravidla, prompty, workflow — a nic dalšího.
3 · nasměrujte na něj své agenty
majordomus updateZ politiky generuje CLAUDE.md, AGENTS.md a další bootstrapy; každý worker čte stejnou smlouvu. Platformy, připnutí verze, bezpečnostní model →
Ověřte, co se nainstalovalo: majordomus --version
Platformy, připnutí verze, bezpečnostní model Každá funkce Přečtěte si záruky Jak je tato stránka odvozena