Com treballem
Aquesta és la versió tècnica de com treballem: el camí que fa una petició fins que es converteix en programari, i quin agent fa què pel camí.
Cada tasca la fa un agent d’IA amb una sola feina. Les persones dirigeixen els agents, aproven cada canvi i proven cada versió. Quan un pas només funciona als projectes de client, ho diem.
De la petició a la versió
Aquest és el camí complet, per a un producte en producció o que ja té usuaris. Un MVP o una primera versió en fa un de més lleuger i ràpid, perquè vegeu abans versions que funcionen: la planificació, els agents, les propostes amb la seva prova i les comprovacions i revisions automàtiques es mantenen; la persona que ha dirigit els agents aprova cada canvi, les proves d’extrem a extrem, visuals i d’accessibilitat esperen els primers usuaris i no hi ha desplegament de previsualització. Quan el producte té usuaris, comença el camí complet.
-
1 · Planificació
Cada petició entra en una sola cua: el missatge d’un client, una licitació, una idea nostra. Un agent de planificació la classifica: cada petició es converteix en una tasca d’un projecte, o es descarta amb el motiu per escrit.
-
2 · Un orquestrador per àrea
Un projecte té un agent orquestrador per a cada àrea de la feina, com ara la interfície, el servidor, les proves o el procés de publicació. Cadascun divideix la seva àrea en lliurables, encarrega cada lliurable a una sessió d’agent i en porta l’estat per escrit. Ell mateix mai no edita fitxers, no desa canvis ni envia res.
-
3 · Una sessió per lliurable
Un lliurable és un canvi al codi, un document o una recerca. Cadascun té la seva sessió d’agent en una branca pròpia, i diverses sessions treballen alhora.
-
4 · Proposta de canvi
Cada canvi acaba en una proposta de canvi que porta la prova del resultat: captures per al que es pot veure i un diagrama per a la resta. La resposta a un correu queda en esborrany fins que una persona l’envia.
-
5 · Integració contínua
Als projectes de client, cada proposta passa compilació, anàlisi estàtica, comprovació de tipus i proves unitàries, amb les eines de cada tecnologia, i proves d’extrem a extrem, visuals i d’accessibilitat WCAG 2.2 AA quan cal; en aquest lloc web, validació de l’HTML, comprovació d’enllaços i comprovació d’accessibilitat. Si alguna comprovació falla, l’agent la corregeix a partir del registre.
En un MVP: compilació, anàlisi estàtica, comprovació de tipus i proves unitàries; les proves d’extrem a extrem, visuals i d’accessibilitat arriben amb els primers usuaris.
-
6 · Revisions automàtiques
Als projectes de client, un servei de revisió automàtica de codi llegeix cada proposta i l’agent que l’ha feta corregeix o respon cada comentari. Una segona revisió, feta per un dels models d’IA més recents amb un nivell de raonament alt, torna a buscar el que la primera revisió no ha vist: normes de disseny i convencions del projecte.
-
7 · Aprovació humana
Una persona llegeix i aprova cada canvi que fem abans que entri al codi d’un projecte, en tots els projectes. Quan el producte d’un client ja té usuaris, aquesta persona és diferent de la que ha dirigit els agents.
En un MVP: la persona que ha dirigit els agents llegeix el canvi i l’aprova.
-
8 · Proves de cada versió
Una persona de l’equip es dedica al control de qualitat i prova cada versió abans que arribi als usuaris.
-
9 · Desplegament
Als projectes de client, cada proposta té el seu propi desplegament de previsualització, on vosaltres i l’equip podeu provar el canvi abans que entri al codi; quan hi entra, arriba a producció automàticament. Una altra persona de l’equip porta les operacions i el suport del que és en producció.
En un MVP: sense previsualització: quan el canvi entra al codi, va directament a la versió que proveu.
-
10 · Lliçons escrites
Quan un projecte ens ensenya alguna cosa, l’escrivim com una regla amb una manera de comprovar-la. Els agents llegeixen les regles abans de començar, i així la tasca següent comença a partir d’aquí.
Vigies
Els vigies són agents que revisen, entre altres coses, els registres, els possibles errors, les peticions que arriben i els comentaris, i avisen del que necessita una persona. Només llegeixen i informen: no canvien res d’un projecte, i el que troben va a la cua.
Monitor
-
Monitor de propostes de canvi
Un monitor vigila les nostres propostes de canvi i desperta la sessió responsable quan falla una comprovació, apareix un conflicte de fusió o algú hi deixa un comentari de revisió. La sessió ho corregeix a la mateixa branca, i així ningú no ha d’estar pendent de comprovar-ho.