@ancleto/spec 0.6.33 → 0.6.35

package/README.md

@@ -200,6 +200,32 @@ 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.
+
+### Regeneración parcial
+
+`--check` también devuelve `affectedDocs`: los documentos del seed cuyas áreas cambiaron. Cuando aprobás una regeneración sobre un reporte `minor`, el seed-writer **reescribe solo esos documentos** y deja el resto intacto (un solo pack igual, pero sin reescribir los 8 documentos + dossiers). El mapeo vive en `seed-map.json` dentro del directorio del seed y lo mantiene la skill al generar; sin ese archivo el chequeo degrada a lista vacía y la regeneración es completa.
+
 ---
 
 ## Uso rápido
@@ -237,10 +263,10 @@ ancleto discovery         # Genera .discovery-map.json y empaqueta el repo
 ## Referencia de comandos CLI
 
 ```bash
-ancleto init [--agent <nombre>] [--tier <nivel>] [--lang <codigo>] [--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>] [--lang <codigo>] [--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/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. When the report lists `affectedDocs`, pass them so an approved regeneration stays scoped to those documents.
 
 `@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.
 
@@ -269,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/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 `affectedDocs`, 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/agents/technical-seed-writer.md

@@ -45,11 +45,11 @@ action was explicitly requested, run `ancleto discovery --check` once and read i
 1. For `READY`, do not rewrite the seed; report that it is already available.
 2. For `MISSING`, `PARTIAL`, or an accepted `STALE` regeneration, execute the skill's single global Repomix command exactly once. It must use the resolved `config.exclude` values and
    must not run `--include`, an uncompressed preliminary pack, or another compressed pack.
-3. Read that pack and immediately write every required seed document in Spanish under
-   `config.outputDir`, including `units/_map.md`. Use the same pack for any optional dossier.
-4. Run `ancleto discovery --check` once to validate the written seed. This is state-only: do
+3. Read that pack and write the seed documents under `config.outputDir`, including `units/_map.md`. When the passed report has `impact: minor` with a non-empty `affectedDocs` list, rewrite ONLY those documents and leave every other seed document untouched. Otherwise (full regeneration), write every required seed document. Use the same pack for any optional dossier.
+4. Write `seed-map.json` in `config.outputDir` mapping every seed document to the source areas it draws evidence from. Areas are first-level directories (or root file names), the same convention the CLI uses. Example: `{ "version": 1, "generatedAt": "...", "docs": { "overview.md": ["src", "package.json"] } }`.
+5. Run `ancleto discovery --check` once to validate the written seed. This is state-only: do
    not generate another pack after it.
-5. Return the result as specified in `## Output`.
+6. Return the result as specified in `## Output`.
 
 If the pack fails, writing fails, or the final state is not usable, report the exact blocker;
 do not claim the seed was generated.

package/package.json

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

package/skills/ancleto-archive/SKILL.md

@@ -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-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-technical-discovery/references/generation-pipeline.md

@@ -51,6 +51,11 @@ do not split it or create child documents.
 
 Run `ancleto discovery --check` once more and apply `validation-checklist.md`. This is a
 state-only validation; it must not be followed by another Repomix command. For stale nodes,
-regenerate only the affected documents using one new global generation on a later request.
+regenerate only the affected documents using one new global generation on a later request:
+when the check report lists `affectedDocs`, those are the only documents to rewrite.
 If a unit has no dossier, update its row in `units/_map.md` and only the root documents whose
 content changed.
+
+After any generation, write `seed-map.json` in `config.outputDir` mapping every seed document
+to the source areas (first-level directories or root file names) it draws evidence from, so a
+later `--check` can scope the next regeneration.

package/skills/ancleto-technical-discovery/references/validation-checklist.md

@@ -9,4 +9,5 @@
 - [ ] `decisions.md` concentrates rules, risks, and coupling without duplicating the overview.
 - [ ] `inventory.md` declares directories or globs, not file lists.
 - [ ] `unknowns.md` records what could not be verified.
+- [ ] `seed-map.json` exists and maps each seed document to its source areas.
 - [ ] No secret values are present.

package/src/cli/index.js

@@ -33,12 +33,13 @@ Uso:
   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>] [--lang <codigo>]
+  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)
@@ -639,6 +640,47 @@ 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
@@ -838,9 +880,12 @@ async function install(args) {
 
   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 || !language)
+  const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier || !language || (projectDir && excludeChoice === null && (existingDiscovery.exclude || []).length === 0))
   if (isInteractive) {
     await showBanner()
     bannerShown = true
@@ -855,6 +900,9 @@ async function install(args) {
       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'
@@ -886,6 +934,7 @@ async function install(args) {
     await writeManifest(projectDir, {
       agent,
       language,
+      ...(excludeChoice !== null ? { discovery: { ...existingDiscovery, exclude: excludeChoice } } : {}),
       ...(gratisModelChoice ? { gratisModel: gratisModelChoice } : {}),
       installedPaths: {
         templates: ['AGENTS.md', 'PRODUCT.md'],
@@ -969,12 +1018,14 @@ async function initProject(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, language
   language = langFlag || (existing?.language && SUPPORTED_LANGS.includes(existing.language) ? existing.language : null)
-  const isInteractive = Boolean(process.stdout.isTTY) && (!agentFlag || !tierFlag || !language)
+  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))
@@ -986,6 +1037,9 @@ async function initProject(args) {
       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 {
@@ -998,6 +1052,7 @@ async function initProject(args) {
     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 })
@@ -1072,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))
@@ -1083,7 +1140,93 @@ 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 }
+}
+
+// seed-map.json lo escribe la skill al generar: cada documento → areas de
+// primer nivel (o archivos raiz) de las que saco evidencia. Misma convencion que areaOf.
+async function readSeedMap(outputDir) {
+  try {
+    const raw = await readFile(join(outputDir, 'seed-map.json'), 'utf8')
+    const parsed = JSON.parse(raw.replace(/^\uFEFF/, ''))
+    if (!parsed || typeof parsed.docs !== 'object' || parsed.docs === null) return null
+    return parsed.docs
+  } catch {
+    return null
+  }
+}
+
+function affectedDocsFor(seedMap, changedAreas) {
+  if (!seedMap || !changedAreas.length) return []
+  const out = new Set()
+  for (const [doc, areas] of Object.entries(seedMap)) {
+    if (Array.isArray(areas) && areas.some((a) => changedAreas.includes(a))) out.add(doc)
+  }
+  return [...out].sort()
 }
 
 function statePath(outputDir) {
@@ -1108,7 +1251,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 = [], affectedDocs = [], seedMapPresent = false
   if (present.length === 0) {
     state = 'MISSING'
     action = 'generate'
@@ -1121,35 +1264,55 @@ 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
+      const seedMap = await readSeedMap(outputDir)
+      seedMapPresent = seedMap !== null
+      affectedDocs = affectedDocsFor(seedMap, changedAreas)
       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,
+    affectedDocs,
+    seedMapPresent,
     config: {
       outputDir,
       exclude: config.exclude,
@@ -1194,12 +1357,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')