Hoe Motir werkt

[01] AI-planning

Van een prompt naar een plan

Begin met een zin, een repository of een import uit Jira, Linear of Plane. De planner leest wat er al is, inclusief een codegraaf van je repository’s, en stelt vervolgvragen waar het verzoek onduidelijk is.

Hij stelt epics, stories, taken en subtaken op, elk met een type, een uitvoerder, een omvang en de bijbehorende blocked_by-relaties. validate_plan controleert de boom voordat jij hem ziet.

[02] Jij · plangoedkeuring

Jij keurt het plan goed

Er komt niets op het bord tot een mens het plan goedkeurt. Vraag om wijzigingen in gewone taal; elke ronde is een nieuwe beurt, en de geschiedenis van het plan bewaart elke versie en waarom die veranderde.

[03] Werkitems

Het bord

Het goedgekeurde plan wordt werkitems met sprints, een backlog en een roadmap. De uitvoerder van elk werkitem is agent of human.

Handmatige taken (een account, een secret, een DNS-record, een release-akkoord) worden stap voor stap doorlopen met motir guide.

[04] Agent-run

Agents bouwen

Een agent pakt het volgende gerede werkitem (motir next of motir run <KEY>), claimt het, bouwt op een eigen branch en opent één pull request per repository, gekoppeld aan het werkitem.

Een bug die hij buiten zijn eigen werkitem vindt, houdt de run niet tegen: de agent zoekt de oorzaak, legt hem met motir log bug vast in de map Bugs als eigen werkitem en gaat door.

Elke run legt de agent-harness, het model, elke stap en de uitkomst vast. Agents verbinden via MCP, op je eigen machine of als gehoste agents van Motir.

[05] Jij · merge-goedkeuring

Jij reviewt en merget

Het werkitem gaat naar Geïmplementeerd en de agent publiceert ‘Zo test je het’. Stories krijgen een acceptatievideo die in CI wordt opgenomen. Jij reviewt, keurt goed en merget; de merge sluit het werkitem. Niets bereikt Klaar zonder een mens.

[06] Reparatie

Als runs stukgaan

Een rode of conflicterende pull request wordt op zijn eigen branch gerepareerd met motir fix, in maximaal vijf pogingen. Een run die is gestopt (een laptop dichtgeklapt, een sandbox kwijt) wordt hervat met motir continue op de branch die hij achterliet.

Bugs die onderweg zijn vastgelegd, wachten in de map Bugs; motir fix bugs werkt ze af, de oudste eerst.

[07] Leerlus

De planner leert

Een agent die een werkitem niet kan bouwen, vraagt eerst of het nog is wat het goedgekeurde plan goedkeurde (get_approved_shape_verdict), zodat een latere wijziging niet de planner wordt aangerekend. Was het plan fout, dan wordt het opnieuw gepland en wordt de wijziging met de reden vastgelegd.

De fout wordt een les, of versterkt er een; is er geen regel die hem dekt, dan wordt er een planningsbug aangemaakt. Het volgende plan leest eerst de lessen. Lessen die 90 dagen niet terugkomen, vervallen.

[08] Geheugen

Het project onthoudt

Ontwerpen, beslispagina’s, docs, lessen, planrevisies en de geschiedenis van elke run staan naast de werkitems. Jij, een nieuwe teamgenoot of de volgende agent kan het project maanden later oppakken zonder dat iemand het opnieuw hoeft uit te leggen.