docs-alignment-update

Update docs, playbooks, shims, generated docs, and alignment checks so public instructions route to the right canonical sources.

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/clawic/Clawix --skill docs-alignment-update

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Run or change the macOS UX trace harness for action-to-visual-completion latency, scroll stability, fixture pressure, and baseline evidence.

Capture and compare Clawix UI performance budgets for critical flows before optimizing visible or runtime UI behavior.

Add or improve canonical data catalog collections, fields, aliases, relations, evidence tags, docs, and tests.

name	docs-alignment-update
description	Update docs, playbooks, shims, generated docs, and alignment checks so public instructions route to the right canonical sources.
keywords	["docs","alignment","agents","claude","decision-map","playbooks"]

Keep documentation aligned with behavior and routing.

Identify the canonical source for the changed behavior before editing docs.
Update public docs, README, playbooks, AGENTS.md, CLAUDE.md shims, generated docs, and decision maps only where they route to or explain that source.
For durable ADR or governance docs, keep the Decision Tension Rubric routed through the ADR template, decision map, and agent rules.
Keep AGENTS.md compact; link to skills or docs for procedures.
Add alignment-check snippets only for durable rules worth enforcing.
Register new durable docs routers, instruction shims, guardrails, harnesses, and skills in docs/discoverability.registry.json under docs/adr/0017-discoverability-and-meta-code-routing.md.
Remove stale duplicated instructions when a canonical doc or skill supersedes them.
For closure-gated docs, instruction, ADR, skill, route, storage, permission, or Clawix/ClawJS integration changes, run node scripts/discoverability-check.mjs closure --changed-file <path> --json. The closing report must cite the real claw search ... --json and claw inspect ... --json evidence and the discovered artifact, or mark the work PARTIAL/BLOCKED.
Run docs alignment/link checks or record why they cannot run.

Do not make CLAUDE.md a second instruction source.
Do not duplicate long ADR or playbook content inside AGENTS.md.
Public docs must not contain private paths, signing identities, or personal workflow instructions.
Do not close durable docs routing work as complete when CLI discovery cannot find and inspect the affected registered artifact.