@damenor/agent-docs 0.1.2 → 0.4.0

package/templates/modules/agents/.agents/skills/doc-maintain/references/triggers.md

@@ -1,101 +1,102 @@
 ---
-created: "2024-01-15"
+created: '2024-01-15'
 status: active
 type: reference
-tags: [triggers, mantenimiento, sincronizacion, documentacion]
+tags: [triggers, maintenance, synchronization, documentation]
 ---
 
-# Triggers — Referencia Completa
-
-## Tabla Maestra: Evento → Doc a Actualizar
-
-| Evento | Doc a actualizar | Prioridad | Cómo detectar |
-|--------|-----------------|-----------|---------------|
-| Feature nueva | CONTEXT.md, docs/README.md, reference/ | Crítica | Nuevo módulo/archivo en src/ |
-| Feature nueva con decisión arq. | docs/adr/ | Alta | Se discutió arquitectura |
-| Feature nueva con nuevo endpoint | reference/api.md | Crítica | Nuevo archivo en routes/ |
-| Feature nueva con UI nueva | DESIGN.md | Alta | Nuevo componente UI |
-| Release | CHANGELOG.md, docs/guides/deployment.md | Crítica | git tag creado |
-| Release con breaking change | CHANGELOG.md ⚠️, reference/api.md | Crítica | API cambió retrocompatibilidad |
-| Incidente | operations/post-mortems/, operations/runbooks/ | Crítica | Alerta resuelta, outage |
-| Incidente con fix aplicable | how-to/troubleshooting.md | Alta | Fix reusable |
-| Incidente con config cambiada | reference/configuration.md | Alta | .env o config cambió |
-| Refactor | CONTEXT.md, explanation/architecture.md | Alta | Archivos renombrados/movidos |
-| Refactor con cambio de patrón | docs/adr/ | Alta | Patrón de diseño cambió |
-| Refactor que invalida ADR | ADR existente → status: deprecated | Alta | ADR ya no aplica |
-| Nuevo dev en equipo | tutorials/quick-start.md | Crítica si falla | Dev reporta confusión |
-| Nuevo dev encuentra errores | Cualquier doc afectada | Alta | Dev reporta info incorrecta |
-| Cambio de estilos/tokens | DESIGN.md | Crítica | CSS/theme cambió |
-| Cambio de estilos con nuevo componente | DESIGN.md (components) | Alta | Nuevo componente UI |
-| Nuevo endpoint | reference/api.md | Crítica | Nuevo archivo en routes/ |
-| Endpoint eliminado | reference/api.md | Crítica | Archivo eliminado de routes/ |
-| Endpoint modificado | reference/api.md | Crítica | Params/respuesta cambiaron |
-| Variable de entorno nueva | reference/configuration.md | Crítica | .env.example cambió |
-| Config eliminada | reference/configuration.md | Crítica | .env.example cambió |
-| Config con nuevo default | reference/configuration.md | Alta | Default cambió en código |
-| Término nuevo en dominio | CONTEXT.md | Crítica | Nuevo concepto en código |
-| Término eliminado | CONTEXT.md | Media | Concepto ya no existe |
-| Archivo de doc creado | docs/README.md | Crítica | Nuevo .md en docs/ |
-| Archivo de doc eliminado | docs/README.md | Crítica | .md eliminado de docs/ |
-| Dependencia agregada | docs/adr/ si es significativa | Alta | package.json cambió |
-| Dependencia eliminada | reference/ si aplica | Media | package.json cambió |
-| Dependencia con major upgrade | CHANGELOG.md, reference/ | Alta | package.json versión major↑ |
-| Schema de DB cambió | reference/database.md | Alta | Migración creada |
-| Nuevo evento/mensaje | reference/events.md | Alta | Nuevo tipo de evento |
-| Error nuevo con código | reference/errors.md | Alta | Nuevo código de error |
-| Proceso de deploy cambió | docs/guides/deployment.md | Crítica | CI/CD config cambió |
+# Triggers — Complete Reference
+
+## Master Table: Event → Doc to Update
+
+| Event                           | Doc to update                                  | Priority          | How to detect                    |
+| ------------------------------- | ---------------------------------------------- | ----------------- | -------------------------------- |
+| New feature                     | CONTEXT.md, docs/README.md, reference/         | Critical          | New module/file in src/          |
+| New feature with arq. decision  | docs/adr/                                      | High              | Architecture was discussed       |
+| New feature with new endpoint   | reference/api.md                               | Critical          | New file in routes/              |
+| New feature with new UI         | DESIGN.md                                      | High              | New UI component                 |
+| Release                         | CHANGELOG.md, docs/guides/deployment.md        | Critical          | git tag created                  |
+| Release with breaking change    | CHANGELOG.md ⚠️, reference/api.md              | Critical          | API broke backward compatibility |
+| Incident                        | operations/post-mortems/, operations/runbooks/ | Critical          | Alert resolved, outage           |
+| Incident with applicable fix    | how-to/troubleshooting.md                      | High              | Reusable fix                     |
+| Incident with changed config    | reference/configuration.md                     | High              | .env or config changed           |
+| Refactor                        | CONTEXT.md, explanation/architecture.md        | High              | Files renamed/moved              |
+| Refactor with pattern change    | docs/adr/                                      | High              | Design pattern changed           |
+| Refactor invalidating ADR       | Existing ADR → status: deprecated              | High              | ADR no longer applies            |
+| New dev on team                 | tutorials/quick-start.md                       | Critical if fails | Dev reports confusion            |
+| New dev finds errors            | Any affected doc                               | High              | Dev reports incorrect info       |
+| Style/token change              | DESIGN.md                                      | Critical          | CSS/theme changed                |
+| Style change with new component | DESIGN.md (components)                         | High              | New UI component                 |
+| New endpoint                    | reference/api.md                               | Critical          | New file in routes/              |
+| Endpoint removed                | reference/api.md                               | Critical          | File removed from routes/        |
+| Endpoint modified               | reference/api.md                               | Critical          | Params/response changed          |
+| New env variable                | reference/configuration.md                     | Critical          | .env.example changed             |
+| Config removed                  | reference/configuration.md                     | Critical          | .env.example changed             |
+| Config with new default         | reference/configuration.md                     | High              | Default changed in code          |
+| New domain term                 | CONTEXT.md                                     | Critical          | New concept in code              |
+| Term removed                    | CONTEXT.md                                     | Medium            | Concept no longer exists         |
+| Doc file created                | docs/README.md                                 | Critical          | New .md in docs/                 |
+| Doc file deleted                | docs/README.md                                 | Critical          | .md deleted from docs/           |
+| Dependency added                | docs/adr/ if significant                       | High              | package.json changed             |
+| Dependency removed              | reference/ if applicable                       | Medium            | package.json changed             |
+| Dependency major upgrade        | CHANGELOG.md, reference/                       | High              | package.json version major↑      |
+| DB schema changed               | reference/database.md                          | High              | Migration created                |
+| New event/message               | reference/events.md                            | High              | New event type                   |
+| New error with code             | reference/errors.md                            | High              | New error code                   |
+| Deploy process changed          | docs/guides/deployment.md                      | Critical          | CI/CD config changed             |
 
 ---
 
-## Niveles de Prioridad
+## Priority Levels
 
-### 🔴 Crítica — Actualizar inmediatamente
+### 🔴 Critical — Update immediately
 
-La documentación incorrecta causa problemas reales:
+Incorrect documentation causes real problems:
 
-- **Sin reference/api.md actualizada** → Integradores usan endpoints incorrectos
-- **Sin CHANGELOG** → No se sabe qué cambió entre versiones
-- **CONTEXT.md incorrecto** → Términos ambiguos causan bugs de comunicación
-- **DESIGN.md desincronizado** → Inconsistencias visuales en producción
-- **configuration.md desactualizada** → Deploy con variables incorrectas
-- **Post-mortem no escrito** → Se repite el mismo incidente
+- **Outdated reference/api.md** → Integrators use wrong endpoints
+- **No CHANGELOG** → Unknown changes between versions
+- **Incorrect CONTEXT.md** → Ambiguous terms cause communication bugs
+- **DESYNCED DESIGN.md** → Visual inconsistencies in production
+- **Outdated configuration.md** → Deploy with wrong variables
+- **Missing post-mortem** → Same incident repeats
 
-**Tiempo esperado**: Actualizar dentro de la misma tarea/PR.
+**Expected time**: Update within the same task/PR.
 
-### 🟡 Alta — Actualizar esta semana
+### 🟡 High — Update this week
 
-La documentación faltante causa fricción pero no rompe nada:
+Missing documentation causes friction but doesn't break anything:
 
-- **ADR faltante** → Decisiones sin contexto para nuevos devs
-- **How-to faltante** → Preguntas repetitivas al equipo
-- **Explanation faltante** → Confusión sobre decisiones pasadas
-- **Tutorial desactualizado** → Onboarding más lento
+- **Missing ADR** → Decisions without context for new devs
+- **Missing how-to** → Repetitive questions to the team
+- **Missing explanation** → Confusion about past decisions
+- **Outdated tutorial** → Slower onboarding
 
-**Tiempo esperado**: Actualizar dentro del sprint.
+**Expected time**: Update within the sprint.
 
-### 🟢 Media — Actualizar cuando sea posible
+### 🟢 Medium — Update when possible
 
-La documentación podría mejorarse pero no es urgente:
+Documentation could be improved but isn't urgent:
 
-- **Término en CONTEXT.md que ya no aplica** → Limpieza
-- **Ejemplo que podría ser mejor** → Mejora incremental
-- **Referencia cruzada faltante** → Navegación más fácil
+- **CONTEXT.md term that no longer applies** → Cleanup
+- **Example that could be better** → Incremental improvement
+- **Missing cross-reference** → Easier navigation
 
-**Tiempo esperado**: Backlog, hacer cuando haya tiempo.
+**Expected time**: Backlog, do when there's time.
 
 ---
 
-## Ejemplos por Trigger
+## Examples by Trigger
 
-### Ejemplo 1: Post-feature — Nuevo módulo de notificaciones
+### Example 1: Post-feature — New notifications module
+
+**Code changes**:
 
-**Cambios en código**:
 ```
 src/notifications/
-├── notification.service.ts    (nuevo)
-├── notification.controller.ts (nuevo)
-├── templates/                 (nuevo)
-└── events/                    (nuevo)
+├── notification.service.ts    (new)
+├── notification.controller.ts (new)
+├── templates/                 (new)
+└── events/                    (new)
 ```
 
 **Docs a actualizar**:
@@ -122,190 +123,195 @@ src/notifications/
 5. ¿ADR necesario? → Solo si la implementación implica una decisión arquitectónica
 ```
 
-### Ejemplo 2: Post-release — v2.1.0
+### Example 2: Post-release — v2.1.0
 
-**Qué cambió**:
-- 3 features nuevas
-- 2 bugs corregidos
-- 1 breaking change en API
+**What changed**:
 
-**Docs a actualizar**:
+- 3 new features
+- 2 bugs fixed
+- 1 breaking change in API
+
+**Docs to update**:
 
 ```markdown
-1. CHANGELOG.md → Agregar entrada:
+1. CHANGELOG.md → Add entry:
 
 ## [2.1.0] - 2024-03-15
 
 ### Added
-- Módulo de notificaciones
-- Exportación a CSV
-- Filtros avanzados en búsqueda
+
+- Notifications module
+- CSV export
+- Advanced search filters
 
 ### Changed
-- El endpoint /api/users ahora retorna `avatarUrl` en vez de `avatar`
+
+- /api/users endpoint now returns `avatarUrl` instead of `avatar`
 
 ### Fixed
-- Timeout en queries de reportes grandes
-- Error 500 al crear usuario sin email
+
+- Timeout in large report queries
+- Error 500 when creating user without email
 
 ### Breaking ⚠️
-- GET /api/users: campo `avatar` renombrado a `avatarUrl`
 
-2. reference/api.md → Actualizar campo renombrado
+- GET /api/users: field `avatar` renamed to `avatarUrl`
 
-3. docs/guides/deployment.md → Solo si cambió el proceso de deploy
+2. reference/api.md → Update renamed field
+
+3. docs/guides/deployment.md → Only if deployment process changed
 ```
 
-### Ejemplo 3: Post-incident — Timeout en base de datos
+### Example 3: Post-incident — Database timeout
 
-**Qué pasó**: La app estuvo caída 30 minutos por queries sin timeout
+**What happened**: App was down for 30 minutes due to queries without timeout
 
-**Docs a actualizar**:
+**Docs to update**:
 
 ```markdown
-1. operations/post-mortems/2024-03-15-db-timeout.md → Crear post-mortem completo
+1. operations/post-mortems/2024-03-15-db-timeout.md → Create full post-mortem
 
-2. reference/configuration.md → Agregar:
-   - DB_QUERY_TIMEOUT: Timeout máximo para queries (default: 30s)
+2. reference/configuration.md → Add:
+   - DB_QUERY_TIMEOUT: Max query timeout (default: 30s)
 
-3. how-to/troubleshooting.md → Agregar:
-   - "Cómo diagnosticar timeouts de base de datos"
+3. how-to/troubleshooting.md → Add:
+   - "How to diagnose database timeouts"
 
-4. operations/runbooks/database-timeout.md → Crear runbook si no existe
+4. operations/runbooks/database-timeout.md → Create runbook if it doesn't exist
 ```
 
-### Ejemplo 4: Post-refactor — Renombrar UserService a AccountService
+### Example 4: Post-refactor — Rename UserService to AccountService
 
-**Qué cambió**: Se renombró la clase y se movió de carpeta
+**What changed**: Class was renamed and moved to a different folder
 
-**Docs a actualizar**:
+**Docs to update**:
 
 ```markdown
-1. docs/CONTEXT.md → Actualizar:
-   - UserService → AccountService (renombrado)
-   - Marcar UserService como deprecated si hay referencia externa
+1. docs/CONTEXT.md → Update:
+   - UserService → AccountService (renamed)
+   - Mark UserService as deprecated if there are external references
 
-2. docs/explanation/architecture.md → Actualizar diagramas/referencias
+2. docs/explanation/architecture.md → Update diagrams/references
 
-3. reference/api.md → Verificar si endpoints cambiaron de nombre
+3. reference/api.md → Check if endpoints were renamed
 
-4. docs/adr/ → ¿El refactor merece un ADR? Solo si cambió el patrón
+4. docs/adr/ → Does the refactor deserve an ADR? Only if the pattern changed
 ```
 
-### Ejemplo 5: Post-design-change — Nuevo sistema de colores
+### Example 5: Post-design-change — New color system
 
-**Qué cambió**: Se actualizó la paleta de colores en Tailwind config
+**What changed**: Color palette was updated in Tailwind config
 
-**Docs a actualizar**:
+**Docs to update**:
 
 ```markdown
-1. DESIGN.md → Usar skill doc-design para:
-   - Re-extraer colores de Tailwind config
-   - Actualizar sección colors en frontmatter
-   - Verificar que los tokens de componentes siguen siendo válidos
+1. DESIGN.md → Use doc-design skill to:
+   - Re-extract colors from Tailwind config
+   - Update colors section in frontmatter
+   - Verify component tokens are still valid
 
-2. docs/CONTEXT.md → Si hay nuevos términos de diseño
+2. docs/CONTEXT.md → If there are new design terms
 
-3. CHANGELOG.md → Si el cambio es visible para usuarios
+3. CHANGELOG.md → If the change is visible to users
 ```
 
-### Ejemplo 6: Post-API-change — Nuevo endpoint de búsqueda
+### Example 6: Post-API-change — New search endpoint
 
-**Qué cambió**: Se agregó GET /api/search con query params
+**What changed**: GET /api/search was added with query params
 
-**Docs a actualizar**:
+**Docs to update**:
 
 ```markdown
-1. reference/api.md → Agregar:
+1. reference/api.md → Add:
 
 ### GET /api/search
 
-| Parámetro | Tipo | Requerido | Descripción |
-|-----------|------|-----------|-------------|
-| q | string | Sí | Término de búsqueda |
-| limit | number | No | Resultados máximos (default: 20) |
-| offset | number | No | Paginación (default: 0) |
-| type | string | No | Filtrar por tipo (user, post, comment) |
+| Parameter | Type   | Required | Description                          |
+| --------- | ------ | -------- | ------------------------------------ |
+| q         | string | Yes      | Search term                          |
+| limit     | number | No       | Max results (default: 20)            |
+| offset    | number | No       | Pagination (default: 0)              |
+| type      | string | No       | Filter by type (user, post, comment) |
 
-2. docs/CONTEXT.md → Si hay términos nuevos (ej: SearchIndex, QueryParser)
+2. docs/CONTEXT.md → If there are new terms (e.g.: SearchIndex, QueryParser)
 
-3. how-to/ → Si hay un flujo de uso común que documentar
+3. how-to/ → If there's a common usage flow to document
 ```
 
 ---
 
-## Cómo Detectar Qué Cambió
+## How to Detect What Changed
 
-### Por tipo de archivo
+### By file type
 
-| Archivo cambió | Qué verificar | Docs afectadas |
-|---------------|---------------|----------------|
-| `src/**/*.ts` | Nuevas clases, funciones, interfaces | CONTEXT.md, reference/ |
-| `src/routes/**` | Nuevos/modified endpoints | reference/api.md |
-| `src/components/**` | Nuevos/modified componentes | DESIGN.md |
-| `*.css`, `tailwind.config.*` | Tokens de diseño | DESIGN.md |
-| `.env*`, `config/*` | Variables de configuración | reference/configuration.md |
-| `migrations/**` | Cambios en schema | reference/database.md |
-| `docker-compose.*`, `Dockerfile*` | Cambios de infra | deployment.md |
-| `package.json` | Dependencias nuevas/eliminadas | docs/adr/ si es significativa |
-| `*.test.*` | Generalmente no afecta docs | — |
-| `docs/**` | Ya es doc → verificar docs/README.md | docs/README.md |
+| File changed                      | What to check                      | Affected docs              |
+| --------------------------------- | ---------------------------------- | -------------------------- |
+| `src/**/*.ts`                     | New classes, functions, interfaces | CONTEXT.md, reference/     |
+| `src/routes/**`                   | New/modified endpoints             | reference/api.md           |
+| `src/components/**`               | New/modified components            | DESIGN.md                  |
+| `*.css`, `tailwind.config.*`      | Design tokens                      | DESIGN.md                  |
+| `.env*`, `config/*`               | Configuration variables            | reference/configuration.md |
+| `migrations/**`                   | Schema changes                     | reference/database.md      |
+| `docker-compose.*`, `Dockerfile*` | Infrastructure changes             | deployment.md              |
+| `package.json`                    | New/removed dependencies           | docs/adr/ if significant   |
+| `*.test.*`                        | Generally doesn't affect docs      | —                          |
+| `docs/**`                         | Already doc → check docs/README.md | docs/README.md             |
 
-### Por comando git
+### By git command
 
 ```bash
-# Ver qué archivos cambiaron
+# See what files changed
 git diff --name-only HEAD~1 HEAD
 
-# Ver solo archivos de código (no docs)
+# See only code files (not docs)
 git diff --name-only HEAD~1 HEAD -- ':(exclude)docs/' ':(exclude)*.md'
 
-# Ver cambios en estilos
+# See style changes
 git diff --name-only HEAD~1 HEAD -- '*.css' 'tailwind.config.*' '*.scss'
 
-# Ver cambios en rutas/API
+# See route/API changes
 git diff --name-only HEAD~1 HEAD -- 'src/routes/' 'src/controllers/'
 
-# Ver cambios en config
+# See config changes
 git diff --name-only HEAD~1 HEAD -- '.env*' 'config/' 'docker-compose.*'
 ```
 
 ---
 
-## Patrones de Actualización por Lotes
+## Batch Update Patterns
 
-### Fin de sprint
+### End of sprint
 
 ```
 1. git diff --name-only sprint-start..sprint-end
-2. Agrupar por tipo: features, fixes, refactors, config
-3. Para cada grupo, aplicar los triggers correspondientes
-4. Actualizar CHANGELOG.md con TODO lo del sprint
-5. Ejecutar doc-review al final
+2. Group by type: features, fixes, refactors, config
+3. For each group, apply the corresponding triggers
+4. Update CHANGELOG.md with EVERYTHING from the sprint
+5. Run doc-review at the end
 ```
 
-### Post-merge de múltiples PRs
+### Post-merge of multiple PRs
 
 ```
-1. Listar PRs mergeados desde la última actualización
-2. Para cada PR, identificar el trigger
-3. Acumular cambios por doc afectada
-4. Actualizar cada doc UNA VEZ con todos los cambios
-5. No actualizar el mismo doc múltiples veces
+1. List PRs merged since last update
+2. For each PR, identify the trigger
+3. Accumulate changes by affected doc
+4. Update each doc ONCE with all changes
+5. Don't update the same doc multiple times
 ```
 
-### Hotfix en producción
+### Hotfix in production
 
 ```
-1. El hotfix es prioridad CRÍTICA
-2. Actualizar CHANGELOG.md inmediatamente
-3. Actualizar reference/ si afecta API
-4. Crear post-mortem si fue incidente
+1. The hotfix is CRITICAL priority
+2. Update CHANGELOG.md immediately
+3. Update reference/ if it affects API
+4. Create post-mortem if it was an incident
 5. doc-review post-hotfix
 ```
 
 ---
 
-## Regla de Oro
+## Golden Rule
 
-**Si cambiaste código, cambiaste documentación. Si no actualizaste la documentación, la tarea no está terminada.**
+**If you changed code, you changed documentation. If you didn't update the documentation, the task is not done.**

package/templates/modules/agents/.agents/skills/doc-review/SKILL.md

@@ -10,7 +10,7 @@ description: >
 license: Apache-2.0
 metadata:
   author: damenordev
-  version: "1.0"
+  version: '1.0'
 ---
 
 # doc-review
@@ -29,13 +29,13 @@ metadata:
 
 It's not enough to ask "does the file exist?". Check:
 
-| Issue | What to look for |
-|-------|------------------|
-| Empty docs | Files with only frontmatter and title |
-| Stale docs | Files without `last-reviewed` in >3 months |
-| TODO/TBD | Search for `TODO`, `TBD`, `FIXME`, `PENDING` in content |
-| Placeholder | Search for "pending content", "add here", empty sections |
-| Broken wikilinks | `[[link]]` that doesn't resolve to an existing file |
+| Issue            | What to look for                                         |
+| ---------------- | -------------------------------------------------------- |
+| Empty docs       | Files with only frontmatter and title                    |
+| Stale docs       | Files without `last-reviewed` in >3 months               |
+| TODO/TBD         | Search for `TODO`, `TBD`, `FIXME`, `PENDING` in content  |
+| Placeholder      | Search for "pending content", "add here", empty sections |
+| Broken wikilinks | `[[link]]` that doesn't resolve to an existing file      |
 
 ### RULE #2: Validate Diátaxis coverage
 
@@ -90,6 +90,7 @@ If an entire quadrant is missing, it is a CRITICAL gap.
 ### 1. Completeness
 
 **What to check**:
+
 - Documentation files that should exist but don't
 - Empty sections within existing files
 - Code features without corresponding documentation
@@ -105,6 +106,7 @@ If an entire quadrant is missing, it is a CRITICAL gap.
 ### 2. Currency
 
 **What to check**:
+
 - Files not updated in >3 months (check if relevant code changed)
 - References to obsolete versions/libraries
 - CHANGELOG.md outdated vs git tags
@@ -120,6 +122,7 @@ If an entire quadrant is missing, it is a CRITICAL gap.
 ### 3. Consistency
 
 **What to check**:
+
 - CONTEXT.md vs code: terms match
 - DESIGN.md vs styles: tokens match
 - ADRs vs implementation: what the ADR says is what's in code
@@ -137,6 +140,7 @@ If an entire quadrant is missing, it is a CRITICAL gap.
 ### 4. Coverage
 
 **What to check**:
+
 - Diátaxis: all 4 quadrants are covered
 - Features: each public feature has at least one associated doc
 - API: all endpoints are documented
@@ -153,6 +157,7 @@ If an entire quadrant is missing, it is a CRITICAL gap.
 ### 5. Quality
 
 **What to check**:
+
 - Real content vs placeholder (no TODO, no "pending")
 - Clear and correct writing
 - Runnable examples in tutorials/how-tos
@@ -176,12 +181,12 @@ Total score = Completeness (30) + Currency (20) + Consistency (20) + Coverage (2
 
 ### Scale
 
-| Score | Status | Action |
-|-------|--------|--------|
-| 90-100 | 🟢 Healthy | Maintain, periodic review |
-| 70-89 | 🟡 Acceptable | Prioritized improvements identified |
-| 50-69 | 🟠 Deficient | Requires significant work |
-| 0-49 | 🔴 Critical | Fundamental documentation missing |
+| Score  | Status        | Action                              |
+| ------ | ------------- | ----------------------------------- |
+| 90-100 | 🟢 Healthy    | Maintain, periodic review           |
+| 70-89  | 🟡 Acceptable | Prioritized improvements identified |
+| 50-69  | 🟠 Deficient  | Requires significant work           |
+| 0-49   | 🔴 Critical   | Fundamental documentation missing   |
 
 ## Report Format
 
@@ -194,14 +199,14 @@ Total score = Completeness (30) + Currency (20) + Consistency (20) + Coverage (2
 
 ## Summary by Dimension
 
-| Dimension | Score | Maximum |
-|-----------|-------|---------|
-| Completeness | 22 | 30 |
-| Currency | 15 | 20 |
-| Consistency | 14 | 20 |
-| Coverage | 12 | 20 |
-| Quality | 9 | 10 |
-| **Total** | **72** | **100** |
+| Dimension    | Score  | Maximum |
+| ------------ | ------ | ------- |
+| Completeness | 22     | 30      |
+| Currency     | 15     | 20      |
+| Consistency  | 14     | 20      |
+| Coverage     | 12     | 20      |
+| Quality      | 9      | 10      |
+| **Total**    | **72** | **100** |
 
 ## Critical Issues 🔴
 
@@ -222,18 +227,18 @@ Total score = Completeness (30) + Currency (20) + Consistency (20) + Coverage (2
 
 ## Detail by File
 
-| File | Status | Issues |
-|------|--------|--------|
-| README.md | ✅ OK | — |
-| CHANGELOG.md | ⚠️ Outdated | Missing release 2.1.0 |
-| docs/CONTEXT.md | ⚠️ Incomplete | 5 terms missing |
-| docs/DESIGN.md | 🔴 Out of sync | 3 tokens don't match |
-| docs/README.md | ✅ OK | — |
-| reference/api.md | 🔴 Missing | Does not exist |
-| tutorials/ | ✅ OK | — |
-| how-to/ | ⚠️ Empty | No content |
-| explanation/ | ✅ OK | — |
-| docs/adr/ | ⚠️ Incomplete | 3 ADRs without status |
+| File             | Status         | Issues                |
+| ---------------- | -------------- | --------------------- |
+| README.md        | ✅ OK          | —                     |
+| CHANGELOG.md     | ⚠️ Outdated    | Missing release 2.1.0 |
+| docs/CONTEXT.md  | ⚠️ Incomplete  | 5 terms missing       |
+| docs/DESIGN.md   | 🔴 Out of sync | 3 tokens don't match  |
+| docs/README.md   | ✅ OK          | —                     |
+| reference/api.md | 🔴 Missing     | Does not exist        |
+| tutorials/       | ✅ OK          | —                     |
+| how-to/          | ⚠️ Empty       | No content            |
+| explanation/     | ✅ OK          | —                     |
+| docs/adr/        | ⚠️ Incomplete  | 3 ADRs without status |
 ```
 
 ## Review Process