MCP HubMCP Hub
스킬 목록으로 돌아가기

dissolve-form

pjt222
업데이트됨 Yesterday
5 조회
17
2
17
GitHub에서 보기
기타general

정보

`dissolve-form` 스킬은 핵심 기능을 보존하면서 변화를 가능하게 하기 위해 경직되고 경화된 시스템 구조를 통제적으로 해체합니다. 이 스킬은 기술 부채나 시스템 경직성이 모든 진전을 막을 때, 일반적으로 평가에서 시스템을 `PREPARE` 또는 `CRITICAL`로 지정한 후에 사용됩니다. 주요 작업에는 경직성 매핑, 해체 순서 설정, 기술 부채의 안전한 분해를 통해 아키텍처를 재구성할 수 있도록 유연화하는 과정이 포함됩니다.

빠른 설치

Claude Code

추천
기본
npx skills add pjt222/agent-almanac -a claude-code
플러그인 명령대체
/plugin add https://github.com/pjt222/agent-almanac
Git 클론대체
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/dissolve-form

Claude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요

문서

Dissolve Form

Realizar desmantelamiento controlado de estructuras rígidas del sistema — disolviendo arquitectura calcificada, deuda técnica acumulada y rigidez organizacional mientras se preservan las capacidades esenciales ("discos imaginales") que sembrarán la nueva forma.

Cuándo Usar

  • La evaluación de forma (ver assess-form) clasificó el sistema como PREPARE o CRITICAL (demasiado rígido para transformarse directamente)
  • Un sistema está tan calcificado que el cambio incremental es imposible
  • La deuda técnica se ha acumulado hasta el punto donde bloquea todo avance
  • Una estructura organizacional se ha vuelto tan rígida que no puede adaptarse a nuevos requisitos
  • Antes de adapt-architecture cuando la forma actual debe ablandarse antes de poder ser remodelada
  • Desmantelamiento de sistemas heredados donde se debe extraer valor antes del cierre

Entradas

  • Requerido: Evaluación de forma mostrando alta rigidez (de assess-form)
  • Requerido: Identificación de capacidades esenciales a preservar (discos imaginales)
  • Opcional: Forma objetivo (lo que debería emerger después de la disolución; puede ser desconocido)
  • Opcional: Cronograma y restricciones de disolución
  • Opcional: Preocupaciones de las partes interesadas sobre componentes específicos
  • Opcional: Intentos previos de disolución y sus resultados

Procedimiento

Paso 1: Identificar Discos Imaginales

En la metamorfosis biológica, los discos imaginales son grupos de células dentro de la oruga que sobreviven a la disolución y se convierten en los órganos de la mariposa. Identificar las capacidades esenciales que deben sobrevivir.

  1. Catalogar cada capacidad que el sistema actual proporciona:
    • Funcionalidades orientadas al usuario
    • Funciones de procesamiento de datos
    • Puntos de integración con sistemas externos
    • Conocimiento institucional incorporado en el código/proceso
    • Reglas de negocio (a menudo implícitas, no documentadas)
  2. Clasificar cada capacidad:
    • Disco imaginal (debe sobrevivir): lógica de negocio central, integraciones críticas, datos irremplazables
    • Tejido reemplazable (puede reconstruirse): UI, infraestructura, algoritmos estándar
    • Tejido muerto (no debería sobrevivir): soluciones temporales para bugs que ya no existen, adaptadores de compatibilidad para sistemas extintos, funcionalidades que nadie usa
  3. Extraer discos imaginales a formato portátil:
    • Documentar reglas de negocio explícitamente (pueden existir solo como comentarios de código o conocimiento tribal)
    • Extraer algoritmos críticos en módulos independientes y probados
    • Exportar datos esenciales en representaciones independientes del formato
    • Registrar contratos de integración y su comportamiento real (no documentado)

Esperado: Un inventario claro de capacidades clasificadas como esenciales (preservar), reemplazables (reconstruir) o muertas (descartar). Las capacidades esenciales se extraen en formato portátil antes de que comience la disolución.

En caso de fallo: Si la identificación de discos imaginales es incierta (las partes interesadas no están de acuerdo sobre qué es esencial), errar hacia el lado de la preservación. Extraer más capacidades de las que se cree necesitar — descartar después de la disolución es fácil; recuperar conocimiento perdido es a menudo imposible.

Paso 2: Mapear Secuencia de Disolución

Determinar el orden en el que los elementos estructurales serán disueltos — capas externas primero, núcleo al final.

  1. Ordenar por profundidad de dependencia:
    • Capa 1 (más externa): componentes sin dependientes — nada se rompe cuando se eliminan
    • Capa 2: componentes cuyos dependientes son solo elementos de Capa 1 (ya disueltos)
    • Capa 3: componentes con dependencias más profundas — eliminarlos requiere gestión cuidadosa de interfaces
    • Capa N (núcleo): componentes portantes de los que todo depende — se disuelven al final
  2. Para cada capa, definir:
    • Qué se disuelve (elimina, descomisiona, archiva)
    • Qué lo reemplaza (nuevo componente, nada, o stub temporal)
    • Qué interfaces deben mantenerse para las capas restantes
    • Cómo verificar que el sistema aún funciona después de disolver esta capa
  3. Crear puntos de control de disolución:
    • Después de cada capa, el sistema restante debe probarse y verificarse operacional
    • Cada punto de control es un estado estable desde el cual la disolución puede pausarse
    • Si la disolución de una capa causa roturas inesperadas, restaurar desde el punto de control anterior
Dissolution Sequence (outside in):
┌─────────────────────────────────────────────────────────────────┐
│ Layer 1: Dead features, unused integrations, orphaned code      │
│          → Remove. Nothing depends on these.                    │
│                                                                 │
│ Layer 2: Replaceable UI, standard infrastructure                │
│          → Replace with modern equivalents or stubs             │
│                                                                 │
│ Layer 3: Business logic wrappers, data access layers            │
│          → Extract imaginal discs, then dissolve                │
│                                                                 │
│ Layer 4 (core): Load-bearing structures, data stores            │
│          → Dissolve last, with full replacement ready           │
└─────────────────────────────────────────────────────────────────┘

Esperado: Una secuencia de disolución ordenada por capas donde cada paso es seguro (punto de control verificado) y reversible (punto de control anterior es restaurable). Los componentes más críticos se disuelven al final cuando el equipo tiene más experiencia y confianza.

En caso de fallo: Si el mapeo de dependencias revela dependencias circulares (A depende de B depende de A), estos ciclos deben romperse antes de que la disolución secuenciada sea posible. Introducir una interfaz entre A y B, romper el ciclo, luego proceder con la secuencia.

Paso 3: Realizar Arqueología de Interfaces

Antes de disolver estructuras rígidas, excavar y documentar sus interfaces reales — no lo que está documentado, sino lo que realmente se usa.

  1. Instrumentar interfaces actuales:
    • Registrar cada llamada, mensaje o intercambio de datos en cada interfaz
    • Ejecutar durante al menos un ciclo de negocio completo (diario, semanal, mensual — lo que sea relevante)
    • Capturar formas reales de carga útil, no solo esquemas documentados
  2. Comparar comportamiento real vs. documentado:
    • ¿Qué interfaces documentadas nunca se llaman? (candidatas para disolución de Capa 1)
    • ¿Qué interfaces no documentadas se usan activamente? (dependencias ocultas — deben preservarse o reemplazarse explícitamente)
    • ¿Qué casos límite revela el tráfico real que la documentación no menciona?
  3. Construir un contrato de interfaz a partir del comportamiento real:
    • Este contrato se convierte en la especificación para cualquier reemplazo
    • Incluir ejemplos reales de entradas y salidas
    • Documentar el comportamiento de manejo de errores (lo que realmente sucede, no lo que debería suceder)

Esperado: Un contrato de interfaz derivado empíricamente que represente con precisión cómo se comunica realmente el sistema, incluyendo comportamientos no documentados y dependencias ocultas.

En caso de fallo: Si la instrumentación es demasiado invasiva (impacta el rendimiento o requiere cambios de código), muestrear el tráfico en lugar de capturarlo todo. Si el ciclo de negocio es demasiado largo para esperar, usar los datos disponibles complementados con entrevistas a las partes interesadas sobre "qué llama a qué en qué situaciones."

Paso 4: Ejecutar Disolución Controlada

Eliminar sistemáticamente elementos estructurales mientras se mantiene la viabilidad de los discos imaginales.

  1. Comenzar con la Capa 1 (más externa, sin dependientes):
    • Eliminar funcionalidades muertas y código no utilizado
    • Archivar (no eliminar) para referencia
    • Verificar: el sistema aún pasa todas las pruebas, sin errores en tiempo de ejecución
  2. Progresar a través de cada capa:
    • Para cada componente que se disuelve: a. Verificar que los discos imaginales han sido extraídos (Paso 1) b. Instalar reemplazo o stub (si quedan dependientes) c. Eliminar el componente d. Ejecutar suite de validación e. Monitorear efectos secundarios inesperados
    • En cada punto de control: documentar el estado actual del sistema, verificar estado operacional
  3. Manejar resistencia a la disolución:
    • Algunos componentes resisten la disolución (emergen dependencias ocultas)
    • Cuando una eliminación causa roturas inesperadas: a. Restaurar desde el punto de control b. Investigar la dependencia oculta c. Agregarla a la arqueología de interfaces (Paso 3) d. Crear un stub explícito para la dependencia e. Re-intentar la disolución
  4. Rastrear el progreso de la disolución:
    • Componentes restantes vs. disueltos
    • Discos imaginales extraídos y verificados como portátiles
    • Dependencias inesperadas descubiertas y manejadas

Esperado: Disolución sistemática y verificada de estructura no esencial. Después de cada capa, el sistema restante es más pequeño, más simple y aún operacional. Los discos imaginales se preservan en formato portátil.

En caso de fallo: Si la disolución causa fallos en cascada, el ordenamiento de capas está mal — hay dependencias ocultas más profundas de lo esperado. Detenerse, restaurar, remapear dependencias y re-secuenciar. Si la disolución revela que un "disco imaginal" es más complejo de lo esperado, asignar más tiempo de extracción para esa capacidad.

Paso 5: Preparar la Base para la Reconstrucción

Después de la disolución, el sistema restante debería ser un núcleo mínimo viable más discos imaginales extraídos listos para la reconstrucción.

  1. Evaluar el estado post-disolución:
    • ¿Qué queda? (núcleo operacional mínimo + capacidades extraídas)
    • ¿Es mantenible el sistema restante? (¿puede el equipo entenderlo y modificarlo?)
    • ¿Todos los discos imaginales son accesibles y están verificados? (portátiles, probados, documentados)
  2. Crear el manifiesto de reconstrucción:
    • Listar cada disco imaginal con su contrato, datos y suite de pruebas
    • Especificar la arquitectura objetivo para la reconstrucción (o marcar como "por determinar")
    • Identificar brechas: capacidades que se extrajeron parcialmente o tienen preocupaciones de calidad
  3. Transferir a la reconstrucción:
    • Si la forma objetivo es conocida: proceder a adapt-architecture con el núcleo mínimo como punto de partida
    • Si la forma objetivo es desconocida: operar sobre el núcleo mínimo mientras se diseña el objetivo
    • En cualquier caso: el sistema ahora es suficientemente flexible para ser remodelado

Esperado: Un sistema mínimo y mantenible con capacidades extraídas claramente documentadas. La base está limpia y lista para la reconstrucción en cualquier forma que se elija.

En caso de fallo: Si el sistema post-disolución es menos mantenible de lo esperado, alguna estructura esencial fue disuelta que debería haberse preservado. Verificar el inventario de discos imaginales — si falta una capacidad crítica, puede aún ser recuperable del archivo. Si el núcleo mínimo es demasiado mínimo para operar, algún "tejido reemplazable" era realmente esencial — restaurarlo desde el punto de control.

Validación

  • Los discos imaginales están identificados, extraídos y verificados en formato portátil
  • La secuencia de disolución está ordenada por capas desde la más externa (sin dependientes) hasta el núcleo
  • La arqueología de interfaces ha capturado el comportamiento real (no solo documentado)
  • Cada capa de disolución tiene un punto de control verificado
  • Ninguna capacidad esencial se perdió durante la disolución
  • El sistema post-disolución es mínimo, mantenible y operacional
  • El manifiesto de reconstrucción documenta las capacidades extraídas y las brechas

Errores Comunes

  • Disolver sin extraer: Eliminar un componente rígido antes de que se extraigan sus capacidades esenciales destruye conocimiento irremplazable. Siempre extraer los discos imaginales primero
  • Confiar en la documentación sobre la observación: Las interfaces documentadas a menudo divergen del comportamiento real. La arqueología de interfaces (Paso 3) revela la verdad; la documentación muestra la intención
  • Disolver el núcleo primero: Eliminar estructuras portantes antes de que sus dependientes se disuelvan causa fallos en cascada. Siempre trabajar de afuera hacia adentro
  • Disolución completa: Disolver todo para empezar de cero suena limpio pero pierde conocimiento institucional, manejo de casos límite probado en batalla y continuidad operacional. Preservar los discos imaginales
  • Disolución como castigo: Disolver un sistema "porque es malo" sin un plan de reconstrucción crea un vacío. La disolución es la preparación para la reconstrucción, no un fin en sí mismo

Habilidades Relacionadas

  • assess-form — evaluación prerrequisito que identifica la rigidez y activa la disolución
  • adapt-architecture — la habilidad de reconstrucción que sigue a la disolución
  • repair-damage — para sistemas que necesitan reparación dirigida en lugar de disolución completa
  • build-consensus — el consenso antes de una disolución mayor previene la fragmentación del equipo
  • decommission-validated-system — proceso formal de desmantelamiento para sistemas regulados
  • conduct-post-mortem — el análisis post-mortem comparte el rigor investigativo de la disolución

GitHub 저장소

pjt222/agent-almanac
경로: i18n/es/skills/dissolve-form
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

연관 스킬

llamaguard

기타

LlamaGuard는 폭력 및 혐오 발언 등 6가지 안전 범주에서 LLM 입력과 출력을 조정하기 위한 Meta의 70-80억 파라미터 모델입니다. 94-95% 정확도를 제공하며 vLLM, Hugging Face 또는 Amazon SageMaker를 사용해 배포할 수 있습니다. 이 기술을 사용하여 AI 애플리케이션에 콘텐츠 필터링 및 안전 가드레일을 손쉽게 통합하세요.

스킬 보기

cost-optimization

기타

이 Claude Skill은 리소스 적정화, 태깅 전략, 지출 분석을 통해 개발자들이 클라우드 비용을 최적화할 수 있도록 지원합니다. AWS, Azure, GCP에서 클라우드 비용을 절감하고 비용 거버넌스를 구현하기 위한 프레임워크를 제공합니다. 인프라 비용을 분석하거나, 리소스를 적정화하거나, 예산 제약을 충족해야 할 때 사용하세요.

스킬 보기

quantizing-models-bitsandbytes

기타

이 스킬은 bitsandbytes를 사용하여 LLM을 8비트 또는 4비트 정밀도로 양자화하며, 최소한의 정확도 손실로 50-75%의 메모리 감소를 달성합니다. 제한된 GPU 메모리에서 더 큰 모델을 실행하거나 추론을 가속화하는 데 이상적이며, INT8, NF4, FP4와 같은 형식을 지원합니다. 이 스킬은 HuggingFace Transformers와 통합되어 QLoRA 학습 및 8비트 옵티마이저를 가능하게 합니다.

스킬 보기

dispatching-parallel-agents

기타

이 Claude Skill은 3개 이상의 독립적인 문제를 동시에 조사하고 해결하기 위해 다중 에이전트를 배치합니다. 공유 상태나 의존성 없이 해결 가능한 무관련 장애 시나리오에 맞게 설계되었습니다. 핵심 기능은 병렬 문제 해결로, 각 독립 문제 영역마다 하나의 에이전트를 할당하여 효율성을 극대화합니다.

스킬 보기