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.

Sada komponent

Jeden slovník.Každá obrazovka.

Komponenty, z nichž je složena každá stránka tohoto webu: tóny, atomy, panely, seznamy, terminály, záložky, dashboard a diagramy. Každá je zde ukázána vykreslená z vlastních dat repozitáře, napsaná jednou v share/design/kit.css a site/templates/kit/.

“Stránka říká, čím věc je — odznak, tabulka, blok kódu, karta — a tento soubor říká, jak ta věc vypadá.”
share/design/primitives.css

01 / tóny

Tóny

Odstíny, které nesou identitu a nikdy význam: barva kroku, karty jednoho povrchu, jednoho druhu v oblaku druhů. Tón je třída; každá komponenta jej čte přes stejné čtyři vlastnosti.

  • 1 modráGET

    první krok sekvence; tón CLI, soubory, které repozitář drží

    .mj-tone--blue
  • 2 fialováGET

    druhý krok; tón typovaného modelu a API

    .mj-tone--violet
  • 3 zelenáGET

    třetí krok; tón odvozených povrchů

    .mj-tone--green
  • 4 oranžováGET

    čtvrtý krok; tón toho, co se předkládá a vrací zpět

    .mj-tone--orange
  • 5 vzrostloGET

    pátý odstín pro slovník delší než čtyři, například mrak druhů

    .mj-tone--rose
  • 6 azurováGET

    šestý odstín pro slovník delší než pět

    .mj-tone--cyan

02 / atomy

Atomy

Tlačítka, glyfy, kroky, slova slovníku a slova stavu. Slovo stavu je barevné podle stavu, pod kterým je vedeno v share/design/tokens.yaml, a podle ničeho jiného.

zdravéběžízastavenoselhaločekádeklarováno
prošloselhaloběžíkoncept

03 / nadpis stránky

Hero, citace a hlavička sekce

Horní část této stránky je hero; jeho aside přijímá citát, terminál nebo řadu tvrzení. Hlavička sekce je to, co otevírá každou sekci níže.

“projekce trvalého stavu, ne zdroj pravdy: každý řádek ověřte proti gitu”
majordomus context

kicker

Název sekce

Úvod, který jednou větou říká, co sekce obsahuje.

04 / kontejnery

Panely a fáze

Kontejner, ve kterém sedí každý blok, prostý, tónovaný nebo tichý, a řada fází spojených šipkami, která se na širokém displeji čte zleva doprava a na úzkém shora dolů.

1

Deklarovat

share/design/tokens.yaml rozhoduje každou hodnotu

Fáze 1 ze 4.

2

Generovat

majordomus generate design jej promítá

Fáze 2 ze 4.

3

Kontrola

scripts/ci/design-check odmítá drift

Fáze 3 ze 4.

4

Opotřebení

každý povrch importuje projekce

Fáze 4 ze 4.

05 / seznamy

Stromy, body, trasy, dlaždice

Co repozitář drží, co stránka slibuje, které rozhraní co dělá a kam jít dál.

Repozitář

Co vrstva čte

prismatic-majordomus/

  • .ai/vrstva: politika, pravidla, prompty, workflow
  • apps/spustitelný soubor v Rustu
  • docs/rozhodnutí, manuály a generované dokumenty
  • share/distribuce: schémata, design, druhy
  • site/tento web, odvozený ze zbytku
  • test/případy
    • cases/567 test objects
  • justfilerecepty, které člověk spouští

Záruky

Body, linkované

  • Jedna deklaracekaždý povrch čte stejný registr
  • Deterministickéstejný vstup promítne stejné bajty
  • Vynucovánodeklarované pravidlo má kontrolu
  • Rozšiřitelnéschopnost se deklaruje jednou a promítá

Rozhraní

Routy, popsané

  • Příkazová řádkamajordomus brief
    Lokální prácekaždá schopnost jako příkaz
  • HTTP APIGET /api/v1/brief
    Programový přístupJSON, popsaný OpenAPI
  • MCPmajordomus_brief
    Nástroje pro agentytáž schopnost jako nástroj
  • Documentationhttps://majordomus.dev/docs/ Tento webgenerovaný z repozitáře
189 pravidla ve vrstvěregistry.json · index.by_kind
158 rozhodnutí ve vrstvěregistry.json · index.by_kind
567 testovací objekty ve vrstvěregistry.json · index.by_kind
49 případy užití ve vrstvěregistry.json · index.by_kind
  • Regenerovánonikdy neupravováno ručně
  • Zkontrolovánokontrolami v CI
  • Jeden zdrojvrstva pod .ai/
  • Pro lidi i agentytýž kontrakt

Tabulka řádků

První operace tagu brief
pathmetodaco dělá
/api/v1/briefGETBrief relace

Každý druh, který vrstva drží

Mrak slov, každé v tónu svého místa v seznamu; z indexu registru.

  • adr
  • aplikace
  • oblast
  • publikum
  • claim
  • command
  • kontext
  • kritika
  • nasazení
  • derive-offload
  • distribution-model
  • dokument
  • doména
  • funkce
  • mezera
  • implementace
  • intent
  • issue
  • knowledge
  • mesh-declaration
  • milestone
  • okamžik
  • policy
  • profil
  • prompt
  • release-record
  • pravidlo
  • scope
  • session
  • dovednost
  • taxonomie
  • test
  • use-case
  • workspace
  • Jeden zdrojvrstva pod .ai/
  • Odvozenépřegenerované, nikdy ručně upravované
  • Zkontrolovánokontroly v CI
  • Objevenonic se neregistruje ručně
  • Pro lidi i agentystejný kontrakt

06 / kód

Terminál, příkazy, karty, operace

Přepis zaznamenaný generátorem, strukturovaný blok výstupu, příkazy s tlačítky kopírování, pruh záložek ve třech podobách a operace čtené z vlastního popisu API.

$ majordomus start 'the follow-up' --scope lib
started t-<id>  profile=implementation  scope=lib
INFO handover    .ai/local/state/handovers/<time>--main--<head>--<hash>.md — prior record, same_worktree_same_branch, exact, <age> ago  [reproduce: majordomus handover --resolve]
next: majordomus context; checkpoint every 15m; majordomus check before claiming anything
Prismatic Majordomusv0.30.2
rules
189
rozhodnutí
158
skills
8
commands
31
ze site/data/registry/registry.json

Příkazy

Tlačítka kopírování se objeví, když skript běží; výpis se čte, nespouští

design.json · tóny
[
  {
    "about": "the first step of a sequence; the tone of the CLI, the files a repository holds",
    "class": ".mj-tone--blue",
    "dark": "oklch(70.7% 0.165 254.624)",
    "light": "oklch(48.8% 0.243 264.376)",
    "name": "blue"
  },
  {
    "about": "the second step; the tone of the typed model and of the API",
    "class": ".mj-tone--violet",
    "dark": "oklch(70.2% 0.183 293.541)",
   …
  • majordomus context
  • majordomus check
  • majordomus brief

Brief relace

Jedna schopnost, tři povrchy

CLI

majordomus brief

HTTP

GET /api/v1/brief
curl -s "http://127.0.0.1:8741/api/v1/brief?session=00000000-0000-0000-0000-000000000000&checkouts=this&local=true"

MCP

majordomus_brief

Přehled

Přehledový panel segmentovaného pruhu.

Prozkoumat

Inspekční panel segmentovaného pruhu.

Spustit

Panel běhu segmentovaného pruhu.

Přehled

Panel přehledu pruhu štítků.

Prozkoumat

Inspekční panel pruhu pills.

Spustit

Panel běhu pruhu pills.

Operace

Operace briefu, z vlastního popisu API

GET/api/v1/briefBrief relace

Jeden řádek a několik dalších: epizoda a úloha této relace (ta, kterou vlastní daná relace poskytovatele, jinak ta ukazatele), peerové každé nástěnky s nástěnkami, které nešlo přečíst n…

07 / dashboard

Řídicí rovina, zobrazená

Okno s navigací, počty, řadou, tím, co se změnilo, a akcemi, které člověk provádí. Cockpit vykresluje spustitelný soubor; tyto jsou pro stránku, která ho popisuje.

Přehled repozitáře

z generovaného registru
  • Rules189
  • Decisions158
  • Tests567
  • Features29

Rozhodnutí na release

nejstarší první, z changelogu

Rychlé akce

Changes in 1.0.0-alpha.1

Vrstva

  • rules189
  • rozhodnutí158
  • tests567
  • případy užití49
  • Index ok
  • Diagnostika čisté

08 / dokumentace

Stopa, hledání, obsah, tok

Části stránky dokumentace: kde je, jak najít jinou, co obsahuje a kroky prvního spuštění. Obsah na straně této stránky je komponenta obsahu, která označuje sekci, kterou právě čtete.

  1. 1

    Instalace

    jeden archiv, jeho digest ověřen

    • curl -fsSL https://majordomus.dev/install.sh | sh
  2. 2

    Dohlížet

    zapisuje .ai/ a nic jiného

    • majordomus init
  3. 3

    Projekt

    každý bootstrap z politiky

    • majordomus update
  4. 4

    Briefing

    co repozitář už ví

    • majordomus context

09 / diagramy

Zásobník, vějíř a cyklus

Kreslí se z dat, která dostanou, bez skriptu: křivky vějíře se počítají z toho, kolik řádků má každá strana, a na telefonu se části skládají pod sebe se šipkou mezi nimi.

  • .ai/politika, pravidla, prompty
  • docs/rozhodnutí a příručky
  • share/schémata a design
  • test/cases/případy

share/design/tokens.yaml

jedna deklarace, čtená jako typovaný model

  1. paletasurové barvy
  2. rolesémantický povrch
  3. statuspět významů a jejich slova
  4. tónyodstíny pro identitu
  5. typografie · rozložení · pohybsdílená měření
  • Příkazová řádkamajordomus
  • HTTP API/api/v1/
  • Swagger UI/swagger
  • Cockpit/cockpit
  • MCPmajordomus mcp
  • Tento webGitHub Pages
  • S anotacemi

    karta ukazuje na to, co popisuje

  • Přímé vodiče

    jedna na kartu, ve výšce karty

$ majordomus check --explain
# task
  id=t-<id>
  task=narrow the parser
  profile=implementation
  owner=<owner>
  scope.0=lib
  started_at=<time>
  checkpoint_at=<time>
  outcome=active
  repository_id=<repo>/.git
  worktree=<repo>
  branch=main
  head=<sha>
  working_tree=clean
# profile implementation
  name=implementation
  description=build …
  • Jakýkoli střed

    terminál, okno, zásobník

  • Skutečný výstup

    tento přepis zaznamenal generátor

  1. Upravit tokens.yaml
  2. majordomus generate design
  3. design-check v CI
  4. Nosí ho každá plocha
Návrh

Body na kartách

seznam vedle dashboardu

  • Odvozenonic není registrováno ručně
  • Seřazenopořadí deklarace na každém povrchu
  • Změřenokaždý barevný pár proti WCAG 2.1 AA

10 / obrazovek

Obrazovky složené ze sady komponent

Celé stránky sestavené pouze z těchto komponent, z nichž každá vykresluje jeden z návrhů stránek z vlastních dat tohoto repozitáře.

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