adminoryslabs/armory

audit-agent-context

Audita si AGENTS.md y/o CLAUDE.md del repo actual siguen reflejando la realidad del proyecto (estructura, comandos, convenciones, alcance) y reporta discrepancias sin editarlos.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/adminoryslabs/armory --skill audit-agent-context

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

Audit Agent Context — Auditar AGENTS.md / CLAUDE.md contra la realidad del repo

Goal

Detectar y reportar — nunca corregir en automático — discrepancias entre lo que declaran AGENTS.md y/o CLAUDE.md del proyecto y el estado real del repositorio: estructura de carpetas, comandos, stack, convenciones de nombres, alcance declarado y reglas de coordinación multi-agente. La skill entrega un reporte clasificado; las ediciones las decide y aplica el usuario en un paso posterior y explícito.

Cuándo se dispara

  • El usuario ejecuta /audit-agent-context.
  • Pide cosas como "revisá si el AGENTS.md sigue siendo verdad", "actualizá el contexto de

agentes", "¿el CLAUDE.md quedó desactualizado?", o equivalentes.

Input

Ninguno obligatorio. Opcionalmente, una ruta de proyecto distinta al cwd (por ejemplo si se está auditando un subproyecto o un worktree).

Workflow

  1. Resolver alcance.
  • Raíz de proyecto: git rev-parse --show-toplevel (si falla, usar el cwd).
  • Localizar todos los AGENTS.md y CLAUDE.md relevantes: raíz del repo, cwd si es

distinto, y cualquiera anidado en subcarpetas de trabajo declaradas. No asumir que solo hay uno de cada uno — puede haber pares en más de un nivel.

  1. Extraer afirmaciones verificables de cada archivo encontrado, sin reescribirlas. Buscar

específicamente:

  • Rutas y nombres de archivo/carpeta mencionados (¿existen? ¿siguen ahí?).
  • Comandos citados (build, lint, test, gentle-ai ..., herdr ..., etc.) — ¿el

binario/script referenciado existe o es invocable?

  • Afirmaciones negativas ("no hay código", "no hay package.json", "no hay tests") — ¿siguen

siendo ciertas?

  • Convenciones de nombres/estructura declaradas (ej. HU-0X-<slug>.md,

PLAYBOOK-<ROL>.md) — ¿los archivos reales las cumplen?

  • Alcance declarado (qué carpetas cubre ese AGENTS.md/CLAUDE.md) vs. la ubicación real del

archivo en el árbol.

  • Reglas de coordinación multi-agente (rutas de playbooks, nombres de skills, comandos de

invocación).

  1. Verificar cada afirmación contra el repo real.
  • Usar Glob/Grep/Read para estructura y contenido; git ls-files / git status para lo

trackeado vs. lo sin trackear.

  • Si el repo tiene código y hay CodeGraph disponible, preferirlo para preguntas de

arquitectura real antes de un grep amplio (regla ya vigente a nivel global para preguntas estructurales).

  • Para comandos, verificar que el binario/skill exista (.claude/skills, .agents/skills,

scripts de package.json, etc.) — no ejecutar comandos con efectos secundarios solo para "probar" que funcionan.

  1. Clasificar cada afirmación para el reporte final:
  • ✅ Vigente — coincide con la realidad.
  • ⚠️ Desactualizada — contradice el estado real (citar evidencia: qué dice el archivo vs.

qué se encontró).

  • ❓ No verificable automáticamente — requiere confirmación humana (ej. decisiones de

negocio o de alcance futuro).

  • 🆕 No documentada — el repo tiene algo (carpeta, convención, skill, playbook) que ningún

AGENTS.md/CLAUDE.md menciona.

  1. Entregar el reporte agrupado por archivo auditado (si hay más de uno). Cada ítem incluye:

afirmación textual citada, evidencia encontrada y clasificación. Cerrar con una lista de cambios sugeridos, redactados como propuestas puntuales (no aplicadas), para que el usuario decida cuáles llevar al archivo.

Reglas no negociables

  • Nunca editar `AGENTS.md`/`CLAUDE.md` dentro de esta skill. Aplicar las correcciones es un

paso posterior y explícito, fuera del alcance de esta auditoría.

  • Nunca asumir intención no confirmada. Si una afirmación es ambigua o depende de una

decisión de negocio/equipo, se marca ❓, no se resuelve por conjetura.

  • Si el proyecto auditado tiene sus propias reglas de dominio (por ejemplo, "Puntos Abiertos" o

"Alcance — No incluye" como en este mismo test-project), esta skill se somete a esas reglas también: no inventa alcance ni resuelve conflictos en silencio.

  • Si no se encuentra ningún AGENTS.md ni CLAUDE.md en el alcance resuelto, reportarlo

explícitamente — no es un fallo silencioso.

Notas

  • Esta skill es de solo lectura sobre el repo: no escribe archivos ni hace commits.
  • Los pasos 2–4 son genéricos, no hardcodeados a la estructura de test-project: sirve para

auditar el contexto de agentes de cualquier repo donde se invoque.

Correlati per attività

dallo stesso repository

Altri Skills

Tutti gli Skills
adminoryslabs
Community

playwright-e2e-test

Writes and runs one Playwright end-to-end test for a single critical user flow (e.g. checkout, booking, sign-up), so the agent can verify its own work in a real browser instead of claiming "it works". Proposes the test plan in plain language first and waits for approval, reuses an existing Playwright setup or installs a minimal one, runs only that spec, and proves the test can actually fail. When the test fails it reports with evidence and never edits the test just to make it pass — the human de

Installazioni / 1h
3
GitHub Stars
0
Aggiornato
6 nov
adminoryslabs
Community

generar-backlog

Despieza un PRD + Technical Design Document en un backlog ordenado de specs implementables, cada una lista para arrancar un ciclo de Spec-Driven Development (SDD). Use when the user asks to break down, decompose, or turn a PRD/technical design into a backlog, roadmap, list of features, or list of specs to implement.

Installazioni / 1h
1
GitHub Stars
0
Aggiornato
19 ott
adminoryslabs
Community

contextualizar-negocio

Contextualiza el negocio de un sistema existente (brownfield) para trabajar AI-first sobre él - arma el mapa de capacidades (qué hace hoy el sistema), saca a la luz las reglas de negocio escondidas en el código y construye el glosario negocio ↔ código junto con el ARCH, todo con evidencia, y se detiene para aprobación humana. Use when the BA role starts on an existing system without a PRD or backlog, or when asked to document what a legacy system does, extract its business rules, or build a doma

Installazioni / 1h
11
GitHub Stars
0
Aggiornato
19 ott
adminoryslabs
Community

contextualizar-repo

Contextualiza un repositorio existente (brownfield) para trabajar AI-first sobre él - verifica cómo se arranca y se prueba, crea el índice de CodeGraph, reconstruye el mapa de capas real, documenta las decisiones heredadas como ADR, arma el catálogo de patrones (canon vs. legado), el mapa de deuda y las reglas de construcción verificables, todo con evidencia archivo:línea, y se detiene para aprobación humana. Use when the ARCH role starts on an existing codebase without a PRD, or when asked to c

Installazioni / 1h
11
GitHub Stars
0
Aggiornato
19 ott