CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-harness-refactor

Reestructura un arnes sin cambiar comportamiento, con disciplina deletion-only para compresion: insertions=0 verificable en el receipt, unidades borradas contadas y afirmaciones sobrevivientes intactas por construccion. Usar al pedir 'refactorizar arnes', 'comprimir AGENTS.md', 'deletion only', 'reordenar harness sin cambiar reglas'. NO para simplificar la topologia del sistema (agent-harness-simplify) ni reparar fallos (agent-harness-repair).

62

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/claude-native-toolkit/skills/agent-harness-refactor/SKILL.md
SKILL.md
Quality
Evals
Security

Agent Harness Refactor

Que es

Reestructura conservando semantica. Para compresion aplica deletion-only (references/deletion-only.md): una edicion con cero inserciones no puede alterar una afirmacion sobreviviente — la garantia es por construccion, no por revision. El receipt declara insertions=0, unidades eliminadas y afirmaciones intactas. Borrar lineas vacias o separadores NO es compresion: cambia estructura y puede pasar los checks existentes sin serlo. [DOC]

Cuando usar

  • AGENTS.md inflado, reglas duplicadas, secciones muertas, reorganizacion de archivos del arnes.
  • NO para cambiar reglas (evolve), bajar la topologia (simplify) ni corregir drift (repair).

Procedimiento

  1. Score base + snapshot de afirmaciones estructuradas (lineas con carga normativa). [CÓDIGO]
  2. Si es compresion: SOLO borrados. Verifica insertions=0 en el diff.
  3. Si es reorganizacion: mueve bloques completos sin editar su interior; el conjunto de afirmaciones estructuradas debe ser identico antes/despues.
  4. Receipt: unidades borradas, afirmaciones sobrevivientes, insertions, deletions.
  5. Re-audita: score no baja; Q9 sigue en verde. [CÓDIGO]

Contract

  • Aceptacion: receipt con insertions=0 (compresion) o set de afirmaciones identico (reorganizacion); score estable o mejor. [CÓDIGO]
  • Limites: un refactor que exige reescribir una regla NO es refactor: rutear a evolve. [EXPLICIT]
  • Casos borde: afirmacion duplicada (borrar duplicado es deletion-only legitimo); separadores estructurales (protegidos: no son compresion). [EXPLICIT]
  • Supuestos: el arnes pasa el audit antes del refactor. [SUPUESTO]
  • Trade-off: deletion-only limita la ambicion del cambio a cambio de garantia estructural. [EXPLICIT]

Packet

Capas del packet, cargables bajo demanda (disciplina ICM: una capa por vez, nunca todas juntas): references/ guías de profundidad (cargar UNA por etapa) · knowledge/ cuerpo de conocimiento · prompts/ prompts listos · examples/ salida de ejemplo · agents/ subagentes del packet · scripts/ automatización local · assets/ recursos estáticos.

Repository
JaviMontano/claude-plugins
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.