@ancleto/spec 0.6.32 → 0.6.34

package/README.md

@@ -178,7 +178,7 @@ El registro es tuyo y local: no viaja con el repo ni se comparte. `ANCLETO_PROJE
 En la primera ejecución, un **wizard interactivo** te guía por los pasos de configuración (agente/IDE y nivel de gasto). También podés pasarlos por flags:
 
 ```bash
-ancleto init --agent opencode --tier normal
+ancleto init --agent opencode --tier normal --lang es
 ```
 
 | Tier | Qué hace |
@@ -189,6 +189,39 @@ ancleto init --agent opencode --tier normal
 
 La configuración se preserva en `.ancletorc` (raíz del proyecto) y `.ancleto-tier` (junto a la configuración instalada).
 
+### Idioma de los artifacts
+
+El contenido de `proposal.md`, `design.md`, `tasks.md` y `specs/` se escribe en el idioma de tu conversación (`auto`, el default) o en el código que fijes con `--lang`:
+
+```bash
+ancleto init --lang auto   # detecta el idioma de tus primeros mensajes y lo guarda
+ancleto init --lang es     # fija español para ese proyecto
+```
+
+Con `auto`, el orquestador detecta el idioma en tus primeros hasta 3 mensajes y lo persiste en `.ancletorc` → `language`. Podés volver a `auto` o fijar otro código cuando quieras (`auto | es | en | pt`). Lo que **nunca** se traduce: los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`) y los nombres de archivos y directorios.
+
+### Exclusiones del discovery
+
+En la instalación interactiva elegís qué excluir del seed técnico con un menú (tests, assets pesados, docs, migraciones/seeds, lockfiles). Excluir reduce el tamaño del pack y estabiliza la detección de cambios:
+
+```bash
+ancleto init --exclude "**/*.test.*,**/*.png,docs"   # sin menú, directo
+```
+
+Se guarda en `.ancletorc` → `discovery.exclude` y se preserva en `update`/`upgrade`.
+
+### Frescura del seed (impact)
+
+`ancleto discovery --check` no solo dice si el seed está `STALE`: dice **qué tan grave** es el cambio con `impact`:
+
+| `impact` | Significado | Qué pasa |
+|---|---|---|
+| `none` | Sin cambios | El agente trabaja normal |
+| `minor` | Cambios fuera de áreas materiales (un componente, un estilo) | El agente trabaja y lo anota en el resumen; **no ofrece regenerar** |
+| `material` | Cambió un config de runtime, un entry point o apareció un directorio raíz nuevo | El agente **ofrece regenerar** (solo con tu aprobación) |
+
+La excepción: si el agente detecta un **hueco concreto** (info que el seed debería tener y no tiene, como una paleta nueva sin unidad), puede ofrecer regenerar aunque el `impact` sea `minor` — siempre con tu aprobación. Nunca regenera solo.
+
 ---
 
 ## Uso rápido
@@ -226,10 +259,10 @@ ancleto discovery         # Genera .discovery-map.json y empaqueta el repo
 ## Referencia de comandos CLI
 
 ```bash
-ancleto init [--agent <nombre>] [--tier <nivel>] [--with-azure]
+ancleto init [--agent <nombre>] [--tier <nivel>] [--lang <codigo>] [--exclude <globs>] [--with-azure]
                           # Configura el proyecto (interactivo en TTY)
 
-ancleto install [--project <dir>] [--tier <nivel>] [--agent <nombre>] [--no-mcp]
+ancleto install [--project <dir>] [--tier <nivel>] [--agent <nombre>] [--lang <codigo>] [--exclude <globs>] [--no-mcp]
                           # Instala agentes, skills y templates
 
 ancleto update            # Re-instala la última versión sobre lo existente

package/agents/documenter.md

@@ -117,7 +117,7 @@ Do not treat archive as a blind file move.
 
 When a completed change modifies behavior through aspec deltas, `aspec/specs/` must reflect that completed behavior before the change is archived.
 
-**Language**: spec artifacts are written in English. The requirement/scenario keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. Paths, file names, and identifiers stay unchanged.
+**Language**: write spec content in the user's conversation language (or the project's configured `language` in `.ancletorc`). The requirement/scenario keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. Paths, file names, and identifiers stay unchanged.
 
 Handle these delta sections carefully:
 

package/agents/orchestrator.md

@@ -65,12 +65,13 @@ The orchestrator never executes `ancleto discovery --check`. When the technical
 | --------- | ------------------------------------------------------------------------------------------------------------------------- |
 | `READY`   | use the focused answer returned by `@technical-discovery`                                                                 |
 | `PARTIAL` | explain which required documents are unavailable and offer to complete them                                               |
-| `STALE`   | use the answer with its freshness warning and offer regeneration only when stale context could materially affect the work |
+| `STALE` (minor) | use the answer with a one-line freshness note; do not offer regeneration — the seed is still usable                  |
+| `STALE` (material) | warn and offer regeneration only when a concrete gap (info the seed should have but lacks) or the changed area affects the work |
 | `MISSING` | explain that broad repository context is unavailable and offer to generate the seed                                       |
 
 For `MISSING` and `PARTIAL`, never generate automatically. Ask for explicit user approval before invoking `@technical-seed-writer`. If approved, pass the complete check report returned by `@technical-discovery` and the action `generate` or `complete`. If declined, continue only when the request can be handled safely without broad repository context; otherwise report the limitation and stop.
 
-For `STALE`, delegate `regenerate` to `@technical-seed-writer` only after explicit user approval.
+For `STALE`, delegate `regenerate` to `@technical-seed-writer` only after explicit user approval. When `impact` is `minor`, keep working from the seed and mention the drift in the summary. A concrete gap found while working — needed info the seed does not cover — may justify offering regeneration even with `minor` impact, always with approval.
 
 `@technical-discovery` owns read-only repository orientation and seed-state inspection. `@technical-seed-writer` owns all seed generation, completion, and regeneration. Never substitute an unavailable seed with a manual repository scan.
 
@@ -124,7 +125,17 @@ Azure DevOps is optional and **disabled by default**. Before any Work Item intak
 
 ### Resolved Context Envelope
 
-Keep this envelope for the entire session. Do not reconstruct it from memory or reduce it to a prose summary. When a Work Item was resolved, it contains its id, title, type, project, full normalized description, and full acceptance criteria. Add the original user request, enumerated requirements, explicit restrictions, and later user decisions or exclusions.
+Keep this envelope for the entire session. Do not reconstruct it from memory or reduce it to a prose summary. When a Work Item was resolved, it contains its id, title, type, project, full normalized description, and full acceptance criteria. Add the original user request, enumerated requirements, explicit restrictions, and later user decisions or exclusions. Carry the resolved artifacts language (`language`) in the envelope as well.
+
+### Artifacts Language
+
+Resolve the working language for artifact content once per session:
+
+- Read `language` from `.ancletorc` at the repo root.
+- If it is `auto`, detect the language from the user's first up to 3 messages in this session. If the user never deviates, that language governs.
+- Persist it: the first write-capable delegation in the session (`@spec-writer` when spec generation runs, otherwise `@coder`) MUST update `.ancletorc` → `language` with the resolved code, but only when it is currently `auto`. This is silent bookkeeping — never ask the user for it. An explicit configured code is never overwritten.
+- Pass the resolved `language` in the Resolved Context Envelope to every subagent that writes artifacts.
+- Artifact content uses the resolved language; keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names stay literal English.
 
 Pass the relevant envelope verbatim when delegating: `@coder` receives the implementation scope; `@tester` receives it plus the coder's modified files and risks; `@reviewer` receives it plus task-owned files and the Validation Ledger. Do not omit numbered requirements, paths, commands, acceptance criteria, or explicit exclusions. Only `@context-resolver` may fetch a Work Item. If a subagent says it lacks context, supply the envelope or stop; never tell it to query Azure DevOps.
 
@@ -259,7 +270,7 @@ If the runtime is read-only or plan-only:
 5. **Testing**: Delegate to **`@tester`** to create or update unit tests and perform final validation against the approved scope, including a non-writing format check and one lint pass after all edits. Include the complete Resolved Context Envelope, the coder's task-owned files, and its reported risks. `@tester` returns the final union of task-owned files and the Validation Ledger. A format failure in a task-owned file is failed verification and must not be fixed silently by `@tester`.
 6. **Review**: Delegate to **`@reviewer`** when an independent correctness or scope review is appropriate. Include the complete Resolved Context Envelope, the tester's final task-owned file union, and the full Validation Ledger.
 7. **🛑 FINAL ARCHIVE CHECKPOINT**: If implementation, validation, and any required review are complete with no blocking issues, stop and explicitly ask the user whether to keep iterating on the same change or finalize and archive it
-8. **Finalization / Archive**: Before archiving, verify the delta specs reflect the final implementation — if iteration changed behavior or scope, re-delegate to **`@spec-writer`** to update the delta specs first, so the merge to source-of-truth is accurate. Check the seed freshness before closing: delegate the read-only state check to **`@technical-discovery`** and, when the state is `STALE`, warn and offer regeneration via **`@technical-seed-writer`** with explicit user approval — never automatic; if the user declines, continue the archive normally. This closure check protects future sessions from a silently aging seed. Then delegate to **`@documenter`** only after explicit user approval to archive
+8. **Finalization / Archive**: Before archiving, verify the delta specs reflect the final implementation — if iteration changed behavior or scope, re-delegate to **`@spec-writer`** to update the delta specs first, so the merge to source-of-truth is accurate. Check the seed freshness before closing: delegate the read-only state check to **`@technical-discovery`** and, when the state is `STALE` with `impact: material`, warn and offer regeneration via **`@technical-seed-writer`** with explicit user approval — never automatic; with `impact: minor`, continue the archive normally and note the drift in the summary. This closure check protects future sessions from a silently aging seed. Then delegate to **`@documenter`** only after explicit user approval to archive
 9. **Memory Record**: After a successful archive, delegate to **`@memory-keeper`** in Automatic Record mode when a concrete, plausible candidate exists, with the factual completed-work summary and validation evidence supporting it. If no candidate exists, delegate Optional Draft with the factual completed-work summary, `no-automatic-candidate` classification, and the reason no candidate was identified. When Automatic Record returns `no-entry-warranted`, use its draft or delegate Optional Draft with that classification and reason if it could not provide one. Before asking, show the final work summary, classification, reason, and exact draft, then stop for explicit user approval. If no safe draft is available, report that outcome and finish without asking or storing. On approval, delegate User-Approved Record with the unchanged draft, the factual summary and validation evidence used to compose it, archived change name, and card context. On rejection, do not store.
 10. **Report**: Return final status or blocking findings to the user after automatic storage, an explicit decline, or User-Approved Record completes.
 

package/agents/spec-writer.md

@@ -19,9 +19,9 @@ Read `AGENTS.md` at the repo root for project-specific conventions, tech stack,
 
 ## Language Requirement
 
-- All artifact content MUST be written in English
-- Keywords are literal and MUST NOT be translated: `Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED Requirements`, `MODIFIED Requirements`, `REMOVED Requirements`, `RENAMED Requirements`
-- File names and directory names MUST remain in English, following aspec conventions
+- Write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`)
+- Keywords are literal and MUST NOT be translated: `Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED Requirements`, `MODIFIED Requirements`, `REMOVED Requirements`, `RENAMED Requirements`
+- File names and directory names are literal and MUST NOT be translated: English kebab-case, following aspec conventions
 
 ## Primary Responsibility
 

package/agents/technical-discovery.md

@@ -76,7 +76,8 @@ Inspect seed state only when `docs/technical-discovery/` is the selected source.
 | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `READY`   | answer from the seed                                                                                                                                        |
 | `PARTIAL` | use an available document only when it safely answers the focused question; otherwise report the missing documents and request completion                   |
-| `STALE`   | answer with an explicit freshness warning when the evidence is sufficient; request regeneration only when stale evidence could materially affect the answer |
+| `STALE` with `impact: minor` | answer noting the freshness drift; do not request regeneration — the seed is still usable                                                       |
+| `STALE` with `impact: material` | answer with an explicit freshness warning when the evidence is sufficient; request regeneration only when stale evidence could materially affect the answer |
 | `MISSING` | report that broad repository context is unavailable and request generation                                                                                  |
 
 You **report** states and recommend actions. You never resolve them: generating or regenerating
@@ -117,7 +118,7 @@ Any request to create, modify, or implement — including writing aspec artifact
 | Situation                              | Action                                                                                                                             |
 | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
 | request to create / modify / implement | return the context and escalate the request to the `@orchestrator`                                                                 |
-| seed missing, partial, or stale        | report the state and emit the corresponding `SEED_ACTION_REQUIRED` marker for `@orchestrator` to delegate `@technical-seed-writer` |
+| seed missing, partial, or stale with material impact | report the state and emit the corresponding `SEED_ACTION_REQUIRED` marker for `@orchestrator` to delegate `@technical-seed-writer` |
 
 When you were delegated, do not address the developer as if they had called you: your output is context for the calling agent.
 
@@ -126,7 +127,7 @@ When you were delegated, do not address the developer as if they had called you:
 - **Answer in Spanish.** Paths, file names, and identifiers stay as they are.
 - Cite the paths that support each claim.
 - State which source you used and whether seed inspection was required.
-- When seed inspection was required, return the resolved state and the complete unchanged check report if a seed action is needed.
+- When seed inspection was required, return the resolved state with its `impact`, and the complete unchanged check report if a seed action is needed.
 - Declare — when they apply — the stale nodes, any direct code read, and any gap left by the budget.
 - If the seed state prevented the answer, state that no repository sweep was performed and
   include the required `SEED_ACTION_REQUIRED` marker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancleto/spec",
-  "version": "0.6.32",
+  "version": "0.6.34",
   "description": "Orquestador SDD liviano con subagentes optimizados para costo/tokens",
   "type": "module",
   "bin": {

package/skills/ancleto-archive/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Archive
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Archive a completed change: check completion, sync delta specs, move the directory. No external binaries.
 
@@ -46,9 +46,10 @@ Check for delta specs at `aspec/changes/<name>/specs/`; if none, proceed without
 
 ### 3. Check technical seed freshness
 
-If the `ancleto` CLI is available in this project, run `ancleto discovery --check` (read-only) and read its JSON `state`.
+If the `ancleto` CLI is available in this project, run `ancleto discovery --check` (read-only) and read its JSON `state` and `impact`.
 
-- **`STALE`**: warn that the technical seed is out of date for the current code, and offer to regenerate it now (follow the `ancleto-technical-discovery` skill) or to continue archiving with the stale seed.
+- **`STALE` with `impact: material`**: warn that the technical seed is out of date in material areas, and offer to regenerate it now (follow the `ancleto-technical-discovery` skill) or to continue archiving with the stale seed.
+- **`STALE` with `impact: minor`**: continue without offering — the seed is still usable; record the drift in the summary.
 - **Any other state**: continue without comment.
 - Never regenerate automatically — regenerate only with the user's explicit approval.
 - If the user declines, continue the archive normally and record the stale seed in the summary.

package/skills/ancleto-bulk-archive/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Bulk Archive
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Archive many completed changes at once, resolving spec conflicts against the implementation. No external binaries.
 

package/skills/ancleto-continue/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Continue
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Continue a change by creating exactly ONE next artifact. No external binaries: state is derived by which artifact files exist.
 

package/skills/ancleto-explore/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Explore
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Enter explore mode. Think deeply. Visualize freely. Follow the conversation.
 

package/skills/ancleto-ff/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec FF
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Fast-forward artifact creation: generate everything needed to start implementation, writing files directly. No external binaries.
 

package/skills/ancleto-new/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec New
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Start a new change with a filesystem-native, artifact-driven flow. No external binaries: every step is a direct file operation.
 

package/skills/ancleto-onboard/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Onboard
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Walk a first-time user through one complete spec-driven cycle on a real task. No external binaries.
 

package/skills/ancleto-propose/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Propose
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Create a change and all its artifacts in one step, writing files directly. No external binaries.
 

package/skills/ancleto-sync-specs/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Sync
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Sync delta specs from a change to main specs.
 

package/skills/ancleto-technical-discovery/SKILL.md

@@ -41,7 +41,8 @@ further or create one subagent per unit: generation happens in one sequential ex
 | --- | --- |
 | `READY` | Read `index.md` and at most two documents it routes to. |
 | `PARTIAL` | Complete only the missing documents. |
-| `STALE` | Regenerate only the affected focused dossier; update a transversal decision when it changed. |
+| `STALE` with `impact: minor` | Answer from the seed and note the freshness drift; do not regenerate or run another pack for it. |
+| `STALE` with `impact: material` | Regenerate only the affected focused dossier; update a transversal decision when it changed. |
 | `MISSING` | Generate the concise seed. |
 
 Never replace a missing seed with a manual repository sweep.

package/skills/ancleto-upgrade/SKILL.md

@@ -19,7 +19,7 @@ metadata:
 
 # ancleto-upgrade
 
-**Artifacts language**: write every artifact in English. Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) are literal and MUST NOT be translated. File and directory names stay English kebab-case.
+**Artifacts language**: write artifact content in the user's conversation language (or the project's configured `language` in `.ancletorc`). Keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED Requirements`) and file/directory names are literal and MUST NOT be translated.
 
 Generate an aspec change migrating any library/runtime to a new major version; never edit code.
 

package/src/cli/index.js

@@ -32,14 +32,16 @@ Uso:
   ancleto install --no-mcp           Igual que install pero sin tocar config MCP
   ancleto install --with-engram      Ademas configura el MCP externo engram (memoria opcional)
   ancleto install --tier <nivel>     normal | minimo | gratis (wizard interactivo en TTY)
+  ancleto install --lang <codigo>    auto | es | en | pt (idioma de los artifacts; auto = idioma de la conversacion)
+  ancleto install --exclude <globs>  Paths excluidos del discovery, coma-separados (ej: "**/*.png,docs")
   ancleto install --agent <nombre>    opencode | vscode | antigravity | cursor | roo (wizard si no esta guardado)
   ancleto update [--project <dir>]    Alias de install (re-instala sobre lo existente)
                                    Parado en un proyecto con .ancletorc opera sobre ese proyecto;
                                    usa --global para forzar el alcance global
   ancleto upgrade [--agent <nombre>]  Re-aplica templates (LOCKED) y skills sobre el proyecto actual
-  ancleto init [--with-azure] [--agent <nombre>] [--tier <nivel>]
-                                    Crea .ancletorc en el repositorio actual
-                                    (interactivo en TTY: banner + menu; Azure desactivado por defecto)
+  ancleto init [--with-azure] [--agent <nombre>] [--tier <nivel>] [--lang <codigo>] [--exclude <globs>]
+                                     Crea .ancletorc en el repositorio actual
+                                     (interactivo en TTY: banner + menu; Azure desactivado por defecto)
   ancleto discovery --check           Estado del seed (READY/STALE/PARTIAL/MISSING)
   ancleto discovery [--compress] [--include G] [--ignore G] [--token-budget N]
                                    Empaca el repo con Repomix y guarda estado
@@ -622,6 +624,63 @@ function scanTierFlag(args) {
   return t
 }
 
+const SUPPORTED_LANGS = ['auto', 'es', 'en', 'pt']
+
+function scanLangFlag(args) {
+  const l = flagValue(args, '--lang')
+  if (!l) return null
+  if (!SUPPORTED_LANGS.includes(l)) {
+    console.error(`ancleto: idioma invalido: ${l} (${SUPPORTED_LANGS.join('|')})`)
+    process.exit(1)
+  }
+  return l
+}
+
+function langLabel(code) {
+  return { auto: 'automatico (idioma de la conversacion)', es: 'espanol', en: 'ingles', pt: 'portugues' }[code] || code
+}
+
+const EXCLUDE_PRESETS = [
+  { key: 'tests', label: 'tests (*.test.*, *.spec.*, __tests__)', recommended: true, globs: ['**/*.test.*', '**/*.spec.*', '**/__tests__/**'] },
+  { key: 'assets', label: 'assets pesados (*.png, *.jpg, *.svg, *.ico, public/)', recommended: true, globs: ['**/*.png', '**/*.jpg', '**/*.svg', '**/*.ico', 'public'] },
+  { key: 'docs', label: 'documentacion (docs/)', recommended: false, globs: ['docs'] },
+  { key: 'data', label: 'migraciones y seeds', recommended: false, globs: ['**/migrations/**', '**/seeds/**'] },
+  { key: 'lockfiles', label: 'lockfiles (package-lock, yarn.lock, pnpm-lock)', recommended: true, globs: ['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml'] }
+]
+
+function parseExcludeFlag(value) {
+  return String(value)
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean)
+}
+
+// null = flag ausente; [] = limpiar exclusiones; [...] = globs.
+function scanExcludeFlag(args) {
+  const i = args.indexOf('--exclude')
+  if (i < 0) return null
+  const next = args[i + 1]
+  if (!next || next.startsWith('--')) return []
+  return parseExcludeFlag(next)
+}
+
+// Une los grupos elegidos con los globs propios del proyecto (los que no son de un preset).
+function applyExcludePresets(existing, keys) {
+  const presetGlobs = new Set(EXCLUDE_PRESETS.flatMap((p) => p.globs))
+  const custom = (existing || []).filter((g) => !presetGlobs.has(g))
+  const chosen = EXCLUDE_PRESETS.filter((p) => keys.includes(p.key)).flatMap((p) => p.globs)
+  return [...custom, ...chosen]
+}
+
+async function askExcludePresets(existing) {
+  const presetGlobs = new Set(EXCLUDE_PRESETS.flatMap((p) => p.globs))
+  const hasPreset = (existing || []).some((g) => presetGlobs.has(g))
+  const preselected = EXCLUDE_PRESETS.map((p, i) => (hasPreset ? (p.globs.some((g) => (existing || []).includes(g)) ? i : -1) : p.recommended ? i : -1)).filter((i) => i >= 0)
+  const { cancelled, indices } = await selectMultiple('Que excluir del discovery (ademas de node_modules, dist, build)', EXCLUDE_PRESETS.map((p) => p.label), preselected)
+  if (cancelled) return existing || []
+  return applyExcludePresets(existing, indices.map((i) => EXCLUDE_PRESETS[i].key))
+}
+
 async function resolveAgent(args, existing, allowAsk = Boolean(process.stdin.isTTY)) {
   const flag = scanAgentFlag(args)
   if (flag) return flag
@@ -820,9 +879,13 @@ async function install(args) {
     : null
 
   let agent = agentFlag || (existingRc?.agent && SUPPORTED_AGENTS.includes(existingRc.agent) ? existingRc.agent : null)
+  let language = scanLangFlag(args) || (existingRc?.language && SUPPORTED_LANGS.includes(existingRc.language) ? existingRc.language : null)
+  const excludeFlag = scanExcludeFlag(args)
+  const existingDiscovery = existingRc?.discovery || { outputDir: 'docs/technical-discovery', exclude: [] }
+  let excludeChoice = excludeFlag
 
   let bannerShown = false
-  const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier)
+  const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier || !language || (projectDir && excludeChoice === null && (existingDiscovery.exclude || []).length === 0))
   if (isInteractive) {
     await showBanner()
     bannerShown = true
@@ -833,8 +896,16 @@ async function install(args) {
       const current = TIERS[storedTier] ? storedTier : ''
       tier = await selectOption('Tier de costo', Object.keys(TIERS), Math.max(0, Object.keys(TIERS).indexOf(current)))
     }
+    if (!language) {
+      const picked = await selectOption('Idioma de los artifacts', SUPPORTED_LANGS.map(langLabel), 0)
+      language = SUPPORTED_LANGS[SUPPORTED_LANGS.map(langLabel).indexOf(picked)] || 'auto'
+    }
+    if (projectDir && excludeChoice === null && (existingDiscovery.exclude || []).length === 0) {
+      excludeChoice = await askExcludePresets(existingDiscovery.exclude || [])
+    }
     stopBanner()
   }
+  if (!language) language = 'auto'
 
   if (projectDir && !agent) agent = DEFAULT_AGENT
   if (!tier) tier = TIERS[storedTier] ? storedTier : 'normal'
@@ -862,6 +933,8 @@ async function install(args) {
     const agentSkillsDir = await installAgentSkills(projectDir, agent)
     await writeManifest(projectDir, {
       agent,
+      language,
+      ...(excludeChoice !== null ? { discovery: { ...existingDiscovery, exclude: excludeChoice } } : {}),
       ...(gratisModelChoice ? { gratisModel: gratisModelChoice } : {}),
       installedPaths: {
         templates: ['AGENTS.md', 'PRODUCT.md'],
@@ -942,13 +1015,17 @@ async function initProject(args) {
   const withAzure = args.includes('--with-azure')
   const agentFlag = scanAgentFlag(args)
   const tierFlag = scanTierFlag(args)
+  const langFlag = scanLangFlag(args)
   const existing = await readAncletorc(projectDir)
   const azure = existing?.azure ?? { enabled: false }
-  const discovery = existing?.discovery ?? { outputDir: 'docs/technical-discovery', exclude: [] }
+  let discovery = existing?.discovery ?? { outputDir: 'docs/technical-discovery', exclude: [] }
   const tierFile = join(projectDir, '.opencode', '.ancleto-tier')
+  const excludeFlag = scanExcludeFlag(args)
+  let excludeChoice = excludeFlag
 
-  let agent, tier
-  const isInteractive = Boolean(process.stdout.isTTY) && (!agentFlag || !tierFlag)
+  let agent, tier, language
+  language = langFlag || (existing?.language && SUPPORTED_LANGS.includes(existing.language) ? existing.language : null)
+  const isInteractive = Boolean(process.stdout.isTTY) && (!agentFlag || !tierFlag || !language || (excludeChoice === null && (discovery.exclude || []).length === 0))
   if (isInteractive) {
     await showBanner()
     const agentIdx = Math.max(0, SUPPORTED_AGENTS.indexOf(existing?.agent))
@@ -956,6 +1033,13 @@ async function initProject(args) {
     const tierIdx = Math.max(0, Object.keys(TIERS).indexOf(TIERS[storedTier] ? storedTier : ''))
     agent = agentFlag || await selectOption('Agente/IDE', SUPPORTED_AGENTS, agentIdx)
     tier = tierFlag || await selectOption('Tier de costo', Object.keys(TIERS), tierIdx)
+    if (!language) {
+      const picked = await selectOption('Idioma de los artifacts', SUPPORTED_LANGS.map(langLabel), 0)
+      language = SUPPORTED_LANGS[SUPPORTED_LANGS.map(langLabel).indexOf(picked)] || 'auto'
+    }
+    if (excludeChoice === null && (discovery.exclude || []).length === 0) {
+      excludeChoice = await askExcludePresets(discovery.exclude || [])
+    }
     if (withAzure) {
       azure.enabled = true
     } else {
@@ -965,21 +1049,23 @@ async function initProject(args) {
   } else {
     agent = await resolveAgent(args, existing?.agent, false)
     tier = tierFlag
+    if (!language) language = 'auto'
     if (withAzure) azure.enabled = true
   }
+  if (excludeChoice !== null) discovery = { ...discovery, exclude: excludeChoice }
 
   if (tier) {
     await mkdir(join(projectDir, '.opencode'), { recursive: true })
     await writeFile(tierFile, tier + '\n')
   }
 
-  const manifest = await writeManifest(projectDir, { azure, discovery, agent })
+  const manifest = await writeManifest(projectDir, { azure, discovery, agent, language })
   await copyTemplates(projectDir)
   await scaffoldAspec(projectDir)
   await refreshWorkingContext(projectDir)
   await registerProject(projectDir, { agent, tier: tier || null })
   if (azure.enabled) console.log(AZURE_MCP_NOTICE)
-  console.log(`ancleto: .ancletorc actualizado en ${projectDir} (v${manifest.version})${azure.enabled ? ' (Azure habilitado)' : ' (Azure desactivado)'} (Agente: ${agent})${tier ? ` (Tier: ${tier})` : ''}`)
+  console.log(`ancleto: .ancletorc actualizado en ${projectDir} (v${manifest.version})${azure.enabled ? ' (Azure habilitado)' : ' (Azure desactivado)'} (Agente: ${agent})${tier ? ` (Tier: ${tier})` : ''} (Idioma: ${language})`)
 }
 
 const DEFAULT_IGNORES = ['node_modules', '.git', 'dist']
@@ -1041,9 +1127,11 @@ async function computeSources() {
 
 async function hashSources(sources) {
   const h = createHash('sha256')
+  const fileHashes = {}
   for (const rel of sources) {
     try {
       const content = await readFile(join(process.cwd(), rel))
+      fileHashes[rel] = createHash('sha256').update(content).digest('hex').slice(0, 16)
       h.update(rel)
       h.update('\0')
       h.update(String(content.length))
@@ -1052,7 +1140,71 @@ async function hashSources(sources) {
       h.update('\n')
     } catch {}
   }
-  return h.digest('hex')
+  return { hash: h.digest('hex'), fileHashes }
+}
+
+// Archivos cuyo cambio altera la arquitectura (configs de runtime, entry points).
+const MATERIAL_FILE_RES = [
+  /^package\.json$/,
+  /^tsconfig(\..+)?\.json$/,
+  /^jsconfig\.json$/,
+  /^(vite|webpack|rollup|next|nuxt|astro|svelte|tailwind)\.config\.[cm]?[jt]s$/,
+  /^docker-compose\.ya?ml$/,
+  /^Dockerfile$/,
+  /^index\.html$/,
+  /^src\/(main|index)\.[cm]?[jt]sx?$/
+]
+
+function isMaterialFile(rel) {
+  return MATERIAL_FILE_RES.some((re) => re.test(rel))
+}
+
+// Area = directorio de primer nivel; los archivos raiz son su propia area.
+function areaOf(rel) {
+  const i = rel.indexOf('/')
+  return i === -1 ? rel : rel.slice(0, i)
+}
+
+function computeImpact(stored, sources, fileHashes) {
+  const storedList = new Set(stored.sources || [])
+  const currentList = new Set(sources)
+  const storedFiles = stored.fileHashes || null
+  const changedAreas = new Set()
+  const materialReasons = []
+  const notes = []
+
+  for (const rel of sources) {
+    if (!storedList.has(rel)) {
+      changedAreas.add(areaOf(rel))
+      if (isMaterialFile(rel)) materialReasons.push(`archivo material nuevo: ${rel}`)
+    }
+  }
+  for (const rel of storedList) {
+    if (!currentList.has(rel)) {
+      changedAreas.add(areaOf(rel))
+      if (isMaterialFile(rel)) materialReasons.push(`archivo material eliminado: ${rel}`)
+    }
+  }
+  if (storedFiles) {
+    for (const rel of sources) {
+      if (storedFiles[rel] && storedFiles[rel] !== fileHashes[rel]) {
+        changedAreas.add(areaOf(rel))
+        if (isMaterialFile(rel)) materialReasons.push(`archivo material modificado: ${rel}`)
+      }
+    }
+  }
+
+  const storedAreas = new Set([...storedList].map(areaOf))
+  const currentAreas = new Set(sources.map(areaOf))
+  for (const a of currentAreas) if (!storedAreas.has(a)) materialReasons.push(`area raiz nueva: ${a}`)
+  for (const a of storedAreas) if (!currentAreas.has(a)) materialReasons.push(`area raiz eliminada: ${a}`)
+
+  if (!storedFiles && changedAreas.size === 0) {
+    notes.push('estado previo sin hashes por archivo: el cambio de contenido no se puede atribuir a un area')
+  }
+
+  const impact = materialReasons.length ? 'material' : changedAreas.size || notes.length ? 'minor' : 'none'
+  return { impact, changedAreas: [...changedAreas].sort(), materialReasons, notes }
 }
 
 function statePath(outputDir) {
@@ -1077,7 +1229,7 @@ async function checkDiscovery() {
   const { outputDir } = config
   const tier = readProjectTier(process.cwd())
   const present = await presentDocs(outputDir)
-  let state, action, message, missingDocs
+  let state, action, message, missingDocs, impact = 'none', changedAreas = [], materialReasons = [], notes = []
   if (present.length === 0) {
     state = 'MISSING'
     action = 'generate'
@@ -1090,35 +1242,50 @@ async function checkDiscovery() {
     message = `Faltan ${missingDocs.length} documentos del seed.`
   } else {
     const sources = await computeSources()
-    const hash = await hashSources(sources)
-    let storedHash = null
+    const { hash, fileHashes } = await hashSources(sources)
+    let stored = null
     const sp = statePath(outputDir)
     if (await exists(sp)) {
       try {
-        storedHash = JSON.parse((await readFile(sp, 'utf8')).replace(/^\uFEFF/, '')).hash
+        stored = JSON.parse((await readFile(sp, 'utf8')).replace(/^\uFEFF/, ''))
       } catch {}
     }
-    if (!storedHash) {
+    if (!stored?.hash) {
       state = 'STALE'
+      impact = 'material'
       action = 'regenerate'
       message = 'Seed completo pero sin estado registrado — frescura desconocida.'
-    } else if (storedHash === hash) {
+    } else if (stored.hash === hash) {
       state = 'READY'
       action = 'continue'
       message = 'El seed esta al dia.'
     } else {
+      const diff = computeImpact(stored, sources, fileHashes)
+      impact = diff.impact
+      changedAreas = diff.changedAreas
+      materialReasons = diff.materialReasons
+      notes = diff.notes
       state = 'STALE'
-      action = 'regenerate'
-      message = 'El repositorio cambio desde el ultimo pack.'
+      if (impact === 'material') {
+        action = 'regenerate'
+        message = 'El repositorio cambio en areas materiales (config/entry points/estructura).'
+      } else {
+        action = 'continue'
+        message = 'Cambios menores desde el ultimo pack; el seed sigue siendo util.'
+      }
     }
     missingDocs = []
   }
   console.log(JSON.stringify({
     schemaVersion: 2,
     state,
+    impact,
     recommendedAction: action,
     message,
     missingDocs,
+    changedAreas,
+    materialReasons,
+    notes,
     config: {
       outputDir,
       exclude: config.exclude,
@@ -1163,12 +1330,13 @@ async function packDiscovery(flags) {
     process.exit(1)
   }
   const sources = await computeSources()
-  const hash = await hashSources(sources)
+  const { hash, fileHashes } = await hashSources(sources)
   await mkdir(outputDir, { recursive: true })
   await writeFile(statePath(outputDir), JSON.stringify({
     version: 1,
     generatedAt: new Date().toISOString(),
     sources,
+    fileHashes,
     hash,
     packTokens: tokens
   }, null, 2) + '\n')

package/templates/AGENTS.md

@@ -71,9 +71,13 @@ comparte.
 - **Cambios con scope incierto / arquitectura**: Crear artifacts en `aspec/changes/<name>/`.
 - **Cambios menores / fixes**: Implementación directa.
 - **Cierre**: Archivar con `/cleto-archive` al finalizar.
+
+<!-- LOCKED: artifacts-language -->
 - **Idioma de los artifacts**: el contenido de `proposal.md`, `design.md`, `tasks.md` y `specs/` se escribe
-  en **inglés**. Los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED
-  Requirements`) son literales y **no se traducen**. Nombres de archivos y directorios: inglés kebab-case.
+  en el idioma de la conversación con el usuario (o en el `language` configurado en `.ancletorc`).
+  Los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`/`AND`, `ADDED/MODIFIED/REMOVED/RENAMED
+  Requirements`) y los nombres de archivos y directorios son literales en inglés y **no se traducen**.
+<!-- /LOCKED: artifacts-language -->
 
 ## Tools de Soporte