De Kiro básico a experto en Terraform

mkdir mi-primer-proyecto
cd mi-primer-proyecto
kiro .

Crea un juego tipo snake en HTML, CSS y JavaScript.
Un solo archivo index.html con todo dentro.
Diseño minimalista, dark mode.
La serpiente se controla con las flechas del teclado.

Hazlo más difícil: que la comida aparezca en lugares aleatorios
y la velocidad aumente cada 5 puntos.

Revisa #File index.html y dime:
- ¿Tiene buenas prácticas?
- ¿Qué mejorarías?
- ¿El código es accesible?

Crea un steering file .kiro/steering/convenciones.md
con estas reglas para proyectos web simples.
inclusion: always.

- Máximo 3 archivos (index.html, style.css, app.js)
- No crear carpetas extra (src/, dist/, tests/)
- No package.json, no node_modules
- camelCase para variables y funciones JS
- Comentarios JSDoc en todas las funciones
- Mensajes de error en español
- Tema dark mode por default
- Color principal #a855f7 (morado)

Crea una app de lista de tareas (TODO).

Crea una skill .kiro/skills/accesibilidad-web.md con conocimiento
sobre accesibilidad (a11y) en HTML/CSS/JS:

- Elementos semánticos (header, nav, main, article)
- Atributos aria-* cuando aplica
- Contraste de color WCAG AA
- Focus visible en elementos interactivos
- Labels asociados a inputs
- Texto alternativo en imágenes
- Keyboard navigation

Agrega un formulario de contacto a mi TODO app.
Que sea accesible para usuarios con lectores de pantalla.

Crea un agent .kiro/agents/reviewer.md llamado "reviewer".

Rol: senior frontend developer estricto con 10 años de experiencia.
Solo aprueba código que cumpla:
- Funciones con JSDoc completo
- try/catch en operaciones que pueden fallar
- Variables descriptivas (no x, y, tmp)
- Sin console.log olvidados
- Código accesible (a11y básico)

Formato:
- APROBADO ✅ con lista de cosas bien
- RECHAZADO ❌ con lista de issues y cómo arreglarlos

Tono: directo pero constructivo. No aprueba por lástima.

@reviewer revisa #File app.js y decidí si iría a producción.

Crea un hook llamado "js-quality-check" con estas características:
- Se activa al guardar archivos JavaScript
- Pattern: **/*.js (IMPORTANTE: con doble asterisco para subcarpetas)
- Tipo: fileEdited
- Acción: askAgent
- Debe revisar si hay:
  1. Funciones sin JSDoc
  2. console.log olvidados

Si detecta algo, que me avise en el chat con sugerencias específicas.

{
  "enabled": true,
  "name": "JS Quality Check on Save",
  "version": "1",
  "when": {
    "type": "fileEdited",
    "patterns": ["**/*.js"]
  },
  "then": {
    "type": "askAgent",
    "prompt": "Revisa el archivo recién guardado buscando funciones sin JSDoc y console.log olvidados. Reporta con formato: línea, problema y sugerencia."
  }
}

// Función sin JSDoc (debería avisarte)
function sumar(a, b) {
  console.log("sumando...");  // console.log olvidado
  return a + b;
}

sumar(2, 3);

Crea un Spec para agregar estas features al TODO app:
- Sistema de categorías (trabajo, personal, urgente)
- Filtros por categoría
- Persistencia en localStorage
- Modo oscuro/claro con toggle
- Export a JSON

Solo ejecuta las tareas obligatorias.

{
  "mcpServers": {
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Usando el MCP de AWS Docs, buscá las mejores prácticas
de seguridad para buckets S3 y dame un resumen.

Usando el MCP de AWS Docs, compará Lambda vs Fargate
para correr una API con tráfico irregular. ¿Cuál es más barato?

Usando el MCP de AWS Docs, explicame por qué un bucket S3
puede devolver "AccessDenied" aunque la policy parezca correcta.
Dame los 3 errores más comunes y cómo diagnosticarlos.

# macOS
brew tap hashicorp/tap
brew install hashicorp/tap/terraform

# Linux
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform

# Verificar
terraform version

# macOS
brew install awscli

# Configurar credenciales dummy (MiniStack no las valida)
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1

# Verificar
aws --version

# Levantar MiniStack (la primera vez descarga la imagen)
docker run -d -p 4566:4566 --name ministack ministackorg/ministack

# Verificar que está corriendo
docker ps | grep ministack

# Probar que responde
aws --endpoint-url=http://localhost:4566 sts get-caller-identity

Crea el archivo .kiro/steering/terraform-convenciones.md
con inclusion: always.

Convenciones para proyectos Terraform en este workspace:

- Estructura obligatoria:
  - versions.tf → required_version y required_providers
  - providers.tf → configuración del provider AWS
  - variables.tf → declaración de variables
  - main.tf → recursos
  - outputs.tf → outputs con comandos de verificación
  - locals.tf → valores calculados (si aplica)

- required_version >= 1.6.0
- Provider AWS versión ~> 5.0

- Variables:
  - description obligatoria (en español)
  - type declarado siempre
  - validation cuando aplique

- Outputs:
  - description obligatoria
  - Incluir comandos aws --endpoint-url=http://localhost:4566 de verificación

- Naming:
  - snake_case en recursos, variables, outputs
  - Prefijo con var.project + var.environment

- Tags obligatorios en TODOS los recursos:
  - Project, Environment, ManagedBy = "terraform"
  - Usar default_tags en el provider

- Prohibido hardcodear: regiones, AMIs, account IDs, passwords
- Comentarios en español
- Siempre incluir .gitignore con *.tfstate, .terraform/, *.tfvars

Crea el archivo .kiro/steering/ministack.md con inclusion: always.

MiniStack es un emulador local de AWS que corre en Docker en el puerto 4566.
Todo proyecto Terraform en este workspace debe configurar el provider AWS
para apuntar a MiniStack.

Configuración obligatoria del provider AWS:

provider "aws" {
  region                      = "us-east-1"
  access_key                  = "test"
  secret_key                  = "test"
  skip_credentials_validation = true
  skip_metadata_api_check     = true
  skip_requesting_account_id  = true

  default_tags {
    tags = local.common_tags
  }

  endpoints {
    s3             = "http://localhost:4566"
    sqs            = "http://localhost:4566"
    sns            = "http://localhost:4566"
    dynamodb       = "http://localhost:4566"
    iam            = "http://localhost:4566"
    sts            = "http://localhost:4566"
    secretsmanager = "http://localhost:4566"
    ssm            = "http://localhost:4566"
    cloudwatchlogs = "http://localhost:4566"
    lambda         = "http://localhost:4566"
  }
}

Los outputs deben incluir comandos de verificación con:
  aws --endpoint-url=http://localhost:4566 

Antes de terraform apply, verificar que MiniStack esté corriendo:
  docker ps | grep ministack

Crea un proyecto Terraform con un bucket S3 llamado "demo".

terraform init
terraform apply -auto-approve
aws --endpoint-url=http://localhost:4566 s3 ls
terraform destroy -auto-approve

{
  "mcpServers": {
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": { "FASTMCP_LOG_LEVEL": "ERROR" },
      "disabled": false,
      "autoApprove": []
    },
    "terraform": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "hashicorp/terraform-mcp-server"],
      "disabled": false,
      "autoApprove": [
        "search_providers",
        "get_provider_details",
        "search_modules",
        "get_module_details"
      ]
    }
  }
}

Crea el agent .kiro/agents/tf-reviewer.md llamado "tf-reviewer".

Rol: senior DevOps con 10 años de experiencia en Terraform y AWS.
Revisá código Terraform y aprobá solo si cumple:

- Variables con description, type y validation cuando aplique
- Outputs con description e incluyen comandos de verificación
- Tags obligatorios en todos los recursos
- Uso de locals para valores calculados o repetidos
- Sin valores hardcodeados
- for_each preferido sobre count cuando hay config diferente
- Provider AWS apunta a MiniStack (localhost:4566)

Formato de respuesta:
- APROBADO ✅ con lista de cosas bien hechas
- RECHAZADO ❌ con issues numerados: archivo/línea, problema y cómo arreglarlo

Tono: estricto pero constructivo. Nunca aprueba por lástima.

Crea un Spec para la infraestructura de una "tienda online" en MiniStack:

- S3 bucket para archivos estáticos del sitio
- SQS cola para procesar pedidos
- SNS topic de alertas suscrito a la cola SQS
- DynamoDB tabla de productos (con id como hash_key)
- Secrets Manager con password aleatorio (usar random_password)

Solo ejecutá las tareas obligatorias.

@tf-reviewer revisá #Folder ejemplo y decidí si está listo para producción.

cd ejemplo/
terraform init
terraform plan
terraform apply -auto-approve

# Verificar con AWS CLI
EP="--endpoint-url=http://localhost:4566"
aws $EP s3 ls
aws $EP sqs list-queues
aws $EP sns list-topics
aws $EP dynamodb list-tables
aws $EP secretsmanager list-secrets

# Ver el output de Terraform
terraform output

# Limpiar
terraform destroy -auto-approve