Rol: Ets un enginyer sènior de {LANGUAGE} que construeix {COMPONENT_TYPE}.
Objectiu: Implementar {FUNCTION_NAME} que {FUNCTION_PURPOSE}.
Restriccions:
- Seguir {STYLE_GUIDE} (nomenclatura, documentació, gestió d'errors).
- Objectiu de complexitat temporal: {BIG_O}. Restriccions de memòria: {LIMITS}.
- Incloure docstring i comentaris en línia per a la lògica no òbvia.
- Evitar dependències externes tret que estigui justificat; si s'afegeixen, explicar-ho.
Entrades:
- Interfícies/Tipus: {TYPES}
- Casos límit: {EDGE_CASES}
- Exemples d'entrades/sortides: {EXAMPLES}
Lliuraments:
1) Només el bloc de codi final.
2) Breu justificació (en punts) després del codi.

Rol: Ets un enginyer sènior de Python que construeix una utilitat de neteja de dades.
Objectiu: Implementar `normalize_names` que estandarditzi els noms d'usuari.
Restriccions:
- Seguir PEP8; generar ValueError en tipus no vàlids.
- Temps O(n); tractar espais en blanc i accents; mantenir la memòria lineal.
- Docstring + comentaris.
Entrades:
- Tipus: List[str] o Iterable[str]
- Casos límit: nuls, múltiples espais, marques d'accent, cognoms amb guionet
- Exemples: [" José Álvarez ", "ANNA-lou "] → ["jose alvarez", "anna-lou"]
Lliuraments:
1) Només el bloc de codi final.
2) Breu justificació.

Rol: Expert sènior de refactorització de {LANGUAGE}.
Tasca: Refactoritzar el codi proporcionat per a {GOAL}: {READABILITY|PERFORMANCE|SAFETY}.
Regles:
- Preservar l'API pública i el comportament.
- Afegir indicacions de tipus i docstrings on faltin.
- Extreure funcions pures per a la provabilitat.
- Substituir nombres màgics; fer complir {STYLE_GUIDE}.
- Proporcionar notes de complexitat abans/després.
Codi d'entrada:
```{LANGUAGE}
{SOURCE}

### 3) Plantilla de generació de proves (proves unitàries + de propietat)
**Quan utilitzar**: Augmentar la cobertura ràpidament.

### 4) Plantilla de revisió de codi (Mode de revisor automatitzat)
**Quan utilitzar**: Revisiones ràpides i consistents abans de l'aprovació humana.

{UNIFIED_DIFF}

### 5) Plantilla de depuració (Repro mínim → Causa arrel)
**Quan utilitzar**: Trobar i corregir errors, crear repros.

---
## Exemple: Del ticket al PR amb Grok 4 Fast
Anem a veure un escenari realista: un ticket de producte sol·licita "cerca mentre escrius amb crides API rebotades i IU optimista".
1) **Redactar el hook**

2) **Demanar proves**

3) **Executar una passada de revisió**

4) **Refinar**

Resultat: tindràs codi llest per a la producció més proves, i la IA haurà documentat el seu raonament perquè un company d'equip pugui seguir-lo.
---
## Patrons de prompt que eleven la qualitat de la sortida
- **Rol + Objectiu + Restriccions + Entrades + Lliuraments**: Aquesta estructura dóna a Grok 4 Fast tot el que necessita per mantenir-se en els rails.
- **Enumeració de casos límit**: Llista sempre els casos complicats. El model els incorporarà a les proves i les proteccions.
- **Objectius de complexitat**: Demanar O(n) o límits de memòria empeny a millors algoritmes.
- **Contractes API**: Enganxa tipus/interfícies aviat; el model s'alinearà amb ells.
- **Contractes de sortida**: Sol·licita el codi final primer, després la justificació. Això manté les respostes netes per copiar/enganxar.
---
## Guies d'estil i consistència: Fer-ho llest per a l'equip
Si vols una sortida consistent a tot un equip, estandarditza:
- **Guies d'estil de llenguatge**: PEP8, Effective Go, Airbnb JS, Rust API Guidelines.
- **Convencions d'error**: return vs throw, codis d'error, semàntica de reintent.
- **Normes de prova**: nomenclatura, directoris de fixtures, llindars de cobertura.
- **Valors per defecte de seguretat**: validació d'entrada, escapament, gestió de secrets.
Inclou-los com a constants a les teves plantilles perquè Grok 4 Fast els internalitzi cada vegada.
---
## Prompts de seguretat primer per a codi segur
Afegeix aquestes clàusules de seguretat a les teves plantilles:
- **Validació d'entrada**: "Validar i sanejar totes les entrades no fiables."
- **Higiene de secrets**: "Sense secrets al codi. Llegir de l'entorn i documentar les variables necessàries."
- **Escrutini de dependències**: "Explicar i justificar qualsevol nova dependència; preferir la biblioteca estàndard."
- **Seguretat de serialització**: "Utilitzar analitzadors segurs; evitar eval/Function/deserialització insegura."
- **Comprovacions AuthZ**: "Fer complir l'autorització en rutes sensibles; afegir proves per als intents de bypass."
---
## Prompts de rendiment: Evitar les trampes habituals
- "Minimitzar les assignacions; reutilitzar els buffers quan hi hagi grans càrregues útils."
- "Evitar les consultes N+1; processar per lots o pre-obtenir."
- "Utilitzar streaming/iteradors per a big data."
- "Memoritzar funcions pures; perfilar punts calents."
- "Afegir benchmarks i explicar les compensacions."
---
## Llistes de verificació de revisió que pots enganxar als PR
Inclou una llista de verificació curta perquè cada revisió sigui consistent:
- Compatibilitat de l'API confirmada
- Gestió de col·leccions nul·les/indefinides i buides
- Neteja de recursos (fitxers, sòcols, subscripcions)
- Proteccions de concurrència (bloquejos, atòmics, idempotència)
- Nivells de registre apropiats; sense dades sensibles
- Proves actualitzades; migracions documentades
---
## Flux de treball d'equip: Fer de les plantilles de prompt un actiu compartit
- **Centralitzar les plantilles** al teu repositori (per exemple, directori `/.prompts`).
- **Parametritzar** variables com `{LANGUAGE}`, `{STYLE_GUIDE}`, `{BIG_O}` utilitzant fragments o macros d'editor.
- **Versionar** les teves plantilles de prompt i revisar-les com a codi.
- **Crear manuals d'estratègies** per a la redacció de funcions, la refactorització, l'escriptura de proves i les comprovacions de versions.
Per cert, si el teu equip prefereix un copilot de codificació costat a costat que visqui al navegador i dins dels documents, val la pena assenyalar que [Sider.ai](https://sider.ai/) pot ajudar-te a emmagatzemar i reutilitzar plantilles de prompt, executar revisions de codi en diffs i mantenir el context entre pestanyes. És una manera convenient d'operacionalitzar aquests prompts de Grok 4 Fast a tota la teva organització sense la fatiga de copiar/enganxar.
---
## Biblioteca de copiar i enganxar: Prompts llestos per utilitzar
### Controlador d'API de TypeScript (Node/Express)

### Pas de pipeline de dades de Python

### Guarda de concurrència de Go

### Component accessible de React

---
## Com iterar ràpidament amb Grok 4 (Cicle de retroalimentació ajustat)
1) **Comença petit**: Demana una funció, no tot el servei.
2) **Restringeix les sortides**: "Un bloc de codi, després llistes amb vinyetes."
3) **Exigeix proves**: Cada característica ha de tenir proves en la mateixa passada.
4) **Fixa les decisions**: "Explica les contrapartides. Si no estàs segur, fes preguntes aclaridores."
5) **Millora progressiva**: Millora per capes: primer la correcció, després el rendiment i, finalment, la llegibilitat.
---
## Mesurar l'èxit: Les plantilles han ajudat?
Fes un seguiment de mètriques senzilles:
- Temps del cicle de PR (creat → fusionat)
- Taxa de reelaboració de la revisió (canvis sol·licitats per PR)
- Delta de cobertura de proves per característica
- Incidències de producció vinculades al codi revisat per IA
Si els números tenen la tendència correcta, duplica. Si no, ajusta les teves plantilles i inclou més context ({types}, {logs}, {diffs}).
---
## Errors comuns que cal evitar
- Indicacions massa àmplies com "construeix el backend". Divideix-ho en unitats.
- Oblidar-se dels casos límit. Enumera'ls sempre.
- Permetre la proliferació de biblioteques. Demana una justificació.
- Ometre les proves "per a més tard". Integra-les a la indicació.
- Acceptar revisions vagues. Exigeix llistes de verificació i nivells de gravetat.
---
## Llista de verificació d'inici ràpid
- Crea una carpeta `/prompts` al teu repositori.
- Desa les plantilles de redacció, revisió i prova.
- Parametriza els camps comuns amb variables de fragment.
- Prova amb una característica aquesta setmana; mesura els resultats.
- Itera en funció dels comentaris dels revisors i de les incidències.
---
## Consideració final
Grok 4 Fast és excel·lent per produir codi ràpidament, però el veritable poder prové de plantilles d'indicacions ben estructurades que codifiquen els teus estàndards. Tracta les indicacions com a infraestructura. Controla'n les versions. Revisa-les. I deixa que Grok 4 Fast s'encarregui del codi repetitiu perquè el teu equip es pugui centrar en l'arquitectura i el producte.
Pas següent: tria una plantilla de les anteriors, enganxa-la al teu editor, intercanvia el teu context i envia un PR avui mateix.
### FAQ
P1: Com puc utilitzar Grok 4 Fast per a la redacció de codi amb un estil coherent?
Utilitza una plantilla d'indicació estructurada que estableixi el paper, l'objectiu, les restriccions i la guia d'estil. Inclou objectius de complexitat, casos límit i lliuraments perquè Grok 4 Fast generi codi coherent i llest per a la producció.
P2: Pot Grok 4 Fast fer revisions de codi fiables amb plantilles d'indicacions?
Sí. Proporciona un diff, els estàndards del teu equip i una llista de verificació per a la seguretat, el rendiment i la compatibilitat de l'API. Demana conclusions classificades per gravetat i suggeriments de pedaços mínims.
P3: Quina és la millor manera de generar proves utilitzant Grok 4 Fast?
Utilitza una plantilla de generació de proves que especifiqui el framework, els objectius de cobertura i els casos límit. Demana proves unitàries i basades en propietats, a més d'un breu pla de cobertura.
P4: Com puc evitar el codi insegur de les sortides de la IA?
Afegeix clàusules de seguretat a les teves indicacions: validació d'entrada, higiene de secrets, justificació de dependències i serialització segura. Exigeix notes explícites sobre les contrapartides de seguretat.
P5: Com acceleren les plantilles d'indicacions els cicles de PR amb Grok 4 Fast?
Les plantilles redueixen l'ambigüitat, estandarditzen les sortides i carreguen per endavant les proves i les revisions. Això escurça els intercanvis, redueix la reelaboració i t'ajuda a fusionar més ràpidament.