Módulo 1: Kiro y AWS
Tiempo estimado: 20 min
Lo que vas a construir
Vas a preparar el proyecto donde vivirá la app y a conectar Kiro con él. Al terminar, tu terminal y Kiro hablan con AWS usando el perfil gastos-hormiga.
Un proyecto contiene una cuenta de AWS y su configuración. Dentro de esa cuenta creamos la página, la API y la tabla.
Parte 1: tu proyecto y su Región (3 min)
AWS preparó tu primer proyecto cuando te registraste. Lo usamos para gastos hormiga en vez de crear otro.
Te toca: prepara el proyecto en AWS Settings
- Entra a AWS Settings.
- Abre View all projects y entra a tu primer proyecto.
- Cámbiale el nombre a
gastos.hormiga.
- En Overview, busca Additional Info > Region.
- Anota el código de la Región. Desde México fue
us-east-2(Ohio).
AWS asigna la Región según el país de tu dirección de contacto, y los recursos del workshop tienen que vivir ahí. Kiro te la va a preguntar en un momento.
💡 Los nombres de proyecto aceptan letras, números y puntos. El perfil y el stack se llaman gastos-hormiga, con guion.
Ese proyecto ya tiene recursos de otra app
Crea uno nuevo desde Project > Create project y llámalo gastos.hormiga. Así no mezclas recursos ni costos de dos apps.
Mi Región no es us-east-2
Abre cdk.json y cambia "region": "us-east-2" por la Región de tu proyecto. No copies una Región de otro tutorial.
Parte 2: conecta Kiro con AWS (10 min)
Te toca: prepara Kiro
- Canjea el código de créditos de Kiro que te dimos.
- Abre la carpeta
workshop-new-experience-awsen Kiro IDE.
El Agent Toolkit prepara a Kiro para trabajar con AWS: reglas para tu tipo de cuenta, skills para tareas de AWS y un servidor MCP con la documentación.
Te toca: pégale este prompt a Kiro en el chat
Set up Agent Toolkit for AWS by following these instructions:
https://raw.githubusercontent.com/aws/agent-toolkit-for-aws/refs/heads/main/setup-instructions/setup.md
¿Qué son MCP, las skills y las reglas?
MCP es el protocolo que Kiro usa para conectarse con herramientas y documentación de AWS. Las skills son guías para tareas específicas y las reglas ponen límites, por ejemplo usar solo la Región del proyecto. El Agent Toolkit las configura por ti.
Contesta lo que Kiro te pregunte
Kiro te hace tres preguntas juntas:
| Kiro pregunta | Tú contestas |
|---|---|
| Qué nombre quieres para el perfil de AWS CLI | gastos-hormiga, exactamente así |
| Si te registraste con Google o GitHub y creaste un proyecto | Sí |
| En qué Región se creó tu proyecto | La que anotaste en la parte 1, por ejemplo us-east-2 |
Después te pregunta cuánta guía quieres. Elige high: el agente explica cada paso antes de ejecutarlo.
Inicia sesión cuando Kiro te lo pida
Kiro corre aws login con ese perfil. No corras otro comando por tu cuenta.
Te toca: elige tu proyecto y termina el login
- Cuando Kiro lo pida, deja que abra el navegador.
- En el selector de proyectos, elige
gastos.hormiga.
- Termina el inicio de sesión y vuelve a Kiro. El agente sigue con la instalación.
- Si Kiro abre un asistente interactivo del Agent Toolkit, deja las opciones recomendadas.
- Cuando Kiro diga que terminó, abre un chat nuevo. Las reglas y las skills se cargan al empezar una conversación.
El perfil tiene que llamarse gastos-hormiga, porque es el que lee cdk.json en los checkpoints y al desplegar. La sesión de aws login dura 12 horas y se puede renovar hasta por 90 días sin volver al navegador.
💡 Kiro va a usar us-east-1 en un comando del Agent Toolkit porque ese servicio solo existe ahí. Tus recursos siguen en la Región de tu proyecto.
El perfil gastos-hormiga no se encuentra, o verify 1 falló por el perfil
El inicio de sesión no terminó o Kiro usó otro nombre de perfil. Mándale este prompt y, cuando termine, repite npm run verify 1:
Cambia mi nombre de perfil a gastos-hormiga
Kiro dice que falta uv
El Agent Toolkit usa uv para conectar el servidor MCP. Deja que Kiro lo instale y espera a que termine.
aws: command not found, o aws no se reconoce
Cierra la terminal, ábrela de nuevo y corre aws --version. Si sigue igual, repite el paso de Antes del evento.
Checkpoint ✅
Te toca: corre el checkpoint
npm run verify 1
Revisa que tu sesión de AWS esté activa con el perfil gastos-hormiga y que la Región del perfil sea la de cdk.json. Si hay un error de Región, sigue la pista que imprime el checkpoint.
Parte 3: comprueba lo que Kiro sabe (7 min)
Un agente puede responder con seguridad y aun así equivocarse. Vamos a comprobar que Kiro usa el contexto de La nueva experiencia de AWS.
Te toca: haz estas cuatro preguntas
Copia una pregunta, lee la respuesta de Kiro y compárala con la fuente que aparece debajo. No abras la comprobación antes de intentarlo.
1. La Región
¿En qué Región está mi proyecto y por qué esa?
Compruébalo en AWS Settings
Revisa Overview > Additional Info > Region en tu proyecto. Si Kiro dice otra cosa, gana AWS Settings.
2. El tutorial que usa otra Región
Un tutorial dice que cree mi Lambda en us-east-1. ¿Lo puedo hacer?
Compruébalo con el AWS CLI
Pídele a Kiro que corra:
aws lambda list-functions --region us-east-1 --profile gastos-hormiga
Si tu Región es Ohio, responde AccessDeniedException con un "explicit deny in a service control policy". Esa política evita que un tutorial viejo cree recursos en otra Región.
3. El plan y los créditos
¿Cuánto crédito me queda y cuándo termina mi acceso a AWS Free Tier?
Compruébalo con el AWS CLI
Kiro debe correr aws freetier get-account-plan-state. Revisa accountPlanType, accountPlanRemainingCredits y accountPlanExpirationDate en la respuesta, no solo el resumen del agente.
4. Los servicios de la app
¿API Gateway, Lambda, DynamoDB, Amplify Hosting, CloudFormation,
S3 y Budgets están disponibles en AWS Free Tier?
Compruébalo en la lista oficial
Sí, los siete están en la lista de servicios incluidos en AWS Free Tier. Disponible no significa ilimitado: si pasas el uso gratuito mensual, se descuenta de tus créditos.
Verifícalo tú
Contesta sin ver arriba: ¿dónde confirmarías la Región, el tipo de plan y si un servicio está disponible?
¿Ya respondiste?
AWS Settings, el output del CLI y la documentación de servicios soportados. Son las tres fuentes que vas a usar todo el workshop.
Para saber más
¿Cómo sabe Kiro todo esto?
El Agent Toolkit instaló reglas con el contexto de la nueva experiencia, y ahí dice que los recursos regionales van en la Región del proyecto. Por eso Kiro ya no te pregunta dónde desplegar.
Este repo también trae .kiro/steering/workshop.md y .kiro/steering/npm-seguro.md. Le dicen a Kiro qué no puede tocar de tu app (por ejemplo, nunca despliega por su cuenta) y cómo instalar paquetes sin riesgo. Las vas a ver en acción desde el módulo 2.
¿Por qué un proyecto por app?
El proyecto agrupa recursos y costos. Si compartes gastos.hormiga con un team member, esa persona trabaja en esta app sin entrar a tus otros proyectos.
Si te atoraste
Pega en Kiro el error y el comando que lo produjo, y pídele que lo explique sin desplegar ni borrar nada (más en errores comunes). Si no ves proyectos en AWS Settings, avísale al equipo: tu registro puede no tener la nueva experiencia. Si nada funciona, levanta la mano.