Skip to content

fix(cdk): agent stack template at 98.4% of the CloudFormation 1 MB limit #735

Description

@dreamorosi

Observed (live deploy, 2026-08-06, ADR-021 P2 smoke run)

With the Lambda MicroVMs backend + image configured, the synthesized backgroundagent-dev template measured 983,796 bytes of the 1,000,000-byte CloudFormation limit (98.4%) and 486 of 500 resources. Roughly one more construct of headroom before deploys start failing for reasons unrelated to whatever change triggers it.

Impact

Any feature adding a handful of resources (P3 suspend/resume wiring is next in line) can push the stack over either limit, failing deploys with confusing errors.

Proposal

  • Short term: measure per-construct contribution (cdk synth | wc -c bisection) and prune obvious weight (duplicated policy statements, verbose metadata)
  • Structural: split the stack (nested stacks or a second stack for optional backends), which also helps the 500-resource ceiling
  • Add a synth-time size/resource-count warning at e.g. 90% so the next increment is caught at build time, not deploy time

Found during ADR-021 P2 verification (#645); not MicroVM-specific.

No activity

Activity on this issue will appear here.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    v1Version 1

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions