alexaiarchitect/agentcore-skills

Planifica el despliegue de la infraestructura de Amazon Bedrock AgentCore y su reversión, y entrega al usuario los comandos exactos, sin ejecutarlos nunca.

¿Qué es agentcore-skills?

Esta habilidad para asistentes de IA (como Claude Code) planifica el despliegue de infraestructura Amazon Bedrock AgentCore usando Terraform o Terragrunt, sin ejecutar ningún comando. Su propósito es guiar al usuario a través del orden de aplicación correcto (identidad y roles → gateway, runtime y memoria → destinos y estrategias → entrega de logs), detectar problemas comunes en el primer apply (propagación de IAM, búsqueda semántica de solo creación, Transaction Search antes de TRACES, bloqueo de proveedor obsoleto, ausencia de backend remoto), verificar cuotas publicadas (destinos por gateway, herramientas por destino) y generar los comandos exactos de init, validate, plan-to-file, show -json, policy check, apply del plan guardado, verificación post-apply y reversión para cada tipo de cambio. Los hallazgos se reportan en la banda `DPL0xx`. El nivel de costo es `aws` porque los comandos crean recursos facturables en la cuenta del usuario. Se utiliza cuando se pide 'desplegar el gateway', 'aplicar esto', 'en qué orden aplico', 'cómo revertir', '¿esto superará una cuota?', 'dame los comandos de terraform'. Nunca ejecuta comandos por sí misma: imprime las instrucciones y el usuario las ejecuta manualmente.

Compatible con✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/alexaiarchitect/agentcore-skills/tree/HEAD/skills/agentcore-deploy

Documentación

Desplegando AgentCore: secuencia, cuotas, comandos, reversión

El despliegue es donde este plugin deja de actuar y comienza a asesorar. Terraform ya ordena los recursos por sus referencias; lo que no puede decirle es qué raíz planificar, qué fallará en un primer apply por razones externas al grafo, qué ajustes no se pueden cambiar después y cómo volver atrás. Esta habilidad no escribe nada y no ejecuta nada: imprime los comandos, y el usuario los ejecuta.

${CLAUDE_SKILL_DIR} lo establece el runtime de la habilidad al directorio de la propia habilidad. Úselo textualmente en cada comando a continuación; los scripts de una habilidad hermana están en ${CLAUDE_SKILL_DIR}/../<skill>/scripts/.

Flujo

Revise primero. Un plan de despliegue sobre un error es un plan para desplegar el error:
```
python3 ${CLAUDE_SKILL_DIR}/../agentcore-review/scripts/review.py <project>
```
Planifique el despliegue.
```
python3 ${CLAUDE_SKILL_DIR}/scripts/deploy_plan.py <project>
```
--root DIR cuando la raíz descubierta no es la que se debe desplegar (la restricción del proveedor, el bloqueo, la región y las etapas serán entonces las de esa raíz); --plan-file NAME; --json. Los comandos nombran el plugin como $AGENTCORE_PLUGIN, establecido por la línea setup impresa.
Informe el módulo raíz, las etapas, los hallazgos DPL, los comandos y la reversión, en ese orden. Indique el nivel de costo: estos comandos crean recursos facturables en la cuenta del usuario.
Opciones: (1, recomendada) el usuario ejecuta init → validate → plan a un archivo → show -json → la verificación de políticas, y pega la salida de la política; (2) después de leerla, el usuario aplica ese archivo de plan guardado. Confirme cada paso con AskUserQuestion; nunca los colapse en un solo paso.
Verifique después de que el usuario informe un apply exitoso: pase a /agentcore:agentcore-verify.

La banda `DPL0xx`

Id	Severidad	Disparador
`DPL001`	advertencia	sin backend remoto (y sin Terragrunt)
`DPL002`	error	se excedió una cuota publicada (destinos por gateway, herramientas por destino)
`DPL003`	información	rol y gateway en un mismo apply: la propagación de IAM puede fallar en el primer intento
`DPL004`	información	la búsqueda semántica es de solo creación
`DPL005`	información	un stack de Terragrunt: los comandos usan `terragrunt`
`DPL006`	advertencia	hashicorp/aws bloqueado por debajo de 6.55.0
`DPL007`	información	la entrega de TRACES necesita Transaction Search habilitado primero
`DPL008`	información	la raíz elegida no declara restricción de versión para hashicorp/aws

Reglas de decisión

Aplique un plan guardado, nunca -auto-approve. El plan que el usuario leyó es el plan que se ejecuta.
Política antes de aplicar. policy_check.py rechaza la eliminación de memorias, gateways, proveedores de credenciales y grupos de usuarios sin un --allow-replace explícito.
-target es para reversión, no para el primer despliegue. Si el primer apply falla por propagación de IAM, vuelva a ejecutar el mismo apply.
Revierta revirtiendo, no destruyendo. Los recursos con estado (usuarios, conversaciones, secretos) nunca forman parte de una reversión.

Referencias

Pregunta	Archivo
Orden de etapas, qué falla en los primeros applies, Terragrunt	apply-sequencing.md
Las cuotas de AgentCore que importan en el momento del despliegue	quotas.md
Reversión por tipo de cambio; qué nunca destruir	rollback.md

Scripts

Comando	Hace	Códigos de salida
`scripts/deploy_plan.py <project> [--root DIR] [--plan-file F] [--json]`	raíz, etapas, hallazgos `DPL`, comandos, reversión	0 sin errores, 1 errores, 2 sin Terraform

Lista de verificación de finalización

review.py se ejecutó primero y sus errores fueron resueltos o aceptados por el usuario.
deploy_plan.py se ejecutó; el módulo raíz fue confirmado con el usuario.
El nivel de costo (aws) se indicó antes de entregar cualquier comando.
El usuario ejecutó plan → show -json → verificación de políticas antes de cualquier apply.
Solo se aplicó el archivo de plan guardado, por el usuario; ningún comando fue ejecutado por el asistente.
La reversión para este cambio se indicó antes del apply.