guild-agents 0.2.6 → 0.2.8

package/src/templates/skills/qa-cycle/SKILL.md

@@ -1,70 +1,70 @@
 ---
 name: qa-cycle
-description: "Ciclo QA + bugfix hasta que pase"
+description: "QA + bugfix cycle until it passes"
 user-invocable: true
 ---
 
 # QA Cycle
 
-Ejecuta un ciclo de validacion QA seguido de bugfix hasta que todos los criterios pasen limpio. Util para validar implementaciones sin el pipeline completo de build-feature.
+Runs a QA validation cycle followed by bugfix until all criteria pass clean. Useful for validating implementations without the full build-feature pipeline.
 
-## Cuando usarlo
+## When to use
 
-- Despues de implementar cambios que necesitan validacion
-- Para verificar que una correccion de bug no introdujo regresiones
-- Como ciclo final antes de crear un PR
+- After implementing changes that need validation
+- To verify that a bug fix did not introduce regressions
+- As a final cycle before creating a PR
 
-## Uso
+## Usage
 
 `/qa-cycle`
 
-## Proceso
+## Process
 
-### Paso 1 — Verificacion automatizada (obligatorio)
+### Step 1 — Automated verification (mandatory)
 
-Antes de invocar al agente QA, ejecutar los comandos de verificacion del proyecto. Los comandos concretos estan en la seccion "Comandos CLI" de CLAUDE.md:
+Before invoking the QA agent, run the project verification commands. The specific commands are in the "CLI commands" section of CLAUDE.md:
 
-1. Ejecuta tests del proyecto (ej: `npm test`) — registra resultado y output
-2. Ejecuta lint del proyecto (ej: `npm run lint`) — registra resultado y output
-3. Si alguno falla, esto se convierte en input para el reporte QA como bug automatico de tipo Blocker
+1. Run project tests (e.g., `npm test`) — record result and output
+2. Run project lint (e.g., `npm run lint`) — record result and output
+3. If any fail, this becomes input for the QA report as an automatic Blocker bug
 
-### Paso 2 — Validacion QA
+### Step 2 — QA Validation
 
-Invoca el agente QA usando Task tool:
+Invoke the QA agent using Task tool:
 
-1. Lee `.claude/agents/qa.md` para asumir el rol de QA
-2. Lee CLAUDE.md y SESSION.md para contexto
-3. Recibe los resultados de tests y lint del Paso 1
-4. Si tests o lint fallaron, incluirlos como bugs Blocker en el reporte
-5. Revisa los criterios de aceptacion de la tarea en curso (si existen en SESSION.md)
-6. Valida edge cases y escenarios de error
-7. Reporta resultados
+1. Read `.claude/agents/qa.md` to assume the QA role
+2. Read CLAUDE.md and SESSION.md for context
+3. Receive the test and lint results from Step 1
+4. If tests or lint failed, include them as Blocker bugs in the report
+5. Review the acceptance criteria for the current task (if they exist in SESSION.md)
+6. Validate edge cases and error scenarios
+7. Report results
 
-### Paso 3 — Bugfix (si hay bugs)
+### Step 3 — Bugfix (if there are bugs)
 
-Si QA reporta bugs (incluyendo fallos de tests/lint), invoca el agente Bugfix usando Task tool:
+If QA reports bugs (including test/lint failures), invoke the Bugfix agent using Task tool:
 
-1. Lee `.claude/agents/bugfix.md` para asumir el rol de Bugfix
-2. Recibe el reporte de bugs de QA como input
-3. Diagnostica la causa raiz de cada bug
-4. Implementa la correccion minima
-5. Verifica que el fix resuelve el problema
-6. Ejecuta tests y lint para confirmar que no introdujo regresiones
+1. Read `.claude/agents/bugfix.md` to assume the Bugfix role
+2. Receive the QA bug report as input
+3. Diagnose the root cause of each bug
+4. Implement the minimal fix
+5. Verify that the fix resolves the issue
+6. Run tests and lint to confirm no regressions were introduced
 
-### Paso 4 — Re-validacion
+### Step 4 — Re-validation
 
-Vuelve al Paso 1 (verificacion automatizada) para re-validar despues del bugfix.
-Maximo 3 ciclos de verificacion-QA-bugfix para evitar loops infinitos.
+Return to Step 1 (automated verification) to re-validate after the bugfix.
+Maximum 3 verification-QA-bugfix cycles to prevent infinite loops.
 
-### Paso 5 — Resultado final
+### Step 5 — Final result
 
-Presenta el resultado:
+Present the result:
 
-- **Aprobado**: Todos los criterios pasan, no hay bugs pendientes
-- **Con advertencias**: Pasa pero hay warnings menores
-- **Rechazado**: Hay bugs criticos que no se pudieron resolver — escalar al Tech Lead
+- **Approved**: All criteria pass, no pending bugs
+- **With warnings**: Passes but there are minor warnings
+- **Rejected**: There are critical bugs that could not be resolved — escalate to the Tech Lead
 
-Actualiza SESSION.md con el resultado del ciclo QA.
+Update SESSION.md with the QA cycle result.
 
 ## Example Session
 

package/src/templates/skills/review/SKILL.md

@@ -1,64 +1,64 @@
 ---
 name: review
-description: "Code review standalone sobre el diff actual"
+description: "Standalone code review on the current diff"
 user-invocable: true
 ---
 
 # Review
 
-Ejecuta un code review independiente sobre los cambios actuales del proyecto. Invoca al agente Code Reviewer para analizar calidad, patrones, seguridad y deuda tecnica.
+Runs an independent code review on the current project changes. Invokes the Code Reviewer agent to analyze quality, patterns, security, and technical debt.
 
-## Cuando usarlo
+## When to use
 
-- Antes de crear un PR
-- Para revisar cambios propios antes de pedir review a otros
-- Cuando quieres una segunda opinion sobre el codigo que escribiste
+- Before creating a PR
+- To review your own changes before requesting review from others
+- When you want a second opinion on the code you wrote
 
-## Uso
+## Usage
 
 `/review`
 
-## Proceso
+## Process
 
-### Paso 1 — Obtener diff y estado de verificacion
+### Step 1 — Get diff and verification state
 
-Obtiene los cambios actuales:
+Get the current changes:
 
-1. Primero intenta `git diff --staged` (cambios en staging)
-2. Si no hay cambios en staging, usa `git diff` (cambios sin stage)
-3. Si no hay ningun cambio, informa que no hay nada que revisar
+1. First try `git diff --staged` (staged changes)
+2. If there are no staged changes, use `git diff` (unstaged changes)
+3. If there are no changes at all, report that there is nothing to review
 
-Ejecuta verificacion automatizada para dar contexto al reviewer:
+Run automated verification to give context to the reviewer:
 
-1. Ejecuta tests del proyecto (ej: `npm test`) — captura resultado
-2. Ejecuta lint del proyecto (ej: `npm run lint`) — captura resultado
-3. Incluye ambos resultados como contexto para el Code Reviewer
+1. Run project tests (e.g., `npm test`) — capture result
+2. Run project lint (e.g., `npm run lint`) — capture result
+3. Include both results as context for the Code Reviewer
 
-Nota: El Code Reviewer no tiene acceso a Bash (solo Read, Glob, Grep), por eso los tests y lint se ejecutan aqui antes de invocar al reviewer.
+Note: The Code Reviewer does not have access to Bash (only Read, Glob, Grep), so tests and lint are run here before invoking the reviewer.
 
-### Paso 2 — Invocar Code Reviewer
+### Step 2 — Invoke Code Reviewer
 
-Invoca al agente Code Reviewer usando Task tool:
+Invoke the Code Reviewer agent using Task tool:
 
-1. Lee `.claude/agents/code-reviewer.md` para asumir el rol
-2. Lee CLAUDE.md para entender las convenciones del proyecto
-3. Recibe el diff completo + resultados de tests y lint del Paso 1
-4. Si tests o lint fallaron, esto es automaticamente un hallazgo Blocker
-5. Revisa el diff completo
-6. Clasifica cada hallazgo por severidad:
-   - **Blocker**: Debe corregirse antes de merge
-   - **Warning**: Deberia corregirse, introduce deuda tecnica
-   - **Suggestion**: Mejora opcional
+1. Read `.claude/agents/code-reviewer.md` to assume the role
+2. Read CLAUDE.md to understand the project conventions
+3. Receive the full diff + test and lint results from Step 1
+4. If tests or lint failed, this is automatically a Blocker finding
+5. Review the full diff
+6. Classify each finding by severity:
+   - **Blocker**: Must be fixed before merge
+   - **Warning**: Should be fixed, introduces technical debt
+   - **Suggestion**: Optional improvement
 
-### Paso 3 — Presentar hallazgos
+### Step 3 — Present findings
 
-Presenta el reporte organizado por severidad:
+Present the report organized by severity:
 
-- Cantidad total de hallazgos por tipo
-- Detalle de cada hallazgo: archivo, descripcion, sugerencia de correccion
-- Veredicto final: Aprobado / Aprobado con warnings / Bloqueado
+- Total count of findings by type
+- Detail of each finding: file, description, suggested fix
+- Final verdict: Approved / Approved with warnings / Blocked
 
-Si hay blockers, sugiere corregirlos y ejecutar `/review` de nuevo.
+If there are blockers, suggest fixing them and running `/review` again.
 
 ## Example Session
 

package/src/templates/skills/session-end/SKILL.md

@@ -1,55 +1,55 @@
 ---
 name: session-end
-description: "Guarda estado actual en SESSION.md"
+description: "Saves current state to SESSION.md"
 user-invocable: true
 ---
 
 # Session End
 
-Guarda el estado actual del trabajo en SESSION.md para poder retomarlo en la siguiente sesion. Ejecuta este skill antes de cerrar la sesion de trabajo.
+Saves the current work state to SESSION.md so it can be resumed in the next session. Run this skill before closing your work session.
 
-## Cuando usarlo
+## When to use
 
-- Antes de cerrar la sesion de trabajo
-- Cuando necesitas pausar y quieres guardar el contexto
+- Before closing the work session
+- When you need to pause and want to save the context
 
-## Uso
+## Usage
 
 `/session-end`
 
-## Proceso
+## Process
 
-### Paso 1 — Recopilar estado actual
+### Step 1 — Gather current state
 
-Analiza el estado actual del trabajo:
+Analyze the current work state:
 
-- Que tarea estaba en curso
-- En que fase del pipeline se encuentra (si aplica)
-- Que archivos se modificaron (via `git status`)
-- Que commits se hicieron en esta sesion
+- What task was in progress
+- Which pipeline phase it is in (if applicable)
+- What files were modified (via `git status`)
+- What commits were made in this session
 
-### Paso 2 — Actualizar SESSION.md
+### Step 2 — Update SESSION.md
 
-Actualiza SESSION.md con la siguiente informacion:
+Update SESSION.md with the following information:
 
-- **Fecha:** fecha actual
-- **Tarea en curso:** nombre de la tarea o "ninguna"
-- **GitHub Issue:** URL del issue asociado (si existe)
-- **Agente activo:** ultimo agente utilizado o "ninguno"
-- **Estado:** descripcion concreta de donde quedo el trabajo
+- **Date:** current date
+- **Task in progress:** task name or "none"
+- **GitHub Issue:** associated issue URL (if it exists)
+- **Active agent:** last agent used or "none"
+- **State:** concrete description of where the work left off
 
-**Contexto relevante:**
+**Relevant context:**
 
-- Decisiones tomadas en esta sesion
-- Problemas encontrados y como se resolvieron
-- Informacion importante para retomar
+- Decisions made in this session
+- Problems encountered and how they were resolved
+- Important information for resuming
 
-**Proximos pasos:**
+**Next steps:**
 
-- Las 2-3 acciones concretas mas importantes al retomar
-- Skill sugerido para continuar (ej: "ejecutar /build-feature para continuar desde Fase 4")
+- The 2-3 most important concrete actions when resuming
+- Suggested skill to continue (e.g., "run /build-feature to continue from Phase 4")
 
-### Paso 3 — Commit WIP if uncommitted work exists
+### Step 3 — Commit WIP if uncommitted work exists
 
 If there are uncommitted changes, create a checkpoint commit:
 
@@ -74,11 +74,11 @@ WIP committed: wip: session paused — user-preferences phase 4
 SESSION.md updated. Safe to close.
 ```
 
-### Paso 4 — Confirmar
+### Step 4 — Confirm
 
-Confirma al usuario:
+Confirm to the user:
 
-- SESSION.md actualizado con el estado actual
+- SESSION.md updated with the current state
 - WIP committed (if applicable)
-- Proximos pasos registrados
-- Puedes cerrar la sesion con seguridad
+- Next steps recorded
+- You can safely close the session

package/src/templates/skills/session-start/SKILL.md

@@ -1,33 +1,33 @@
 ---
 name: session-start
-description: "Carga contexto y retoma trabajo desde SESSION.md"
+description: "Loads context and resumes work from SESSION.md"
 user-invocable: true
 ---
 
 # Session Start
 
-Carga el contexto del proyecto y retoma el trabajo desde donde se dejo en la sesion anterior. Este es el primer skill que debes ejecutar al iniciar una sesion de trabajo.
+Loads the project context and resumes work from where it was left off in the previous session. This is the first skill you should run when starting a work session.
 
-## Cuando usarlo
+## When to use
 
-- Al inicio de cada sesion de trabajo con el proyecto
-- Cuando quieres retomar el contexto despues de una pausa
+- At the start of each work session with the project
+- When you want to resume context after a pause
 
-## Uso
+## Usage
 
 `/session-start`
 
-## Proceso
+## Process
 
-### Paso 1 — Cargar contexto
+### Step 1 — Load context
 
-Lee los archivos de estado de Guild:
+Read the Guild state files:
 
-- `CLAUDE.md` — instrucciones, convenciones y reglas del proyecto
-- `SESSION.md` — estado de la ultima sesion, tarea en curso, proximos pasos
-- `PROJECT.md` — identidad del proyecto, stack, agentes configurados
+- `CLAUDE.md` — project instructions, conventions, and rules
+- `SESSION.md` — last session state, task in progress, next steps
+- `PROJECT.md` — project identity, stack, configured agents
 
-### Paso 2 — Detect resumable work
+### Step 2 — Detect resumable work
 
 Check for `wip:` checkpoint commits on active branches:
 
@@ -39,35 +39,35 @@ done
 
 If `wip:` commits are found, present them to the user with the phase they were in when interrupted.
 
-### Paso 3 — Presentar estado
+### Step 3 — Present state
 
-Muestra un resumen de la sesion anterior:
+Show a summary of the previous session:
 
-- Fecha de la ultima sesion
-- Tarea en curso (si existe)
-- Estado en que quedo el trabajo
-- Decisiones tomadas previamente
-- Proximos pasos registrados
+- Date of the last session
+- Task in progress (if any)
+- State where the work left off
+- Decisions made previously
+- Recorded next steps
 - **Resumable pipelines** (if wip: commits detected)
 
-### Paso 4 — Sugerir como continuar
+### Step 4 — Suggest how to continue
 
-Si hay tarea en curso:
+If there is a task in progress:
 
-- Muestra el estado de la tarea
-- Sugiere continuar con el skill apropiado (ej: `/build-feature` si esta en implementacion)
-- Muestra los proximos pasos registrados en SESSION.md
+- Show the task state
+- Suggest continuing with the appropriate skill (e.g., `/build-feature` if in implementation)
+- Show the next steps recorded in SESSION.md
 
-Si no hay tarea en curso, sugiere opciones:
+If there is no task in progress, suggest options:
 
-- `/build-feature [descripcion]` — para implementar una feature nueva
-- `/new-feature [nombre]` — para preparar el entorno de una feature
-- `/status` — para ver el estado general del proyecto
-- `/council [pregunta]` — para debatir una decision importante
+- `/build-feature [description]` — to implement a new feature
+- `/new-feature [name]` — to prepare the environment for a feature
+- `/status` — to see the general project state
+- `/council [question]` — to debate an important decision
 
-### Paso 5 — Actualizar sesion
+### Step 5 — Update session
 
-Actualiza SESSION.md con la fecha actual para registrar que la sesion inicio.
+Update SESSION.md with the current date to record that the session has started.
 
 ## Example Session
 

package/src/templates/skills/status/SKILL.md

@@ -1,67 +1,67 @@
 ---
 name: status
-description: "Muestra estado actual del proyecto y sesion"
+description: "Shows current project and session state"
 user-invocable: true
 ---
 
 # Status
 
-Muestra un resumen completo del estado actual del proyecto, la sesion activa y los recursos disponibles de Guild.
+Shows a complete summary of the current project state, the active session, and the available Guild resources.
 
-## Cuando usarlo
+## When to use
 
-- Al inicio de una sesion para orientarte
-- Para verificar que Guild esta correctamente configurado
-- Para ver que agentes y skills estan disponibles
+- At the start of a session to get oriented
+- To verify that Guild is correctly configured
+- To see which agents and skills are available
 
-## Uso
+## Usage
 
 `/status`
 
-## Proceso
+## Process
 
-### Paso 1 — Leer archivos de estado
+### Step 1 — Read state files
 
-Lee los archivos de configuracion de Guild:
+Read the Guild configuration files:
 
-- `CLAUDE.md` — instrucciones y convenciones del proyecto
-- `PROJECT.md` — identidad, stack y agentes configurados
-- `SESSION.md` — estado de la sesion actual
+- `CLAUDE.md` — project instructions and conventions
+- `PROJECT.md` — identity, stack, and configured agents
+- `SESSION.md` — current session state
 
-### Paso 2 — Presentar estado
+### Step 2 — Present state
 
-Muestra el resumen con el siguiente formato:
+Show the summary in the following format:
 
 ```text
-Guild v1 — [nombre del proyecto]
+Guild v1 — [project name]
 
-Sesion actual:
-- Fecha: [fecha de SESSION.md]
-- Tarea en curso: [tarea o "ninguna"]
-- Estado: [estado actual]
+Current session:
+- Date: [date from SESSION.md]
+- Task in progress: [task or "none"]
+- State: [current state]
 
 Stack:
-- [tecnologias listadas en PROJECT.md]
+- [technologies listed in PROJECT.md]
 
-Agentes disponibles:
-- [lista de archivos .md en .claude/agents/]
+Available agents:
+- [list of .md files in .claude/agents/]
 
-Skills disponibles:
-- [lista de directorios en .claude/skills/]
+Available skills:
+- [list of directories in .claude/skills/]
 
-Proximos pasos:
-- [extraidos de SESSION.md]
+Next steps:
+- [extracted from SESSION.md]
 ```
 
-### Paso 3 — Sugerir acciones
+### Step 3 — Suggest actions
 
-Si no hay tarea en curso, sugiere:
+If there is no task in progress, suggest:
 
-- `/build-feature` para implementar algo nuevo
-- `/new-feature` para preparar el entorno de una feature
-- `/council` para debatir una decision
+- `/build-feature` to implement something new
+- `/new-feature` to prepare the environment for a feature
+- `/council` to debate a decision
 
-Si hay tarea en curso, sugiere continuar con el skill apropiado segun el estado.
+If there is a task in progress, suggest continuing with the appropriate skill based on the state.
 
 ## Example Session
 
@@ -75,7 +75,7 @@ Session: 2026-02-23
 Task: Implementing user preferences
 State: Phase 4 — Developer implementing
 
-Agents: advisor, product-owner, tech-lead, developer, code-reviewer, qa, bugfix, db-migration
+Agents: advisor, product-owner, tech-lead, developer, code-reviewer, qa, bugfix, db-migration, platform-expert
 Skills: guild-specialize, build-feature, new-feature, council, qa-cycle, review, dev-flow,
   status, session-start, session-end
 ```

package/src/utils/files.js

@@ -1,5 +1,5 @@
 /**
- * files.js — Utilidades de sistema de archivos para Guild v1
+ * files.js — File system utilities for Guild v1
  */
 
 import { mkdirSync, copyFileSync, existsSync, readdirSync, readFileSync } from 'fs';
@@ -12,7 +12,7 @@ const AGENTS_DIR = join('.claude', 'agents');
 const SKILLS_DIR = join('.claude', 'skills');
 
 /**
- * Lista los nombres de los 9 agentes v1.
+ * Returns the names of the 9 v1 agents.
  */
 export function getAgentNames() {
   return [
@@ -29,7 +29,7 @@ export function getAgentNames() {
 }
 
 /**
- * Copia los templates de agentes y skills al proyecto del usuario.
+ * Copies agent and skill templates to the user's project.
  */
 export async function copyTemplates() {
   mkdirSync(AGENTS_DIR, { recursive: true });
@@ -65,7 +65,7 @@ export async function copyTemplates() {
 }
 
 /**
- * Lee el contenido de PROJECT.md si existe.
+ * Reads the contents of PROJECT.md if it exists.
  */
 export function readProjectMd() {
   const path = 'PROJECT.md';
@@ -74,7 +74,7 @@ export function readProjectMd() {
 }
 
 /**
- * Lee el contenido de SESSION.md si existe.
+ * Reads the contents of SESSION.md if it exists.
  */
 export function readSessionMd() {
   const path = 'SESSION.md';
@@ -83,9 +83,9 @@ export function readSessionMd() {
 }
 
 /**
- * Resuelve la raiz del proyecto Guild caminando hacia arriba desde startDir.
- * Busca .claude/ o PROJECT.md como marcadores de un proyecto Guild.
- * Retorna la ruta absoluta del proyecto o null si no se encuentra.
+ * Resolves the Guild project root by walking up from startDir.
+ * Looks for .claude/ or PROJECT.md as markers of a Guild project.
+ * Returns the absolute path to the project or null if not found.
  */
 export function resolveProjectRoot(startDir = process.cwd()) {
   let dir = resolve(startDir);