@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.
@@ -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).