
--- name: afip-credentials-ops version: 1.0.0 purpose: > Operación segura de certificados y tokens AFIP: secretos, rotación, expiración y alertas. constraints: - no_secrets_in_repo --- # AFIP Credentials Ops Skill - Ubicar certs/keys y cómo se cargan - Proponer secret management (env/secret store) - Plan de monitoreo de expiración + alerta preventiva
--- name: afip-resilience version: 1.0.0 purpose: > Establecer resiliencia WSAA/WSFE: retries acotados, timeouts, circuit breaker (al menos documentado) y reconciliación. constraints: - retries_must_be_bounded - reconciliation_required_on_timeouts --- # AFIP Resilience Skill - Catalogar fallas SOAP típicas - Definir retries/backoff y timeouts - Definir estados transitorios (PENDIENTE_CONFIRMACION) si aplica - Definir re-consulta para resolver ambigüedad
# SKILL — Allowed Stack Definition ## Rol autorizado - Arquitecto --- ## Objetivo Definir el **stack tecnológico permitido** para el sistema. Todo stack no listado se considera **NO autorizado**. --- ## Output obligatorio .architecture/allowed_stack.md --- ## Reglas - Lenguajes permitidos - Frameworks permitidos - Bases de datos permitidas - Infraestructura permitida - Herramientas CI/CD
# SKILL — API Governance Definition ## Rol autorizado - Arquitecto --- ## Objetivo Establecer reglas de gobierno para APIs: contratos, versionado y errores. --- ## Output obligatorio .architecture/api_governance.md --- ## Reglas - OpenAPI obligatorio - Versionado explícito - Errores estandarizados
# SKILL — CI Validation ## Rol autorizado - Release Manager ## Objetivo Verificar que CI pase completamente. Debe verificar explícitamente: - Backend job: PASS - Frontend job: PASS Debe fallar si: - algún job no existe - algún job está SKIPPED - el pipeline no se ejecutó en esta corrida
# SKILL — Forbidden Patterns Definition ## Rol autorizado - Arquitecto --- ## Objetivo Definir patrones **prohibidos explícitamente** para evitar degradación arquitectónica. --- ## Output obligatorio .architecture/forbidden_patterns.md --- ## Regla clave > Lo no prohibido explícitamente NO implica que esté permitido > si contradice los principios arquitectónicos.
# SKILL — UI CRUD Sweep ## Rol autorizado - QA ## Objetivo Ejecutar visualmente todos los CRU(D) detectados en el frontend para validar estabilidad técnica. ## Inputs - Vistas CRUD detectadas - Backend en entorno dev/test ## Pasos Para cada vista CRUD: 1. Abrir listado. 2. Crear entidad (Create). 3. Leer detalle (Read). 4. Editar entidad (Update). 5. Eliminar si aplica (Delete). ## Validaciones - No errores JS fatales. - UI no se rompe. - Estados loading/error funcionan. ## Output - `qa/cr
# SKILL — functional-clarifier ## Objetivo Convertir un hotfix funcional en comportamiento explícito y verificable. ## Pasos 1. Leer fix_description.md 2. Definir: - Comportamiento actual - Comportamiento esperado - Casos borde 3. Validar alcance ## Output hotfix/HF-FUNC-XXX/functional_definition.md
# SKILL — functional-implementation ## Objetivo Implementar el cambio funcional planificado. ## Reglas - No refactor - No cleanup - No cambios fuera del plan ## Output Cambios de código
# SKILL — Issue Classifier ## Rol autorizado - Arquitecto de Software Senior ## Objetivo Clasificar cada hallazgo técnico para decidir su tratamiento posterior. ## Categorías - Hotfix técnico - Gap funcional - Problema de datos / seed - Problema de permisos / roles ## Output - Clasificación explícita por issue
# SKILL — Issue Classifier ## Rol autorizado - Arquitecto de Software Senior ## Objetivo Clasificar cada hallazgo técnico para decidir su tratamiento posterior. ## Categorías - Hotfix técnico - Gap funcional - Problema de datos / seed - Problema de permisos / roles ## Output - Clasificación explícita por issue
# SKILL — Hotfix Closure ## Rol autorizado - **Release Manager** ⚠️ Ningún otro rol está autorizado a cerrar un hotfix. --- ### Validación de Idioma Antes de instanciar el status: - Verificar que los archivos de evidencia estén redactados en **ESPAÑOL**. - Si se detecta idioma distinto → FAIL inmediato. --- ## Objetivo Cerrar **formal y persistentemente** un hotfix **solo si** existe evidencia completa y validada, dejando constancia auditable del estado final mediante el archivo: hotf
# SKILL — Hotfix Implementation ## Rol autorizado - Backend Engineer - Frontend Engineer ## Objetivo Implementar el fix con cambios mínimos y explícitos. ## Restricciones - No refactor - No cambios laterales
# SKILL — Hotfix Planner ## Rol autorizado - Backend Engineer - Frontend Engineer ## Objetivo Definir el plan mínimo de corrección a partir de un fix_description. ## Output - `implementation_plan.md` ## Restricción - No ampliar scope. ## Regla de Idioma (CRÍTICA) Este skill opera bajo el Workflow 71. - La salida DEBE estar escrita EXCLUSIVAMENTE en ESPAÑOL. - El skill NO puede copiar texto del fix_description en otro idioma sin traducirlo. - Cualquier palabra, frase o sección en otro idiom
--- name: logging-audit version: 1.0.0 purpose: > Definir logging seguro y auditoría de acciones críticas (emisión/NC), sin PII, con correlación y trazabilidad. constraints: - no_pii_in_logs --- # Logging & Audit Skill - Definir correlation_id/request_id - Definir audit trail (actor, acción, timestamp, resultado, ids) - Definir campos prohibidos (CUIT completo si no hace falta, direcciones, etc.)
# SKILL — Menu Mapping ## Rol autorizado - Arquitecto de Software Senior - Frontend Engineer ## Objetivo Verificar la coherencia entre rutas del sistema y entradas visibles en el menú según rol. ## Inputs - Menú dinámico - Roles y permisos - Rutas detectadas ## Pasos 1. Enumerar ítems del menú por rol. 2. Mapear cada ítem a su ruta esperada. 3. Detectar: - rutas sin menú - menú sin ruta - menú visible sin permiso ## Output - `architecture/menu_route_matrix.md` ## Restricciones - N
# SKILL — Security Baseline Definition ## Rol autorizado - Arquitecto - Security / Infra --- ## Objetivo Definir la línea base de seguridad para todo el sistema. --- ## Output obligatorio .architecture/security_baseline.md --- ## Reglas - Autenticación - Autorización - Manejo de secretos - Auditoría mínima
# SKILL — Service Boundaries Definition ## Rol autorizado - Arquitecto --- ## Objetivo Definir los **límites formales de los servicios**: qué es un servicio y qué no lo es. --- ## Output obligatorio .architecture/service_boundaries.md --- ## Reglas - Un servicio es dueño de sus datos - No hay bases compartidas - Comunicación solo vía contrato
--- name: test-bootstrap version: 1.0.0 stack: backend: fastapi frontend: vue purpose: > Instalar base mínima de tests: pytest/httpx (mock AFIP) y vitest (smoke). constraints: - no_direct_afip_calls_in_tests - request_approval_for_commands --- # Test Bootstrap Skill ## Backend (FastAPI) - Agregar pytest + httpx - Definir fixtures para app/db (según estructura existente) - Mock AFIP (wsaa/wsfe) para evitar llamadas reales - Crear 1-3 tests críticos (health + emisión/estado si existen
# SKILL — UI Menu Consistency Check ## Rol autorizado - **QA** - **Orchestrator** (solo lectura / clasificación) ⚠️ Este skill **NO autoriza correcciones**. --- ## Objetivo Detectar **inconsistencias observables de menú y navegación** en runtime, cuando el comportamiento visible de la UI **no coincide** con lo esperado a partir de las pantallas existentes o solicitadas. Este skill permite identificar **gaps funcionales o de producto** a partir de síntomas observables, **sin validar reglas
# SKILL — UI Runtime Menu Scan ## Rol autorizado - **QA** ⚠️ Ningún otro rol está autorizado a ejecutar este skill. --- ## Objetivo Ejecutar una **verificación runtime específica del sistema de navegación (menú)**, con el fin de **observar y evidenciar** errores **técnicos y funcionales observables** relacionados con la navegación de la UI. Este skill permite detectar: - ítems de menú no visibles para el rol ADMIN, - submenús que no expanden, - submenús visibles pero con navegación fallid
# SKILL — Observability Baseline Definition ## Rol autorizado - Arquitecto - Infra --- ## Objetivo Definir los mínimos de observabilidad para operación y soporte. --- ## Output obligatorio .architecture/observability_baseline.md --- ## Reglas - Logs estructurados - Métricas mínimas - Health checks obligatorios
# SKILL — Router Introspection ## Rol autorizado - Arquitecto de Software Senior - Frontend Engineer ## Objetivo Inspeccionar la configuración del router frontend para identificar todas las rutas existentes, su protección (auth/roles) y su vínculo con vistas y menú. ## Inputs - Configuración de Vue Router - Guards de navegación - Metadata de rutas ## Pasos 1. Enumerar todas las rutas registradas. 2. Identificar: - Públicas - Autenticadas - Dependientes de rol 3. Asociar cada ruta co
# SKILL — Hotfix E2E Verification ## Rol autorizado - QA ## Objetivo - Validar visual y técnicamente el fix. - El escenario ejecutado DEBE coincidir exactamente con el descrito en fix_description.md. - No se aceptan escenarios alternativos “equivalentes”. ## Output - `e2e_evidence.md`
# SKILL — Hotfix Implementation ## Rol autorizado - Backend Engineer - Frontend Engineer ## Objetivo Implementar el fix con cambios mínimos y explícitos. ## Restricciones - No refactor - No cambios laterales
# SKILL — Hotfix Test Adjustment ## Rol autorizado - QA ## Objetivo Garantizar cobertura mínima del fix. ## Output - `test_evidence.md`
# SKILL — functional-smoke-test ## Objetivo Verificar que el fix no rompió flujos adyacentes. ## Pasos 1. Navegar flujos relacionados 2. Verificar UX mínima 3. Detectar regresiones ## Output hotfix/HF-FUNC-XXX/smoke_evidence.md
# SKILL — functional-test-designer ## Objetivo Diseñar pruebas funcionales reproducibles. ## Pasos 1. Happy path 2. Errores esperados 3. Casos borde 4. Roles/permisos ## Output qa/cases/HF-FUNC-XXX.md
# SKILL — API Contract Check ## Rol autorizado - QA - Backend Engineer ## Objetivo Verificar que las llamadas reales del frontend al backend cumplen el contrato esperado. ## Inputs - OpenAPI - Llamadas reales observadas ## Pasos 1. Observar requests desde UI. 2. Verificar status HTTP. 3. Detectar: - 500 inesperados - contratos rotos - endpoints inexistentes ## Output - `backend/api_runtime_report.md` ## Restricciones - No modificar endpoints.
## Skill: fix-description-generator ### Propósito Transformar un issue técnico detectado en una **descripción de corrección clara, no ejecutable**, usable como input de un workflow correctivo posterior. ### Input esperado - hotfix/HF-XXX/input.md - hotfix/HF-XXX/analysis.md - Contexto del workflow (frontend / backend / auth) ### Output - hotfix/HF-XXX/fix_description.md ### Restricciones - ❌ No generar código - ❌ No generar prompts ejecutables - ❌ No ejecutar workflows - ✔️ Solo describir QU
# SKILL — Hotfix E2E Verification ## Rol autorizado - QA ## Objetivo Validar visual y técnicamente el fix. ## Output - `e2e_evidence.md`
--- name: openapi-contract version: 1.0.0 purpose: > Verificar gobierno de contrato OpenAPI: sincronía entre FastAPI y openapi.yaml, y definir estrategia de generación/validación. constraints: - request_approval_for_commands --- # OpenAPI Contract Skill - Determinar si `openapi.yaml` es manual o generado - Proponer: generar desde FastAPI en CI y compararlo (diff) - Documentar endpoints críticos (facturación/emisión)
# SKILL — Architectural Principles Definition ## Rol autorizado - Arquitecto ⚠️ Ningún otro rol puede ejecutar este skill. --- ## Objetivo Definir los **principios arquitectónicos rectores** del sistema que gobiernan todas las decisiones técnicas y funcionales futuras. Este skill: - ✔️ Define reglas duras - ✔️ Justifica decisiones - ❌ NO diseña implementación - ❌ NO genera código --- ## Output obligatorio .architecture/architectural_principles.md --- ## Reglas (NO negociables) - Cada
# SKILL — Hotfix Closure ## Rol autorizado - **Release Manager** ⚠️ Ningún otro rol está autorizado a cerrar un hotfix. --- ### Validación de Idioma Antes de instanciar el status: - Verificar que los archivos de evidencia estén redactados en **ESPAÑOL**. - Si se detecta idioma distinto → FAIL inmediato. --- ## Objetivo Cerrar **formal y persistentemente** un hotfix **solo si** existe evidencia completa y validada, dejando constancia auditable del estado final mediante el archivo: hotf
# SKILL — UI Runtime Scan ## Rol autorizado - **QA** ⚠️ Ningún otro rol puede ejecutar este skill. --- ## Objetivo Ejecutar una **verificación runtime técnica** de la aplicación frontend para detectar **errores técnicos observables en ejecución** que impidan la estabilidad operativa del sistema. Este skill: - ✔️ Navega la UI en ejecución - ✔️ Ejecuta acciones mínimas de uso real - ✔️ Detecta crashes, errores JS y abortos de navegación - ❌ NO valida reglas de negocio - ❌ NO evalúa comportam
# SKILL — UI CRUD Sweep ## Rol autorizado - QA ## Objetivo Ejecutar visualmente todos los CRU(D) detectados en el frontend para validar estabilidad técnica. ## Inputs - Vistas CRUD detectadas - Backend en entorno dev/test ## Pasos Para cada vista CRUD: 1. Abrir listado. 2. Crear entidad (Create). 3. Leer detalle (Read). 4. Editar entidad (Update). 5. Eliminar si aplica (Delete). ## Validaciones - No errores JS fatales. - UI no se rompe. - Estados loading/error funcionan. ## Output - `qa/cr
# SKILL — Hotfix Describer ## Rol autorizado - Arquitecto de Software Senior ## Objetivo Documentar cada hotfix técnico sin tocar código. ## Inputs - Issues clasificados como Hotfix ## Pasos 1. Crear carpeta HF-XXX. 2. Documentar: - Error - Ubicación - Impacto - Criterio de corrección - Riesgos ## Output - `hotfix/HF-XXX/fix_description.md` ## Restricciones - No implementar el fix. ## Regla de Idioma (CRÍTICA) Este skill opera bajo el Workflow 70. - La salida DEBE estar e
--- name: alembic-discipline version: 1.0.0 purpose: > Estandarizar migraciones Alembic y procedimientos de rollback. constraints: - request_approval_for_commands --- # Alembic Discipline Skill - Definir comandos canónicos (upgrade/downgrade) - Definir cómo se inicializa DB en DEV - Evitar scripts sueltos como fuente de verdad (documentar transición)
# SKILL — Hotfix Describer ## Rol autorizado - Arquitecto de Software Senior ## Objetivo Documentar cada hotfix técnico sin tocar código. ## Inputs - Issues clasificados como Hotfix ## Pasos 1. Crear carpeta HF-XXX. 2. Documentar: - Error - Ubicación - Impacto - Criterio de corrección - Riesgos ## Output - `hotfix/HF-XXX/fix_description.md` ## Restricciones - No implementar el fix.
# SKILL — UI View Loader ## Rol autorizado - Frontend Engineer ## Objetivo Verificar que todas las vistas frontend se cargan correctamente mediante imports dinámicos. ## Inputs - Rutas detectadas - Componentes lazy-loaded ## Pasos 1. Navegar a cada ruta. 2. Forzar carga del componente. 3. Detectar errores de: - import - alias - path relativo - compilación Vite ## Output - `ui/view_load_report.md` ## Restricciones - No corregir imports.
# SKILL — Hotfix Closure ## Rol autorizado - **Release Manager** ⚠️ Ningún otro rol está autorizado a cerrar un hotfix. --- ### Validación de Idioma Antes de instanciar el status: - Verificar que los archivos de evidencia estén redactados en **ESPAÑOL**. - Si se detecta idioma distinto → FAIL inmediato. --- ## Objetivo Cerrar **formal y persistentemente** un hotfix **solo si** existe evidencia completa y validada, dejando constancia auditable del estado final mediante el archivo: hotf
# SKILL — functional-planner ## Objetivo Definir el plan mínimo de corrección funcional. ## Pasos 1. Traducir comportamiento esperado a cambios concretos 2. Enumerar archivos 3. Evitar efectos colaterales ## Output hotfix/HF-FUNC-XXX/implementation_plan.md
# SKILL — Hotfix Test Adjustment ## Rol autorizado - QA ## Objetivo Garantizar cobertura mínima del fix. ## Output - `test_evidence.md`
# SKILL — CI Validation ## Rol autorizado - Release Manager ## Objetivo Verificar que CI pase completamente.
# SKILL — functional-clarifier ## Objetivo Convertir un hotfix funcional en comportamiento explícito y verificable. ## Pasos 1. Leer fix_description.md 2. Definir: - Comportamiento actual - Comportamiento esperado - Casos borde 3. Validar alcance ## Output hotfix/HF-FUNC-XXX/functional_definition.md
# SKILL — functional-test-execution ## Objetivo Ejecutar pruebas funcionales y registrar evidencia. ## Pasos 1. Ejecutar casos con usuario ADMIN 2. Registrar resultados 3. Adjuntar evidencia ## Output hotfix/HF-FUNC-XXX/test_evidence.md
# SKILL — Hotfix Planner ## Rol autorizado - Backend Engineer - Frontend Engineer ## Objetivo Definir el plan mínimo de corrección a partir de un fix_description. ## Output - `implementation_plan.md` ## Restricción - No ampliar scope.
# SKILL — functional-impact-analysis ## Objetivo Determinar impacto funcional y riesgo. ## Pasos 1. Identificar pantallas afectadas 2. Identificar endpoints afectados 3. Evaluar riesgo ## Output hotfix/HF-FUNC-XXX/impact_analysis.md