Vai al contenuto principale
Metodologia

Quello che un team piccolo riesce a consegnare quando la macchina si prende la parte ripetitiva

Non vendiamo «usiamo l’IA»: mostriamo la pipeline e i dati del nostro sito. Persone che decidono, agenti che eseguono e una CI che non lascia passare il lavoro a metà.

996
Pagine pubblicate
5
Lingue in parità
635
Articoli tecnici
22
Controlli automatici

La metodologia di Soamee unisce il processo CRAFT (Consult, Research, Architect, Forge, Track) allo sviluppo assistito da agenti IA e a un’integrazione continua che blocca qualsiasi consegna incompleta. Le decisioni di prodotto, architettura e design sono sempre umane; gli agenti si occupano del lavoro ripetitivo e verificabile: boilerplate, traduzioni, migrazioni, test e controlli SEO. Ogni modifica passa da una revisione umana e da 22 automazioni di CI che verificano copertura delle traduzioni, immagini, metadati SEO, Schema.org, anteprime social e link rotti prima di arrivare in produzione. Il risultato misurabile sul nostro repository: 996 pagine pubblicate in cinque lingue, 635 articoli e 130 casi di successo mantenuti in parità da un team boutique di Madrid.

La pipeline

CRAFT, con uno strato di agenti sotto

Il processo non cambia: cambia chi fa ogni compito dentro ogni fase. Sopra, i controlli di qualità che nessuno salta. Sotto, ciò che deleghiamo agli agenti.

Controlli di qualità

Revisione umana · Test · CI · Audit SEO · Deploy

01
Consult
Consulenza iniziale

Capiamo il business e il problema. Usciamo con obiettivi misurabili e un perimetro preliminare.

02
Research
Ricerca

Analizziamo utenti, flussi e sistemi esistenti. Decidiamo cosa costruire e cosa integrare.

03
Architect
Architettura

Progettiamo architettura, modello dati e piano di consegne ordinato per valore di business.

04
Forge
Sviluppo

Sprint di 2-3 settimane con demo alla fine di ognuno. Software funzionante dal primo mese.

05
Track
Misura ed evoluzione

Rilasciamo, misuriamo l’uso reale e facciamo evolvere il sistema: manutenzione, migliorie e nuovi moduli.

Strato di agenti

Niente arriva in produzione senza superare tutti e cinque i controlli, chiunque lo abbia scritto.

Divisione del lavoro

Cosa decide una persona e cosa accelera la macchina

La domanda onesta di ogni cliente è: «se lo fa l’IA, perché sto pagando voi?». Ecco la risposta, senza fronzoli.

Sempre umano

Qui non deleghiamo. È dove un progetto si vince o si perde.

  • Cosa costruire e in che ordine: perimetro, priorità e tagli
  • Architettura, modello dati e decisioni costose da disfare
  • Design visivo e di prodotto: niente template generici
  • Revisione di tutto il codice prima del merge
  • Rapporto diretto con te: chi programma è chi sta nella demo
  • Responsabilità sul risultato. Lo strumento non firma nulla

Accelerato dagli agenti

Lavoro verificabile, ripetitivo e noioso. Esattamente dove una macchina non si stanca.

  • Boilerplate e impalcature da un’architettura già decisa
  • Traduzioni in cinque lingue con revisione successiva
  • Migrazioni massive e refactor meccanici su centinaia di file
  • Test, fixture e script di CI
  • Scansione della documentazione di API di terze parti
  • Controlli di accessibilità, SEO tecnico e metadati

Lo mettiamo per iscritto: abbiamo pubblicato un’autopsia del nostro repository con ciò che ha funzionato e ciò che abbiamo dovuto rifare. Leggi l’autopsia del repository →

Controllo qualità

I controlli che nessuno salta

Scrivere codice in fretta è facile. Il difficile è che ad alta velocità niente resti a metà. Per questo il lavoro incompleto non arriva nemmeno al ramo principale.

Copertura delle traduzioni

Se una pagina o un articolo esce in spagnolo senza le sue quattro traduzioni, il push fallisce. Nessun contenuto orfano.

npm run check:translations

Immagini verificate

Controlla che ogni immagine referenziata esista e che due contenuti diversi non riusino lo stesso file.

npm run check:images

Audit SEO

Title, description, h1, canonical e hreflang di ogni URL costruito. Nessuna eccezione manuale.

npm run check:seo

Schema.org

Validazione del JSON-LD di ogni template perché motori di ricerca e LLM capiscano la pagina.

npm run check:schema

Anteprime social

Ogni URL ha la sua card social con il suo copy, generata su richiesta e verificata in CI.

npm run check:og

Hook prima del push

Gli stessi controlli girano sulla tua macchina prima di caricare qualsiasi cosa. La CI è la rete, non il primo avviso.

.githooks/pre-push

A questo si aggiungono gli audit programmati: Lighthouse, link rotti, guardia sui metadati e snapshot di posizionamento. 22 automazioni in tutto.

La prova

Il nostro sito è il caso di studio

Non possiamo mostrarti i numeri interni dei nostri clienti. Possiamo aprire il repository di soamee.com, costruito esattamente con la stessa pipeline.

996
Pagine .astro

Pubblicate e mantenute, rotte dinamiche escluse

130
Casi di successo

26 casi × 5 lingue, sempre sincronizzati

635
Articoli

127 originali in spagnolo con le loro 4 traduzioni

67
Componenti

Design system nostro, senza template comprati

Pagine pubblicate per lingua

Pagine pubblicate per lingua Spagnolo: 238. Inglese: 197. Portoghese: 192. Italiano: 192. Tedesco: 192 Spagnolo 238 Inglese 197 Portoghese 192 Italiano 192 Tedesco 192

La parità multilingua è la metrica più onesta di una pipeline: è la prima cosa che abbandona ogni team a corto di capacità.

Cosa significa per te

Cosa cambia nel tuo progetto

Tre conseguenze concrete di lavorare così, senza promesse che non possiamo mantenere.

Più superficie per sprint

Quello che in un’altra agenzia finisce in «fase 2» — le altre lingue, il pannello di amministrazione, la documentazione — di solito entra nel perimetro iniziale.

Meno debito nascosto

I controlli automatici intercettano ogni giorno ciò che un team umano scopre solo nell’audit dell’anno prossimo.

Nessuna scatola nera

Ti diciamo quale parte ha generato un agente e quale ha rivisto una persona. E il codice è tuo dal primo commit.

FAQ

Domande frequenti

Quelle che ci fanno alla prima chiamata, con risposta prima ancora di chiederle.

L’IA scrive tutto il codice del mio progetto?
No. Gli agenti generano una parte importante del codice ripetitivo, ma ogni modifica passa da una revisione umana prima del merge. Le decisioni di architettura, prodotto e design sono sempre di una persona del team.
Se usate l’IA, il codice è di qualità peggiore?
Il rischio esiste e per questo abbiamo montato i controlli di qualità: revisione umana obbligatoria, test e 22 automazioni che verificano traduzioni, immagini, SEO, Schema.org e link prima di ogni rilascio. L’asticella la mette il processo, non lo strumento.
Di chi è il codice?
Tuo, dal primo commit. Lavoriamo nel tuo repository oppure te lo trasferiamo alla chiusura, con tutta la storia delle modifiche e la documentazione tecnica.
Posso sapere quale parte ha generato un agente?
Sì. I commit con partecipazione di un agente restano marcati nella storia di git, quindi puoi verificare la ripartizione quando vuoi.
Questa metodologia va bene per qualsiasi progetto?
Rende moltissimo su progetti con pattern ripetitivi, contenuti multilingua, migrazioni o molto boilerplate. Su logiche di business molto complesse o design originale il risparmio è minore: lì il peso resta umano, e lo diciamo prima.
E i miei dati riservati?
Non entrano in strumenti di terze parti senza la tua autorizzazione esplicita. In sviluppo lavoriamo con dati sintetici o anonimizzati e firmiamo l’accordo di riservatezza prima di iniziare.
Metodologia di sviluppo con IA

Raccontaci la tua sfida. Ti proponiamo la soluzione.

Senza impegno. In meno di 24 ore riceverai una proposta con ambito, tempistiche e budget. Nessuna clausola nascosta.

Prenota una call gratuita →