guild-agents 0.2.5 → 0.2.7

package/src/templates/skills/dev-flow/SKILL.md

@@ -1,60 +1,60 @@
 ---
 name: dev-flow
-description: "Muestra fase actual del pipeline y que sigue"
+description: "Shows current pipeline phase and what comes next"
 user-invocable: true
 ---
 
 # Dev Flow
 
-Muestra la fase actual del pipeline de desarrollo y sugiere el siguiente paso. Util para retomar trabajo cuando no recuerdas en que punto del flujo te quedaste.
+Shows the current phase of the development pipeline and suggests the next step. Useful for resuming work when you do not remember where you left off in the flow.
 
-## Cuando usarlo
+## When to use
 
-- Cuando retomas trabajo y no recuerdas la fase actual
-- Para ver el progreso del pipeline de build-feature
-- Para decidir que skill ejecutar a continuacion
+- When resuming work and you do not remember the current phase
+- To see the progress of the build-feature pipeline
+- To decide which skill to run next
 
-## Uso
+## Usage
 
 `/dev-flow`
 
-## Proceso
+## Process
 
-### Paso 1 — Leer estado
+### Step 1 — Read state
 
-Lee `SESSION.md` para determinar:
+Read `SESSION.md` to determine:
 
-- Si hay una feature en curso
-- En que fase del pipeline se encuentra
-- Que se completo y que falta
+- Whether there is a feature in progress
+- Which pipeline phase it is in
+- What has been completed and what remains
 
-### Paso 2 — Determinar fase actual
+### Step 2 — Determine current phase
 
-Las fases del pipeline son:
+The pipeline phases are:
 
-1. **Evaluacion** (Advisor) — go/no-go
-2. **Especificacion** (Product Owner) — criterios de aceptacion
-3. **Approach tecnico** (Tech Lead) — plan de implementacion
-4. **Implementacion** (Developer) — codigo y tests
-5. **Review** (Code Reviewer) — revision de calidad
-6. **QA** — validacion funcional
+1. **Evaluation** (Advisor) — go/no-go
+2. **Specification** (Product Owner) — acceptance criteria
+3. **Technical Approach** (Tech Lead) — implementation plan
+4. **Implementation** (Developer) — code and tests
+5. **Review** (Code Reviewer) — quality review
+6. **QA** — functional validation
 
-### Paso 3 — Presentar estado del flujo
+### Step 3 — Present flow state
 
 ```text
-Dev Flow — [nombre de la feature]
+Dev Flow — [feature name]
 
-[x] Fase 1 — Evaluacion (completada)
-[x] Fase 2 — Especificacion (completada)
-[ ] Fase 3 — Approach tecnico (pendiente) <-- estas aqui
-[ ] Fase 4 — Implementacion
-[ ] Fase 5 — Review
-[ ] Fase 6 — QA
+[x] Phase 1 — Evaluation (completed)
+[x] Phase 2 — Specification (completed)
+[ ] Phase 3 — Technical Approach (pending) <-- you are here
+[ ] Phase 4 — Implementation
+[ ] Phase 5 — Review
+[ ] Phase 6 — QA
 
-Siguiente paso: Ejecuta /build-feature para continuar desde la Fase 3.
+Next step: Run /build-feature to continue from Phase 3.
 ```
 
-Si no hay feature en curso, informa que no hay pipeline activo y sugiere `/new-feature` o `/build-feature`.
+If there is no feature in progress, report that there is no active pipeline and suggest `/new-feature` or `/build-feature`.
 
 ## Example Session
 

package/src/templates/skills/guild-specialize/SKILL.md

@@ -1,116 +1,116 @@
 ---
 name: guild-specialize
-description: "Enriquece CLAUDE.md explorando el proyecto y especializa los agentes al stack real"
+description: "Enriches CLAUDE.md by exploring the project and specializes agents to the real stack"
 user-invocable: true
 ---
 
 # Guild Specialize
 
-Explora el proyecto real del usuario y enriquece toda la configuracion de Guild con informacion concreta del stack, arquitectura y convenciones detectadas.
+Explores the user's real project and enriches the entire Guild configuration with concrete information about the detected stack, architecture, and conventions.
 
-Este skill se ejecuta una vez despues de `guild init`. Transforma los placeholders genericos en informacion real del proyecto.
+This skill runs once after `guild init`. It transforms generic placeholders into real project information.
 
-## Cuando usarlo
+## When to use
 
-- Inmediatamente despues de ejecutar `guild init`
-- Cuando se agrega un stack nuevo al proyecto (nueva base de datos, nuevo framework)
-- Cuando la estructura del proyecto cambio significativamente
+- Immediately after running `guild init`
+- When a new stack is added to the project (new database, new framework)
+- When the project structure has changed significantly
 
-## Proceso
+## Process
 
-### Paso 1 — Leer contexto base
+### Step 1 — Read base context
 
-Lee los archivos de configuracion de Guild:
+Read the Guild configuration files:
 
-- `CLAUDE.md` — instrucciones actuales (contiene placeholders `[PENDIENTE: guild-specialize]`)
-- `PROJECT.md` — identidad y stack declarado durante init
-- `SESSION.md` — estado de sesion actual
+- `CLAUDE.md` — current instructions (contains `[PENDING: guild-specialize]` placeholders)
+- `PROJECT.md` — identity and stack declared during init
+- `SESSION.md` — current session state
 
-### Paso 2 — Explorar el proyecto real
+### Step 2 — Explore the real project
 
-Investiga la estructura real del proyecto buscando:
+Investigate the real project structure looking for:
 
-**Dependencias y versiones:**
+**Dependencies and versions:**
 
 - `package.json` (Node.js/frontend)
-- `pom.xml` o `build.gradle` (Java)
-- `requirements.txt` o `pyproject.toml` (Python)
+- `pom.xml` or `build.gradle` (Java)
+- `requirements.txt` or `pyproject.toml` (Python)
 - `Gemfile` (Ruby)
 - `go.mod` (Go)
 - `Cargo.toml` (Rust)
 
-**Arquitectura y estructura:**
+**Architecture and structure:**
 
-- Carpetas `src/`, `app/`, `lib/`, `pkg/`, `internal/`
-- Patron de organizacion: por capas, por features, por dominio
-- Entry points del proyecto
+- Folders `src/`, `app/`, `lib/`, `pkg/`, `internal/`
+- Organization pattern: by layers, by features, by domain
+- Project entry points
 
-**Configuracion y convenciones:**
+**Configuration and conventions:**
 
 - `tsconfig.json`, `eslint.config.*`, `.prettierrc`
-- `.env.example`, `.env.local` (variables de entorno — NO leer `.env` real)
+- `.env.example`, `.env.local` (environment variables — do NOT read real `.env`)
 - `Dockerfile`, `docker-compose.yml`
 - CI/CD: `.github/workflows/`, `.gitlab-ci.yml`
 
-**Base de datos y migraciones:**
+**Database and migrations:**
 
-- Carpeta `migrations/`, `db/`, `prisma/`, `drizzle/`
-- ORM o query builder configurado
-- Schema existente
+- Folder `migrations/`, `db/`, `prisma/`, `drizzle/`
+- Configured ORM or query builder
+- Existing schema
 
-**Documentacion existente:**
+**Existing documentation:**
 
-- `README.md` — vision general del proyecto
-- Documentacion interna en `docs/`
+- `README.md` — project overview
+- Internal documentation in `docs/`
 
-### Paso 3 — Enriquecer CLAUDE.md
+### Step 3 — Enrich CLAUDE.md
 
-Reemplaza todos los placeholders `[PENDIENTE: guild-specialize]` en CLAUDE.md con informacion real:
+Replace all `[PENDING: guild-specialize]` placeholders in CLAUDE.md with real information:
 
-- **Stack con versiones exactas**: extraidas de los archivos de dependencias
-- **Estructura de carpetas explicada**: que hace cada carpeta principal
-- **Convenciones de codigo detectadas**: linter, formatter, estilo de imports
-- **Patrones de arquitectura identificados**: MVC, hexagonal, modular, etc.
-- **Variables de entorno conocidas**: listadas desde `.env.example`
-- **Limitaciones y deuda tecnica visible**: dependencias desactualizadas, TODOs encontrados
-- **Comandos utiles del proyecto**: scripts de npm/make/cargo detectados
+- **Stack with exact versions**: extracted from dependency files
+- **Folder structure explained**: what each main folder does
+- **Detected code conventions**: linter, formatter, import style
+- **Identified architecture patterns**: MVC, hexagonal, modular, etc.
+- **Known environment variables**: listed from `.env.example`
+- **Visible limitations and technical debt**: outdated dependencies, TODOs found
+- **Useful project commands**: detected npm/make/cargo scripts
 
-### Paso 4 — Especializar agentes
+### Step 4 — Specialize agents
 
-Para cada agente en `.claude/agents/*.md`, agrega contexto especifico del proyecto:
+For each agent in `.claude/agents/*.md`, add project-specific context:
 
-- **advisor.md**: dominio real del proyecto, usuarios objetivo
-- **tech-lead.md**: stack especifico, patrones detectados, decisiones de arquitectura
-- **product-owner.md**: funcionalidades existentes, backlog visible
-- **developer.md**: convenciones de codigo, framework principal, estructura de archivos
-- **code-reviewer.md**: reglas de lint, patrones del proyecto, anti-patrones a vigilar
-- **qa.md**: framework de testing, comandos para ejecutar tests, cobertura actual
-- **bugfix.md**: stack de debugging, logs, herramientas disponibles
-- **db-migration.md**: ORM, herramienta de migraciones, schema actual (si aplica)
+- **advisor.md**: real project domain, target users
+- **tech-lead.md**: specific stack, detected patterns, architecture decisions
+- **product-owner.md**: existing functionality, visible backlog
+- **developer.md**: code conventions, main framework, file structure
+- **code-reviewer.md**: lint rules, project patterns, anti-patterns to watch
+- **qa.md**: testing framework, commands to run tests, current coverage
+- **bugfix.md**: debugging stack, logs, available tools
+- **db-migration.md**: ORM, migration tool, current schema (if applicable)
 
-Usa el tool `Task` para invocar cada agente leyendo su `.claude/agents/[nombre].md` si necesitas perspectiva especializada para enriquecer su configuracion.
+Use the `Task` tool to invoke each agent by reading their `.claude/agents/[name].md` if you need a specialized perspective to enrich their configuration.
 
-### Paso 5 — Confirmar
+### Step 5 — Confirm
 
-Presenta un resumen de lo detectado:
+Present a summary of what was detected:
 
 ```text
-Guild v1 especializado para [nombre-proyecto]
+Guild v1 specialized for [project-name]
 
-Stack detectado:
-- [lista de tecnologias con versiones]
+Detected stack:
+- [list of technologies with versions]
 
-Arquitectura:
-- [patron identificado]
-- [estructura principal]
+Architecture:
+- [identified pattern]
+- [main structure]
 
-Agentes actualizados:
-- [lista de agentes con su especializacion aplicada]
+Updated agents:
+- [list of agents with their applied specialization]
 
-Ejecuta /status para ver el estado completo.
+Run /status to see the full state.
 ```
 
-### Paso 6 — Commit enrichment immediately
+### Step 6 — Commit enrichment immediately
 
 **CRITICAL:** After enriching CLAUDE.md and agent files, commit the changes immediately as their own atomic commit. Do NOT leave them as unstaged changes — they are vulnerable to `git stash` and other operations.
 
@@ -146,11 +146,11 @@ Agents updated:
 Run /status to see the full state.
 ```
 
-## Notas importantes
+## Important Notes
 
-- NUNCA leas archivos `.env` reales — solo `.env.example` o `.env.local`
-- Si no puedes detectar algo con certeza, pregunta al usuario en vez de asumir
-- Prioriza precision sobre completitud — es mejor decir "no detectado" que inventar
-- Los agentes deben quedar especializados al stack real, no generico
+- NEVER read real `.env` files — only `.env.example` or `.env.local`
+- If you cannot detect something with certainty, ask the user instead of assuming
+- Prioritize accuracy over completeness — it is better to say "not detected" than to fabricate
+- Agents should be specialized to the real stack, not generic
 - NEVER use `git stash` in automated pipelines — use `wip:` commits instead
 - CLAUDE.md changes must always be committed separately from feature code

package/src/templates/skills/new-feature/SKILL.md

@@ -1,60 +1,60 @@
 ---
 name: new-feature
-description: "Crea branch y scaffold para una nueva feature"
+description: "Creates branch and scaffold for a new feature"
 user-invocable: true
 ---
 
 # New Feature
 
-Prepara el entorno para trabajar en una nueva feature: crea branch, actualiza SESSION.md y opcionalmente crea un GitHub Issue.
+Prepares the environment for working on a new feature: creates a branch, updates SESSION.md, and optionally creates a GitHub Issue.
 
-## Cuando usarlo
+## When to use
 
-- Al iniciar una feature nueva antes de escribir codigo
-- Cuando quieres dejar registrado el contexto de la feature en SESSION.md
+- When starting a new feature before writing code
+- When you want to record the feature context in SESSION.md
 
-## Uso
+## Usage
 
-`/new-feature [nombre-de-la-feature]`
+`/new-feature [feature-name]`
 
-## Proceso
+## Process
 
-### Paso 1 — Obtener nombre
+### Step 1 — Get name
 
-Si el usuario no proporciono nombre, preguntale:
+If the user did not provide a name, ask for:
 
-- Nombre corto para la feature (se usara en el nombre del branch)
-- Descripcion breve (1-2 oraciones)
+- Short name for the feature (will be used in the branch name)
+- Brief description (1-2 sentences)
 
-### Paso 2 — Crear branch con worktree isolation
+### Step 2 — Create branch with worktree isolation
 
 When running in parallel with other agents, use git worktrees for isolation. When running standalone, a simple branch is sufficient.
 
 **For parallel execution (multiple build-features at once):**
 
 ```bash
-git worktree add .claude/worktrees/feature-[nombre] -b feature/[nombre-de-la-feature] develop
+git worktree add .claude/worktrees/feature-[name] -b feature/[feature-name] develop
 ```
 
-All subsequent operations should use `.claude/worktrees/feature-[nombre]` as the working directory.
+All subsequent operations should use `.claude/worktrees/feature-[name]` as the working directory.
 
 **For standalone execution:**
 
 ```bash
-git checkout -b feature/[nombre-de-la-feature]
+git checkout -b feature/[feature-name]
 ```
 
-Si el branch ya existe, pregunta si quiere cambiarse a el o crear uno nuevo.
+If the branch already exists, ask whether to switch to it or create a new one.
 
-**Cleanup:** At skill exit, if using worktrees, the caller is responsible for cleanup via `git worktree remove .claude/worktrees/feature-[nombre]` after the PR is merged.
+**Cleanup:** At skill exit, if using worktrees, the caller is responsible for cleanup via `git worktree remove .claude/worktrees/feature-[name]` after the PR is merged.
 
-### Paso 3 — Actualizar SESSION.md
+### Step 3 — Update SESSION.md
 
-Actualiza SESSION.md con el contexto de la nueva feature:
+Update SESSION.md with the new feature context:
 
-- **Fecha:** fecha actual
-- **Tarea en curso:** nombre de la feature
-- **Estado:** Feature iniciada — pendiente de implementacion
+- **Date:** current date
+- **Task in progress:** feature name
+- **State:** Feature started — pending implementation
 
 ## Example Session
 
@@ -68,19 +68,19 @@ GitHub Issue #42 created.
 Next: Run /build-feature to implement.
 ```
 
-### Paso 4 — GitHub Issue (opcional)
+### Step 4 — GitHub Issue (optional)
 
-Si el proyecto tiene integracion GitHub configurada en PROJECT.md:
+If the project has GitHub integration configured in PROJECT.md:
 
-1. Pregunta si quiere crear un GitHub Issue para la feature
-2. Si acepta, crea el issue con `gh issue create`
-3. Registra la URL del issue en SESSION.md
+1. Ask whether to create a GitHub Issue for the feature
+2. If accepted, create the issue with `gh issue create`
+3. Record the issue URL in SESSION.md
 
-### Paso 5 — Confirmar
+### Step 5 — Confirm
 
-Confirma al usuario:
+Confirm to the user:
 
-- Branch creado: `feature/[nombre]`
-- SESSION.md actualizado
-- GitHub Issue creado (si aplica)
-- Sugiere: "Ejecuta /build-feature para implementar la feature completa"
+- Branch created: `feature/[name]`
+- SESSION.md updated
+- GitHub Issue created (if applicable)
+- Suggest: "Run /build-feature to implement the full feature"

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