Skip to main content

Stack Skills

Stack skills define individual CloudFormation stacks that /ipa.compose assembles into deployment patterns. Each stack skill lives at .claude/skills/ipa.stack.{name}/SKILL.md and declares the stack's parameters, outputs, wiring, feature flags, and lifecycle classification.

Stack skills are not invoked directly. Instead, /ipa.compose reads them to generate Makefiles and deployment configuration.

Lifecycle Classification

Stacks are classified into two lifecycle categories that determine when they are deployed and whether /ipa.destroy removes them:

LifecycleDeployed ByRemoved ByExamples
prepare/ipa.prepareManual (make -f scripts/prepare.mk teardown-prepare)ECR, Cognito
deploy/ipa.deploy/ipa.destroyBackend, Frontend, Queue

Solution Tier Stacks

These stacks form the application infrastructure and are deployed and destroyed as a unit.

StackDescription
/ipa.stack.backendLambda + API Gateway v2 + DynamoDB + CloudWatch
/ipa.stack.frontendS3 + CloudFront + OAC
/ipa.stack.queueSQS + DLQ + worker Lambda + DynamoDB + CloudWatch

Prepare Stacks

These stacks provide shared prerequisites and persist across deploy/destroy cycles.

StackDescription
/ipa.stack.ecrECR repository for container images
/ipa.stack.cognitoCognito User Pool with OAuth 2.0 and OIDC

Infrastructure Stacks

These stacks support CI/CD and are managed by /ipa.codepipeline.

StackDescription
/ipa.stack.codecommitCodeCommit repository for source code
/ipa.stack.codepipelineCodePipeline CI/CD with CodeBuild