@mammals-at-work/yacs 0.8.8 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agents/README.an.md +196 -0
- package/agents/README.ca.md +196 -0
- package/agents/README.es.md +196 -0
- package/agents/README.eu.md +196 -0
- package/agents/README.gl.md +196 -0
- package/agents/README.ja.md +196 -0
- package/agents/README.md +196 -0
- package/agents/README.pt-br.md +196 -0
- package/agents/backend-expert/AGENT.md +64 -0
- package/agents/frontend-expert/AGENT.md +67 -0
- package/agents/infra-expert/AGENT.md +66 -0
- package/agents/qa-expert/AGENT.md +78 -0
- package/agents/security-expert/AGENT.md +80 -0
- package/i18n/an.json +26 -11
- package/i18n/ca.json +21 -6
- package/i18n/en.json +19 -4
- package/i18n/es.json +19 -4
- package/i18n/eu.json +29 -14
- package/i18n/gl.json +23 -8
- package/i18n/ja.json +27 -12
- package/package.json +8 -8
- package/{i18n.js → src/i18n.js} +1 -1
- package/{install.js → src/install.js} +307 -92
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# Agentes YACS
|
|
2
|
+
|
|
3
|
+
Agentes especializaos pa Claude Code. Caá agente tié conosimientu profundu de su dominio e implementa buenya prátigas e su área.
|
|
4
|
+
|
|
5
|
+
## ¿Qué son los agentes?
|
|
6
|
+
|
|
7
|
+
Los agentes son personas expertas persistentes que:
|
|
8
|
+
- Aprendie la estructura de tu proiecto e la primera invocasión
|
|
9
|
+
- Mantiene experiencia e conversaciones dientro de una sesión
|
|
10
|
+
- Pueen ser invocaos explícitamente o activaos automáticamente por Claude Code
|
|
11
|
+
- Proporcionan recomendaciones anchadas en tu código real
|
|
12
|
+
- Implementan principios y patrones específicos del dominio
|
|
13
|
+
|
|
14
|
+
A diferensia de las skills (comanuos puntuales), los agentes son conscientes del contexto y con estau.
|
|
15
|
+
|
|
16
|
+
## Agentes
|
|
17
|
+
|
|
18
|
+
### 🏢 Experto en Backend (`backend-expert/`)
|
|
19
|
+
Se espeshializa en arquitektura del serviador: APIs, servishios, modelos de datos, autentifikashión y rendemiento.
|
|
20
|
+
|
|
21
|
+
**Cuandu usalo:**
|
|
22
|
+
- Revisar diseño de API o contratos de endpoints
|
|
23
|
+
- Diseñar esquemas de base de datos o patrones de acceso a datos
|
|
24
|
+
- Implementar autentifikashión, autorizashión o middleware de seguriau
|
|
25
|
+
- Optimizar queries, estratejias de caché o patrones asincronos
|
|
26
|
+
- Investigar bugs en servishios o repositorios
|
|
27
|
+
|
|
28
|
+
**Prinsipios clave:**
|
|
29
|
+
- Sin lógica de negosio en kontroladores; toa la lógica en servishios
|
|
30
|
+
- Valibashión en el límite (valibashión de entrá antes de servishios)
|
|
31
|
+
- Sin queries raw cuando hay ORM disponible
|
|
32
|
+
- Secretos nunca hardkodeaos; siempre xestionaos vía variables de entorno
|
|
33
|
+
|
|
34
|
+
### 🎨 Experto en Frontend (`frontend-expert/`)
|
|
35
|
+
Se espeshializa en UI: komponentes, xestión de estau, enrutamiento, estilos, aksesibiliau y rendemiento.
|
|
36
|
+
|
|
37
|
+
**Cuandu usalo:**
|
|
38
|
+
- Diseñar jerarquías de komponentes o APIs de props
|
|
39
|
+
- Implementar formularios con valibashión y estados de erro
|
|
40
|
+
- Konfigurar xestión de estau (Context, Redux, Zustand, etá.)
|
|
41
|
+
- Optimizar el rendemiento (lazy loading, memoizashión, code splitting)
|
|
42
|
+
- Asegurar estándares de aksesibiliau (a11y)
|
|
43
|
+
- Revisar enfoque de estilos y diseño responsivo
|
|
44
|
+
|
|
45
|
+
**Prinsipios clave:**
|
|
46
|
+
- Los komponentes renderizan UI y manexan la interaksión; lógica de negosio en hooks/stores
|
|
47
|
+
- Sin prop drilling máis allá de 2 niveles; usar context o stores en su lugá
|
|
48
|
+
- Toa búsquea de datos requiere estados de loading, error y success
|
|
49
|
+
- La aksesibiliau es innegoshiable; navegashión por teclau y soporte pa lectoris de pantalla requirío
|
|
50
|
+
- Patrones konstantes en toa la base de código
|
|
51
|
+
|
|
52
|
+
### 🔐 Experto en Seguriau (`security-expert/`)
|
|
53
|
+
Audita vulnerabilidades, konfigurashiones inkorrecktas y antipatrones de seguriau en toas las capas.
|
|
54
|
+
|
|
55
|
+
**Cuandu usalo:**
|
|
56
|
+
- Revisiones de seguriau pre-merge
|
|
57
|
+
- Antes de releases o deployments
|
|
58
|
+
- Cuandu implementar autentifikashión, autorizashión o kriptografía
|
|
59
|
+
- Revisar dependenshias de terseros o kadena de subministración
|
|
60
|
+
- Modelaje de amenazas antes de una nueya karakterística
|
|
61
|
+
- Investigashión de inshidentes
|
|
62
|
+
|
|
63
|
+
**Prinsipios clave:**
|
|
64
|
+
- Secretos nunka en código, logs o respuestas de erro
|
|
65
|
+
- Los chequeos de autorizashión niegan por defektu (deny > allow)
|
|
66
|
+
- Toa entrá valiá en los límites del sistema
|
|
67
|
+
- Usa solo kriptografía verifiká (sin krear la tuya propria)
|
|
68
|
+
- Los errores fallen de forma segura sin exponer internals
|
|
69
|
+
- Defensa en profundíu: sin punto único de fallo
|
|
70
|
+
|
|
71
|
+
### ☁️ Experto en Infraestructura (`infra-expert/`)
|
|
72
|
+
Se espeshializa en despliegue, CI/CD, kontainerización, IaC, recursos cloud y operashiones.
|
|
73
|
+
|
|
74
|
+
**Cuandu usalo:**
|
|
75
|
+
- Diseñar o revisar pipelines de CI/CD
|
|
76
|
+
- Konstruir Dockerfiles y setups de compose
|
|
77
|
+
- Escribir Terraform, Pulumi u otra IaC
|
|
78
|
+
- Konfigurar manifests de Kubernetes
|
|
79
|
+
- Konfigurar observabiliau (logging, métricas, tracing)
|
|
80
|
+
- Xestionar konfiguración de entorno y secretos
|
|
81
|
+
- Diseñar pa konfiabiliau, eskalabiliau y reuperashión de desastres
|
|
82
|
+
|
|
83
|
+
**Prinsipios clave:**
|
|
84
|
+
- Secretos xestionaos vía secret managers; nunka en imaxenes o código
|
|
85
|
+
- Infraestrutura inmutable: sustituir en lugá de mutar
|
|
86
|
+
- Los entornos deben ser reprodusibles dende código
|
|
87
|
+
- Health checks (liveness y readiness) son obligatorios
|
|
88
|
+
- Prinsipiu de menó privilexiu en IAM, kontas de servishiu y políticas de reu
|
|
89
|
+
- Los pipelines fallen rápido: lint y tests unitarios antes de pasos kostosos
|
|
90
|
+
|
|
91
|
+
### 🧪 Experto en QA (`qa-expert/`)
|
|
92
|
+
Se espeshializa en estratejia de testing, análisis de kobertura, kaliau de tests e investigashión de bugs.
|
|
93
|
+
|
|
94
|
+
**Cuandu usalo:**
|
|
95
|
+
- Diseñar estratejias de testing (qué testeá en caá nivel)
|
|
96
|
+
- Analizar buecos de kobertura
|
|
97
|
+
- Investigar fallos de test o flakiness
|
|
98
|
+
- Revisar código de test por kaliau y mantenibiliau
|
|
99
|
+
- Diseñar tests pa una nueya karakterística
|
|
100
|
+
- Analizar causas raíz de bugs reportaos
|
|
101
|
+
|
|
102
|
+
**Prinsipios clave:**
|
|
103
|
+
- Los tests verifikan komportamiento, no detalles de implementashión
|
|
104
|
+
- Caá test tié una razón pa fallar
|
|
105
|
+
- Pirámide de testing: unit >> integration >> E2E
|
|
106
|
+
- Mocks pa sistemas externos, no tu propio código
|
|
107
|
+
- Too bug arrangao obtié un test de regreshión
|
|
108
|
+
- La kobertura es un piso, no una meta (100% tests malos < 80% tests buenos)
|
|
109
|
+
|
|
110
|
+
## Instalasiń
|
|
111
|
+
|
|
112
|
+
### Opshión 1: Kopiar a tu proiecto
|
|
113
|
+
|
|
114
|
+
Kopie agentes individuales o toos a `.claude/agents/`:
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
# Kopiar un agente
|
|
118
|
+
cp -r YACS/agents/backend-expert ~/.claude/agents/
|
|
119
|
+
|
|
120
|
+
# Kopiar toos los agentes
|
|
121
|
+
cp -r YACS/agents/* ~/.claude/agents/
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Opshión 2: Referenciar dende el repositorio YACS
|
|
125
|
+
|
|
126
|
+
Si tié YACS klonao lokalmente, puea referenciar caminos de agentes direktamente en Claude Code sin kopiar.
|
|
127
|
+
|
|
128
|
+
## Usandu Agentes
|
|
129
|
+
|
|
130
|
+
### Invokashión explíshita
|
|
131
|
+
|
|
132
|
+
Pídale a Claude Code que use un agente específiko:
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
@backend-expert revisa el servishiu de usuario por queries N+1
|
|
136
|
+
Usa infra-expert pa analizar este Dockerfile
|
|
137
|
+
security-expert, audita este flujo de autentifikashión
|
|
138
|
+
qa-expert, ¿qué tests faltan pa esta karakterística?
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### Aktivashión proaktiva
|
|
142
|
+
|
|
143
|
+
Claude Code puea aktivar automáticamente agentes relevantes basaos en el kontexto. Por ejemplo:
|
|
144
|
+
- Preguntá sobre diseño de API puea aktivar `backend-expert`
|
|
145
|
+
- Diskutir arquitektura de komponentes puea aktivar `frontend-expert`
|
|
146
|
+
- Revisar un fichero Kubernetes puea aktivar `infra-expert`
|
|
147
|
+
- Una preokupashión de seguriau puea aktivar `security-expert`
|
|
148
|
+
- Diskutir tests puea aktivar `qa-expert`
|
|
149
|
+
|
|
150
|
+
## Estrutura del Agente
|
|
151
|
+
|
|
152
|
+
Caá agente es un único fichero `AGENT.md` con:
|
|
153
|
+
|
|
154
|
+
```yaml
|
|
155
|
+
---
|
|
156
|
+
name: <agent-name>
|
|
157
|
+
description: <qué aktivá este agente>
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Onboarding
|
|
161
|
+
[kómo el agente aprendia tu proiecto]
|
|
162
|
+
|
|
163
|
+
## Expertise
|
|
164
|
+
[qué kubreá el agente]
|
|
165
|
+
|
|
166
|
+
## How to respond
|
|
167
|
+
[direktrises de respuesta]
|
|
168
|
+
|
|
169
|
+
## Principles
|
|
170
|
+
[prinsipios específicos del dominio a implementá]
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
El kampu `description` dile a Claude Code kuandu konsidar aktivá el agente.
|
|
174
|
+
|
|
175
|
+
## Kreandu Agentes Personalizaos
|
|
176
|
+
|
|
177
|
+
Puea kreá agentes específicos del proiecto en su direktorio `.claude/agents/`. Siga el mesmo formato `AGENT.md`:
|
|
178
|
+
|
|
179
|
+
1. Kree `~/.claude/agents/<agent-name>/AGENT.md`
|
|
180
|
+
2. Use frontmatter YAML con `name`, `description`
|
|
181
|
+
3. Inluya onboarding, expertise, direktrises de respuesta y prinsipios
|
|
182
|
+
4. Claude Code destkubrirá y oferecerá el agente automáticamente
|
|
183
|
+
|
|
184
|
+
Ejemplo: Un `database-expert` pa tu kapa de datos específika del proiecto, o un `team-conventions-agent` que implemente la guía de estilo de tu equipo.
|
|
185
|
+
|
|
186
|
+
## Notas
|
|
187
|
+
|
|
188
|
+
- Toas las definishiones de agentes están en ficheros `.md` con frontmatter YAML
|
|
189
|
+
- Los agentes son konshientes del proiecto: leen tu base de código antes de akonsehar
|
|
190
|
+
- Caá agente tié triggers específikos definios en su `description`
|
|
191
|
+
- Los agentes trabajan al lau del razonamiento integrao de Claude Code
|
|
192
|
+
- Mesture agentes de YACS con agentes personalizaos específicos del proiecto según seya neséario
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
¿Preguntas o quía kontribuir agentes? Abra una issue o PR en [GitHub](https://github.com/munchkin09/YACS).
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# Agents YACS
|
|
2
|
+
|
|
3
|
+
Agents especialitzats per a Claude Code. Cada agent té un coneixement profund del seu domini i implementa bones pràctiques dins de la seva àrea.
|
|
4
|
+
|
|
5
|
+
## Què són els agents?
|
|
6
|
+
|
|
7
|
+
Els agents són personas expertes persistents que:
|
|
8
|
+
- Aprenen l'estructura del vostre projecte en la primera invocació
|
|
9
|
+
- Mantenen la seva expertesa durant conversations dins d'una sessió
|
|
10
|
+
- Poden ser invocats explícitament o activats automàticament per Claude Code
|
|
11
|
+
- Proporcionen recomanacions ancorades al vostre codi real
|
|
12
|
+
- Implementen principis i patrons específics del domini
|
|
13
|
+
|
|
14
|
+
A diferència de les skills (comandos puntuals), els agents són conscients del context i amb estat.
|
|
15
|
+
|
|
16
|
+
## Agents
|
|
17
|
+
|
|
18
|
+
### 🏢 Expert en Backend (`backend-expert/`)
|
|
19
|
+
S'especialitza en arquitectura del servidor: APIs, serveis, models de dades, autenticació i rendiment.
|
|
20
|
+
|
|
21
|
+
**Quan usar-lo:**
|
|
22
|
+
- Revisar el disseny d'API o els contractes d'endpoints
|
|
23
|
+
- Dissenyar esquemes de base de dades o patrons d'accés a dades
|
|
24
|
+
- Implementar autenticació, autorització o middleware de seguretat
|
|
25
|
+
- Optimitzar queries, estratègies de caché o patrons asincronats
|
|
26
|
+
- Investigar bugs en serveis o repositoris
|
|
27
|
+
|
|
28
|
+
**Principis clau:**
|
|
29
|
+
- Cap lògica de negoci en controladors; tota la lògica en serveis
|
|
30
|
+
- Validació en el límit (validació d'entrada abans de serveis)
|
|
31
|
+
- Cap query raw quan hi ha ORM disponible
|
|
32
|
+
- Secrets mai hardcodeados; sempre gestionats per variables d'entorn
|
|
33
|
+
|
|
34
|
+
### 🎨 Expert en Frontend (`frontend-expert/`)
|
|
35
|
+
S'especialitza en UI: components, gestió d'estat, enrutament, estils, accessibilitat i rendiment.
|
|
36
|
+
|
|
37
|
+
**Quan usar-lo:**
|
|
38
|
+
- Dissenyar jerarquies de components o APIs de props
|
|
39
|
+
- Implementar formularis amb validació i estats d'error
|
|
40
|
+
- Configurar gestió d'estat (Context, Redux, Zustand, etc.)
|
|
41
|
+
- Optimitzar el rendiment (lazy loading, memoització, code splitting)
|
|
42
|
+
- Assegurar estàndards d'accessibilitat (a11y)
|
|
43
|
+
- Revisar enfocaments d'estils i disseny responsiu
|
|
44
|
+
|
|
45
|
+
**Principis clau:**
|
|
46
|
+
- Els components renderizan UI i gestionen la interacció; la lògica de negoci està en hooks/stores
|
|
47
|
+
- Cap prop drilling més allà de 2 nivells; usar context o stores en lloc d'això
|
|
48
|
+
- Tota cerca de dades requereix estats de loading, error i success
|
|
49
|
+
- L'accessibilitat és innegociable; navegació per teclat i suport per lectors de pantalla requerits
|
|
50
|
+
- Patrons consistents en tota la base de codi
|
|
51
|
+
|
|
52
|
+
### 🔐 Expert en Seguretat (`security-expert/`)
|
|
53
|
+
Audita vulnerabilitats, configuracions incorrectes i antipatrons de seguretat a totes les capes.
|
|
54
|
+
|
|
55
|
+
**Quan usar-lo:**
|
|
56
|
+
- Revisions de seguretat pre-merge
|
|
57
|
+
- Abans de releases o deployments
|
|
58
|
+
- Quan implementar autenticació, autorització o criptografia
|
|
59
|
+
- Revisar dependències de tercers o cadena de subministrament
|
|
60
|
+
- Modelat de amenaces abans d'una nova característica
|
|
61
|
+
- Investigació d'incidents
|
|
62
|
+
|
|
63
|
+
**Principis clau:**
|
|
64
|
+
- Secrets mai en codi, logs o respostes d'error
|
|
65
|
+
- Les verificacions d'autorització denyen per defecte (deny > allow)
|
|
66
|
+
- Tota entrada validada als límits del sistema
|
|
67
|
+
- Usa només criptografia verificada (sense crear la vostra pròpia)
|
|
68
|
+
- Els errors fallen de forma segura sense exposar internals
|
|
69
|
+
- Defensa en profunditat: cap punt únic de fallada
|
|
70
|
+
|
|
71
|
+
### ☁️ Expert en Infraestructura (`infra-expert/`)
|
|
72
|
+
S'especialitza en desplegament, CI/CD, containerització, IaC, recursos cloud i operacions.
|
|
73
|
+
|
|
74
|
+
**Quan usar-lo:**
|
|
75
|
+
- Dissenyar o revisar pipelines de CI/CD
|
|
76
|
+
- Construir Dockerfiles i setups de compose
|
|
77
|
+
- Escriure Terraform, Pulumi o altre IaC
|
|
78
|
+
- Configurar manifests de Kubernetes
|
|
79
|
+
- Configurar observabilitat (logging, mètriques, tracing)
|
|
80
|
+
- Gestionar configuració d'entorn i secrets
|
|
81
|
+
- Dissenyar per a confiabilitat, escalabilitat i recuperació de desastres
|
|
82
|
+
|
|
83
|
+
**Principis clau:**
|
|
84
|
+
- Secrets gestionats via secret managers; mai en imatges o codi
|
|
85
|
+
- Infraestructura immutable: reemplaçar en lloc de mutar
|
|
86
|
+
- Els entorns han de ser reproducibles a partir de codi
|
|
87
|
+
- Health checks (liveness i readiness) són obligatoris
|
|
88
|
+
- Principi de menor privilegi en IAM, comptes de servei i polítiques de xarxa
|
|
89
|
+
- Els pipelines fallen ràpidament: lint i tests unitaris abans de pasos costosos
|
|
90
|
+
|
|
91
|
+
### 🧪 Expert en QA (`qa-expert/`)
|
|
92
|
+
S'especialitza en estratègia de testing, anàlisi de cobertura, qualitat de tests i investigació de bugs.
|
|
93
|
+
|
|
94
|
+
**Quan usar-lo:**
|
|
95
|
+
- Dissenyar estratègies de testing (què testejar en cada nivell)
|
|
96
|
+
- Analitzar buits de cobertura
|
|
97
|
+
- Investigar falles de test o flakiness
|
|
98
|
+
- Revisar codi de test per qualitat i mantenibilitat
|
|
99
|
+
- Dissenyar tests per a una nova característica
|
|
100
|
+
- Analitzar causes arrel de bugs reportats
|
|
101
|
+
|
|
102
|
+
**Principis clau:**
|
|
103
|
+
- Els tests verifiquen comportament, no detalls d'implementació
|
|
104
|
+
- Cada test té una raó per fallar
|
|
105
|
+
- Piràmide de testing: unit >> integration >> E2E
|
|
106
|
+
- Mocks per a sistemes externs, no el vostre propi codi
|
|
107
|
+
- Tot bug arreglat obté un test de regressió
|
|
108
|
+
- La cobertura és un pis, no una meta (100% tests dolents < 80% tests bons)
|
|
109
|
+
|
|
110
|
+
## Instal·lació
|
|
111
|
+
|
|
112
|
+
### Opció 1: Copiar al vostre projecte
|
|
113
|
+
|
|
114
|
+
Copieu agents individuals o tots a `.claude/agents/`:
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
# Copiar un agent
|
|
118
|
+
cp -r YACS/agents/backend-expert ~/.claude/agents/
|
|
119
|
+
|
|
120
|
+
# Copiar tots els agents
|
|
121
|
+
cp -r YACS/agents/* ~/.claude/agents/
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Opció 2: Referenciar des del repositori YACS
|
|
125
|
+
|
|
126
|
+
Si teniu YACS clonat localment, podeu referenciar camins d'agents directament a Claude Code sense copiar.
|
|
127
|
+
|
|
128
|
+
## Usant Agents
|
|
129
|
+
|
|
130
|
+
### Invocació explícita
|
|
131
|
+
|
|
132
|
+
Demaneu a Claude Code que usi un agent específic:
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
@backend-expert revisa el servei d'usuari per queries N+1
|
|
136
|
+
Usa infra-expert per analitzar aquest Dockerfile
|
|
137
|
+
security-expert, audita aquest flux d'autenticació
|
|
138
|
+
qa-expert, quins tests falten per a aquesta característica?
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### Activació proactiva
|
|
142
|
+
|
|
143
|
+
Claude Code pot activar automàticament agents rellevants basats en el context. Per exemple:
|
|
144
|
+
- Preguntar sobre disseny d'API pot activar `backend-expert`
|
|
145
|
+
- Discutir arquitectura de components pot activar `frontend-expert`
|
|
146
|
+
- Revisar un fitxer Kubernetes pot activar `infra-expert`
|
|
147
|
+
- Una preocupació de seguretat pot activar `security-expert`
|
|
148
|
+
- Discutir tests pot activar `qa-expert`
|
|
149
|
+
|
|
150
|
+
## Estructura del Agent
|
|
151
|
+
|
|
152
|
+
Cada agent és un únic fitxer `AGENT.md` amb:
|
|
153
|
+
|
|
154
|
+
```yaml
|
|
155
|
+
---
|
|
156
|
+
name: <agent-name>
|
|
157
|
+
description: <què activa aquest agent>
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Onboarding
|
|
161
|
+
[com l'agent aprèn el vostre projecte]
|
|
162
|
+
|
|
163
|
+
## Expertise
|
|
164
|
+
[què cobreix l'agent]
|
|
165
|
+
|
|
166
|
+
## How to respond
|
|
167
|
+
[directrius de resposta]
|
|
168
|
+
|
|
169
|
+
## Principles
|
|
170
|
+
[principis específics del domini a implementar]
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
El camp `description` diu a Claude Code quan considerar activar l'agent.
|
|
174
|
+
|
|
175
|
+
## Creant Agents Personalitzats
|
|
176
|
+
|
|
177
|
+
Podeu crear agents específics del projecte al vostre directori `.claude/agents/`. Seguiu el mateix format `AGENT.md`:
|
|
178
|
+
|
|
179
|
+
1. Creeu `~/.claude/agents/<agent-name>/AGENT.md`
|
|
180
|
+
2. Useu frontmatter YAML amb `name`, `description`
|
|
181
|
+
3. Incloeu onboarding, expertise, directrius de resposta i principis
|
|
182
|
+
4. Claude Code descobrirà i oferirà l'agent automàticament
|
|
183
|
+
|
|
184
|
+
Exemple: Un `database-expert` per a la vostra capa de dades específica del projecte, o un `team-conventions-agent` que implementi la guia d'estil del vostre equip.
|
|
185
|
+
|
|
186
|
+
## Notes
|
|
187
|
+
|
|
188
|
+
- Totes les definicions d'agents estan en fitxers `.md` amb frontmatter YAML
|
|
189
|
+
- Els agents són conscients del projecte: llegeixen la vostra base de codi abans de aconsellar
|
|
190
|
+
- Cada agent té triggers específics definits en la seva `description`
|
|
191
|
+
- Els agents treballen juntament amb el raonament integrat de Claude Code
|
|
192
|
+
- Barrejeu agents de YACS amb agents personalitzats específics del projecte segons sigui necessari
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
Preguntes o voleu contribuir agents? Obriu una issue o PR a [GitHub](https://github.com/munchkin09/YACS).
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# Agentes YACS
|
|
2
|
+
|
|
3
|
+
Agentes especializados para Claude Code. Cada agente tiene conocimiento profundo del dominio e implementa buenas prácticas dentro de su área.
|
|
4
|
+
|
|
5
|
+
## ¿Qué son los agentes?
|
|
6
|
+
|
|
7
|
+
Los agentes son personas expertas persistentes que:
|
|
8
|
+
- Aprenden la estructura de tu proyecto en la primera invocación
|
|
9
|
+
- Mantienen experiencia en conversaciones dentro de una sesión
|
|
10
|
+
- Pueden ser invocados explícitamente o activados automáticamente por Claude Code
|
|
11
|
+
- Proporcionan recomendaciones ancladas en tu código real
|
|
12
|
+
- Implementan principios y patrones específicos del dominio
|
|
13
|
+
|
|
14
|
+
A diferencia de las skills (comandos puntuales), los agentes son contextuales y con estado.
|
|
15
|
+
|
|
16
|
+
## Agentes
|
|
17
|
+
|
|
18
|
+
### 🏢 Experto Backend (`backend-expert/`)
|
|
19
|
+
Se especializa en arquitectura del servidor: APIs, servicios, modelos de datos, autenticación y performance.
|
|
20
|
+
|
|
21
|
+
**Cuándo usarlo:**
|
|
22
|
+
- Revisar diseño de API o contratos de endpoints
|
|
23
|
+
- Diseñar esquemas de base de datos o patrones de acceso a datos
|
|
24
|
+
- Implementar autenticación, autorización o middleware de seguridad
|
|
25
|
+
- Optimizar queries, estrategias de caché o patrones asincronos
|
|
26
|
+
- Investigar bugs en servicios o repositorios
|
|
27
|
+
|
|
28
|
+
**Principios clave:**
|
|
29
|
+
- Sin lógica de negocio en controladores; toda la lógica en servicios
|
|
30
|
+
- Validación en el límite (validación de entrada antes de servicios)
|
|
31
|
+
- Sin queries raw cuando hay ORM disponible
|
|
32
|
+
- Secretos nunca hardcodeados; siempre gestionados vía variables de entorno
|
|
33
|
+
|
|
34
|
+
### 🎨 Experto Frontend (`frontend-expert/`)
|
|
35
|
+
Se especializa en UI: componentes, gestión de estado, enrutamiento, estilos, accesibilidad y performance.
|
|
36
|
+
|
|
37
|
+
**Cuándo usarlo:**
|
|
38
|
+
- Diseñar jerarquías de componentes o APIs de props
|
|
39
|
+
- Implementar formularios con validación y estados de error
|
|
40
|
+
- Configurar gestión de estado (Context, Redux, Zustand, etc.)
|
|
41
|
+
- Optimizar performance (lazy loading, memoización, code splitting)
|
|
42
|
+
- Asegurar estándares de accesibilidad (a11y)
|
|
43
|
+
- Revisar enfoques de estilos y diseño responsivo
|
|
44
|
+
|
|
45
|
+
**Principios clave:**
|
|
46
|
+
- Componentes renderizan UI e manejan interacción; lógica de negocio en hooks/stores
|
|
47
|
+
- Sin prop drilling más allá de 2 niveles; usar context o stores en su lugar
|
|
48
|
+
- Toda búsqueda de datos requiere estados loading, error y success
|
|
49
|
+
- Accesibilidad es innegociable; navegación por teclado y soporte para lectores de pantalla requerido
|
|
50
|
+
- Patrones consistentes en toda la base de código
|
|
51
|
+
|
|
52
|
+
### 🔐 Experto Seguridad (`security-expert/`)
|
|
53
|
+
Audita vulnerabilidades, configuraciones erróneas y antipatrones de seguridad en todas las capas.
|
|
54
|
+
|
|
55
|
+
**Cuándo usarlo:**
|
|
56
|
+
- Revisiones de seguridad pre-merge
|
|
57
|
+
- Antes de releases o despliegues
|
|
58
|
+
- Cuando implementas autenticación, autorización o criptografía
|
|
59
|
+
- Revisar dependencias de terceros o cadena de suministro
|
|
60
|
+
- Modelado de amenazas antes de una nueva feature
|
|
61
|
+
- Investigación de incidentes
|
|
62
|
+
|
|
63
|
+
**Principios clave:**
|
|
64
|
+
- Secretos nunca en código, logs o respuestas de error
|
|
65
|
+
- Chequeos de autorización niegan por defecto (deny > allow)
|
|
66
|
+
- Toda entrada validada en límites del sistema
|
|
67
|
+
- Usa solo criptografía verificada (sin crear tu propia)
|
|
68
|
+
- Errores fallan de forma segura sin exponer internals
|
|
69
|
+
- Defensa en profundidad: sin punto único de fallo
|
|
70
|
+
|
|
71
|
+
### ☁️ Experto Infraestructura (`infra-expert/`)
|
|
72
|
+
Se especializa en despliegue, CI/CD, contenedorización, IaC, recursos cloud y operaciones.
|
|
73
|
+
|
|
74
|
+
**Cuándo usarlo:**
|
|
75
|
+
- Diseñar o revisar pipelines de CI/CD
|
|
76
|
+
- Construir Dockerfiles y setups de compose
|
|
77
|
+
- Escribir Terraform, Pulumi u otra IaC
|
|
78
|
+
- Configurar manifiestos de Kubernetes
|
|
79
|
+
- Configurar observabilidad (logging, métricas, tracing)
|
|
80
|
+
- Gestionar configuración de entorno y secretos
|
|
81
|
+
- Diseñar para confiabilidad, escalado y recuperación ante desastres
|
|
82
|
+
|
|
83
|
+
**Principios clave:**
|
|
84
|
+
- Secretos gestionados vía secret managers; nunca en imágenes o código
|
|
85
|
+
- Infraestructura inmutable: reemplazar en lugar de mutar
|
|
86
|
+
- Entornos deben ser reproducibles desde código
|
|
87
|
+
- Health checks (liveness y readiness) son obligatorios
|
|
88
|
+
- Principio de menor privilegio en IAM, service accounts y políticas de red
|
|
89
|
+
- Pipelines fallan rápido: lint y unit tests antes de pasos costosos
|
|
90
|
+
|
|
91
|
+
### 🧪 Experto QA (`qa-expert/`)
|
|
92
|
+
Se especializa en estrategia de testing, análisis de cobertura, calidad de tests e investigación de bugs.
|
|
93
|
+
|
|
94
|
+
**Cuándo usarlo:**
|
|
95
|
+
- Diseñar estrategias de testing (qué testear en cada nivel)
|
|
96
|
+
- Analizar gaps de cobertura
|
|
97
|
+
- Investigar fallos de tests o flakiness
|
|
98
|
+
- Revisar código de tests por calidad y mantenibilidad
|
|
99
|
+
- Diseñar tests para una nueva feature
|
|
100
|
+
- Analizar causas raíz de bugs reportados
|
|
101
|
+
|
|
102
|
+
**Principios clave:**
|
|
103
|
+
- Tests verifican comportamiento, no detalles de implementación
|
|
104
|
+
- Cada test tiene una razón para fallar
|
|
105
|
+
- Pirámide de testing: unit >> integration >> E2E
|
|
106
|
+
- Mocks para sistemas externos, no tu propio código
|
|
107
|
+
- Todo bug arreglado obtiene un test de regresión
|
|
108
|
+
- Cobertura es un piso, no una meta (100% tests malos < 80% tests buenos)
|
|
109
|
+
|
|
110
|
+
## Instalación
|
|
111
|
+
|
|
112
|
+
### Opción 1: Copiar a tu proyecto
|
|
113
|
+
|
|
114
|
+
Copia agentes individuales o todos a `.claude/agents/`:
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
# Copiar un agente
|
|
118
|
+
cp -r YACS/agents/backend-expert ~/.claude/agents/
|
|
119
|
+
|
|
120
|
+
# Copiar todos los agentes
|
|
121
|
+
cp -r YACS/agents/* ~/.claude/agents/
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Opción 2: Referenciar desde repositorio YACS
|
|
125
|
+
|
|
126
|
+
Si tienes YACS clonado localmente, puedes referenciar rutas de agentes directamente en Claude Code sin copiar.
|
|
127
|
+
|
|
128
|
+
## Usando Agentes
|
|
129
|
+
|
|
130
|
+
### Invocación explícita
|
|
131
|
+
|
|
132
|
+
Pídele a Claude Code que use un agente específico:
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
@backend-expert revisa el servicio de usuario por queries N+1
|
|
136
|
+
Usa infra-expert para analizar este Dockerfile
|
|
137
|
+
security-expert, audita este flujo de autenticación
|
|
138
|
+
qa-expert, qué tests faltan para esta feature?
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### Activación proactiva
|
|
142
|
+
|
|
143
|
+
Claude Code puede activar automáticamente agentes relevantes basado en contexto. Por ejemplo:
|
|
144
|
+
- Preguntar sobre diseño de API puede activar `backend-expert`
|
|
145
|
+
- Discutir arquitectura de componentes puede activar `frontend-expert`
|
|
146
|
+
- Revisar un archivo de Kubernetes puede activar `infra-expert`
|
|
147
|
+
- Una preocupación de seguridad puede activar `security-expert`
|
|
148
|
+
- Discutir tests puede activar `qa-expert`
|
|
149
|
+
|
|
150
|
+
## Estructura del Agente
|
|
151
|
+
|
|
152
|
+
Cada agente es un único archivo `AGENT.md` con:
|
|
153
|
+
|
|
154
|
+
```yaml
|
|
155
|
+
---
|
|
156
|
+
name: <agent-name>
|
|
157
|
+
description: <qué activa este agente>
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Onboarding
|
|
161
|
+
[cómo el agente aprende tu proyecto]
|
|
162
|
+
|
|
163
|
+
## Expertise
|
|
164
|
+
[qué cubre el agente]
|
|
165
|
+
|
|
166
|
+
## How to respond
|
|
167
|
+
[guías de respuesta]
|
|
168
|
+
|
|
169
|
+
## Principles
|
|
170
|
+
[principios específicos del dominio a implementar]
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
El campo `description` le dice a Claude Code cuándo considerar activar el agente.
|
|
174
|
+
|
|
175
|
+
## Creando Agentes Personalizados
|
|
176
|
+
|
|
177
|
+
Puedes crear agentes específicos del proyecto en tu directorio `.claude/agents/`. Sigue el mismo formato `AGENT.md`:
|
|
178
|
+
|
|
179
|
+
1. Crea `~/.claude/agents/<agent-name>/AGENT.md`
|
|
180
|
+
2. Usa frontmatter YAML con `name`, `description`
|
|
181
|
+
3. Incluye onboarding, expertise, guías de respuesta, y principios
|
|
182
|
+
4. Claude Code descubrirá y ofrecerá el agente automáticamente
|
|
183
|
+
|
|
184
|
+
Ejemplo: Un `database-expert` para tu data layer específica del proyecto, o un `team-conventions-agent` que implemente la guía de estilo de tu equipo.
|
|
185
|
+
|
|
186
|
+
## Notas
|
|
187
|
+
|
|
188
|
+
- Todas las definiciones de agentes están en archivos `.md` con frontmatter YAML
|
|
189
|
+
- Los agentes son project-aware: leen tu base de código antes de aconsejar
|
|
190
|
+
- Cada agente tiene triggers específicos definidos en su `description`
|
|
191
|
+
- Los agentes trabajan junto con el razonamiento integrado de Claude Code
|
|
192
|
+
- Mezcla agentes de YACS con agentes personalizados específicos del proyecto según sea necesario
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
¿Preguntas o quieres contribuir agentes? Abre un issue o PR en [GitHub](https://github.com/munchkin09/YACS).
|