Ilmainen AI-orkestraattori ei-⁠kehittäjille

Orkestraattoripakettimme on tehty ihmisille, jotka eivät ole kehittäjiä. Sen avulla voi johtaa tekoälykoodausagenttien tiimiä kirjoittamatta tai tarkastamatta koodia itse: sinä päätät, mitä rakennetaan ja miksi, ja tekoälytiimi hoitaa loput.

Olemme julkaisseet paketin ilmaisena, julkisena repositoriona GitHubissa: github.com/capefinn/orchestrator-kit. Se kuvaa, miten ohjelmistoprojektia ajetaan yhdellä tekoälyorkestraattorin istunnolla ja miten samalla tavalla syntyy myös sisältöä, kuten artikkeleita, videoita ja esityksiä.

Paketti on esimerkki, jota voi kopioida ja muokata. Se ei ole tuote, eikä se tarvitse mitään meidän koodiamme.

Mikä orkestraattori on

Orkestraattori on yksi tekoälyn keskusteluistunto Claude Codessa, joka hoitaa rakennustyön ihmisomistajan puolesta. Omistaja päättää, mitä rakennetaan ja miksi. Orkestraattori päättää, miten.

Jokaisesta työstä orkestraattori kirjoittaa suunnitelman tikettiin, käynnistää apuagentit rakentamaan sen, antaa muutoksen arvioitavaksi, yhdistää sen ja tarkistaa, että se toimii tuotannossa. Omistajalle se lähettää yhden viestin päivässä.

Ennen tätä mallia jokainen tekoälyn tekemä muutos odotti, että omistaja painaa "merge", usein vuorokauden tai pidempäänkin. Nyt riippumaton arvioija lukee koodin, ja omistaja päättää vain lyhyestä, nimetystä asialistasta.

Roolit

Jokainen rooli on erillinen tekoälyistunto tai -agentti omilla ohjeillaan. Mallitaso ratkaisee suurimman osan kustannuksista, joten jokaisella roolilla on oma tasonsa:

• Ihmisomistaja: päättää muutamasta nimetystä alueesta ja lukee yhden päiväviestin ja yhden tehtävälistan. Ei tarkasta koodia.
• Orkestraattori (vahvin malli): valitsee seuraavan tiketin, kirjoittaa suunnitelman, käynnistää rakentajat ja arvioijat, päättää yhdistämisjärjestyksestä ja keskustelee omistajan kanssa. Se ei koskaan kirjoita koodia, jonka se itse arvioi.
• Rakentaja (keskihintainen malli): rakentaa yhden tiketin omassa kansiossaan ja avaa yhden luonnos-pull requestin. Samaan aikaan toimii enintään noin kuusi. Se ei koskaan yhdistä.
• Loppuarvioija (vahvin malli, uusi istunto): arvioi muutoksen, ajaa testit ja antaa yhden päätöksen täsmälleen sille commitille, jonka se tarkisti. Tietoturvaherkät muutokset saavat kaksi arvioijaa.
• Kirjuri ja tiedustelija (pienemmät mallit): mekaaniset vaiheet, kuten yhdistäminen tarkistusten läpäisyn jälkeen, sekä vain-luku-haut.
• Vaativan suunnittelun agentti: ratkaisee yhden vaikean suunnitteluongelman kirjallisessa muistiossa. Se ei koskaan kirjoita koodia.
• Työnkulun parantaja: mittaa noin kerran viikossa, mihin tokenit, rahat ja odotusaika kuluvat, ja ehdottaa muutoksia.

Päivän kulku

Omistaja aloittaa päivän kirjoittamalla /orchestrator uuteen keskusteluun. Orkestraattori tarkistaa, ettei toista orkestraattorikeskustelua ole käynnissä, ja lukee eilisen luovutustiedoston tarkistuslistana, ei tosiasioina. Sitten se lukee ajantasaisen tilan GitHubista ja tikettitaululta, lähettää omistajalle enintään kahdeksan riviä ja aloittaa työt odottamatta vastausta.

Jokainen työ etenee samoilla vaiheilla:

1. Suunnitelma tikettiin: mitä muuttuu, mitkä tiedostot, mitkä testit, riskit ja miten muutos perutaan. Suunnitelma, jossa on yli noin 1 500 muutettua riviä tai useampi kuin yksi tarkoitus, jaetaan osiin.
2. Rakennus: jokainen rakentaja työskentelee omassa git worktreessään, erillisessä kansiossa, jolla on oma haara.
3. Arviointi: uusi arvioija-istunto tarkistaa muutoksen suhteessa tikettiin, omistajan alueisiin, tietoturvaan, rahaan, tietosopimuksiin ja asiakkaille näkyviin teksteihin.
4. Yhdistäminen portin kautta (katso alla).
5. Tuotannon tarkistus: julkaisu on valmis ja muuttunut ominaisuus toimii. Jos jokin rikkoutui, muutos perutaan ensin ja syy selvitetään vasta sen jälkeen.

Päivän päätteeksi omistaja kirjoittaa /orchestrator-handover. Orkestraattori pysäyttää rakentajat turvallisesti ja kirjoittaa enintään 70 rivin luovutustiedoston, josta huomisen keskustelu alkaa. Uusi keskustelu joka päivä on edullisempaa kuin yksi pitkä, koska pitkä keskustelu lähettää koko historiansa uudelleen jokaisen viestin mukana.

Mistä omistaja yhä päättää

Omistajan päätettäväksi tulevat vain nämä alueet: raha (korkeampi kulukatto, uusi maksullinen toimittaja, itsenäisesti pyörivä maksullinen työ), se, mitä asiakkaat näkevät (ominaisuudet, hinnoittelu, laajuus), lukitut tietomuodot, asiakastiedot, joita ei voi palauttaa, avaimet ja käyttöoikeudet, kaikki yrityksen ulkopuolelle lähtevä sekä itse sääntöjen muutokset.

Kaiken muun orkestraattori päättää ja raportoi. Jokaisesta kysymyksestä tulee yksi kortti yhdelle yksityiselle tehtävälistalle, ja kortissa on vaihtoehto A, vaihtoehto B, suositus ja aika minuutteina.

Yhdistämisportti

Yhdistämisportti on syy siihen, ettei laatu riipu siitä, että omistaja lukee koodia. Se on pieni skripti, jonka Claude Code ajaa ennen jokaista komentorivikomentoa. Se estää yhdistämisen, ellei:

• pull request ole luonnos ja sen kohde ole päähaara;
• jokainen vaadittu CI-tarkistus ole läpäisty uusimmalla commitilla;
• sallittu malli ole antanut hyväksyvän päätöksen täsmälleen tälle commitille (kaksi päätöstä tietoturvaherkille tiedostoille);
• pull request muuta sääntötiedostoja.

Yhdistämiskomento nimeää myös arvioidun commitin, joten arvioinnin jälkeen tehty push saa yhdistämisen epäonnistumaan. Paketti kertoo rajoitukset suoraan: portti estää tekoälyistuntojen vahingossa tai huolimattomasti tekemät yhdistämiset. Se ei estä ihmistä ohittamasta sitä tarkoituksella, esimerkiksi GitHubin verkkosivulla.

Paketissa on säännöt pseudokoodina ja esimerkkiskripti, jota voi muokata omaan käyttöön.

Paketin opetukset

Paketti perustelee jokaisen säännön. Muutamia niistä:

• Pidä orkestraattorin keskustelu vapaana. Kaikki, mikä vaatii yli noin kaksi työkalukutsua, siirretään taustaagentille.
• Anna malli erikseen, kun käynnistät agentin. Agentti, joka perii orkestraattorin mallin, ajaa kalliilla tasolla.
• Arvioija ei ole koskaan se istunto, joka kirjoitti koodin. Sillä istunnolla on yhä samat väärät oletukset, jotka sillä oli kirjoittaessaan.
• Laita säännöt hookiin, älä muistiin. Agentit unohtavat säännöt, varsinkin kun pitkä keskustelu tiivistetään.
• Suunnittele kulukatot ja hätäkatkaisimet alusta asti. Jokainen maksullinen kutsu kulkee katon, nopeusrajoituksen ja kytkimen kautta, joka pysäyttää kaiken maksullisen työn.
• Tarkista ajantasainen tila ennen vastaamista. Luovutustiedostot ja tikettitaulut vanhenevat tunneissa.

Näin lataat ja aloitat

1. Avaa github.com/capefinn/orchestrator-kit. Kloonaa se gitillä tai lataa ZIP-tiedostona "Code"-painikkeesta.
2. Lue README.md, täydellinen opas. Jos et käytä Claude Codea, lue orchestrator-guide.md: opas ja kaikki tiedostot yhdessä dokumentissa.
3. Kopioi kaksi skilliä kansioon ~/.claude/skills/, agenttitiedostot repositoriosi kansioon .claude/agents/ ja rakentajan brief kansioon ~/.claude/orchestrator/.
4. Ota yhdistämisportti käyttöön ja testaa se tiedoston templates/merge-gate-hook.md ohjeiden mukaan.
5. Kirjoita yhden sivun säännöt: omistajan alueet, yhdistämissääntö ja tietoturvasäännöt.
6. Etsi tiedostoista kulmasulkeissa olevat tekstit, kuten <main checkout path>, ja täytä omat arvosi.

Paketti käyttää Notionia tikettitauluna ja omistajan tehtävälistana ja selittää, miten se otetaan käyttöön. Mikä tahansa työkalu käy, jos agentit voivat lukea sitä, lisätä siihen sisältöä ja kommentoida sitä.

Paketti on MIT-lisenssillä. Voit kopioida, muokata ja käyttää sitä uudelleen myös kaupallisessa työssä, kunhan säilytät tekijänoikeusilmoituksen.

Opi se tiimisi kanssa

Järjestämme käytännönläheisiä työpajoja agenteista ja orkestraattoreista. Katso tekoälytyöpajamme.