Com Windsurf permet desenvolupar con IA mantenint el control i la qualitat

Per Jesús David Melián Hernández, RPA/IA/BTP Expert | Vanture ESS

Durant els últims mesos he estat experimentant amb diferents maneres d’integrar la intel·ligència artificial en el meu dia a dia com a desenvolupador. El meu objectiu no era que la IA programés per mi, sinó trobar una manera de treballar amb ella sense perdre el control sobre el procés ni la qualitat del codi.

Després de diverses proves, ajustos i algun experiment fallit, vaig trobar una metodologia que em funciona molt bé amb Windsurf. Comparteixo aquí la meva manera de treballar per si pot servir de guia a altres desenvolupadors que vulguin aprofitar la IA sense renunciar a les bones pràctiques.

1. Definir la jerarquia i el context del projecte

Abans de generar una sola línia de codi, preparo l’estructura del projecte. Tenir les carpetes i la jerarquia definides des del principi ajuda al fet que Windsurf treballi amb context i no improvisant.

Per exemple, acostumo a partir d’una estructura així:

/src
  /api
  /components
  /services
  /utils
/docs
  FIX.md
  UPDATES.md
prompt_context.txt

En l’arxiu prompt_*context.txt incloc:
Una descripció breu del propòsit de cada carpeta, les dependències principals i l’estil de programació. És la meva “injecció de context” ràpida. Si la IA es desorienta, simplement ho reexpedició i llest, tornem a estar alineats!

2. Traçabilitat real: errors, canvis i documentació automàtica

Una de les funcions que més valoro de Windsurf és com manté actualitzats dos arxius que actuen com a diari tècnic del projecte:

·FIX.md – Registra errors detectats, la seva causa i com es van solucionar.

·UPDATES.md – Resumeix millores, noves funcions i canvis rellevants.

Quan demano “documenta” o “actualitza la documentació”, Windsurf completa tots dos arxius segons els meus últims canvis. Això evita perdre informació pel camí i fa que la traçabilitat sigui gairebé automàtica.

3. Commits manuals per a assegurar la qualitat

Encara que la IA ajudi, continuo preferint fer els commits a mà.
Els mantinc petits, atòmics i molt revisats. Això em permet:

·Verificar cada bloc abans de confirmar-lo.

·Mantenir un historial net i fàcil de revertir.

·Detectar fallades lògiques que la IA podria no veure.

A més, soc molt estricte amb els arxius innecessaris: res de temporals, gens de “soroll”. Prefereixo un repositori net i coherent.

4. Arxius de referència per a mantenir estil i coherència

Mantinc un petit set d’arxius d’exemple que no formen part del codi funcional, però que marquen com m’agrada estructurar classes, funcions, imports, etc.

Aquests “arxius guia” serveixen perquè Windsurf entengui el meu estil i generi mòduls que encaixen amb la resta del projecte sense que jo hagi de recordar-l’hi cada dos per tres.

5. La IA no substitueix al criteri del desenvolupador

Reviso a fons tot el que genera Windsurf abans d’integrar-ho. No busco velocitat costi el que costi, sinó fluïdesa amb qualitat.

Per a mi, el punt òptim està a combinar:

·La precisió humana,

·amb la capacitat de generació i context de la IA.

La IA ajuda, però el criteri final sempre ha de venir de nosaltres.

El valor d’una estructura clara i un flux guiat

Usar Windsurf no significa que la IA programi per tu, sinó que tu defineixes com ha de fer-ho amb tu.

Amb una estructura ben plantejada, un control estricte de versions i documentació constant, Windsurf es converteix en un assistent tècnic que augmenta la productivitat sense comprometre la qualitat.