# Application Composer Diagnostics

> >

- **Type:** Skill
- **Install:** `agentstack add skill-aws-samples-sample-ai-agent-skills-application-composer-troubleshooting`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aws-samples](https://agentstack.voostack.com/s/aws-samples)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT-0
- **Upstream author:** [aws-samples](https://github.com/aws-samples)
- **Source:** https://github.com/aws-samples/sample-ai-agent-skills/tree/main/application-composer-troubleshooting

## Install

```sh
agentstack add skill-aws-samples-sample-ai-agent-skills-application-composer-troubleshooting
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AWS Application Composer Diagnostics

## When to use

Any AWS Application Composer investigation — project sync, template imports, resource configuration, canvas connections, SAM/CloudFormation template generation, local development, IDE extension issues, deployments, resource policies, or custom resource cards.

## Investigation workflow

### Step 1 — Collect and triage

```
aws cloudformation validate-template --template-body file://template.yaml
aws cloudformation list-stacks --stack-status-filter CREATE_FAILED UPDATE_FAILED ROLLBACK_COMPLETE
sam validate --template-file template.yaml --lint
```

### Step 2 — Domain deep dive

```
aws cloudformation describe-stack-events --stack-name  --query 'StackEvents[?ResourceStatus==`CREATE_FAILED`]'
aws cloudformation get-template --stack-name  --template-stage Processed
sam build --debug 2>&1 | head -50
```

### Step 3 — Detailed investigation

```
aws cloudformation describe-stack-resources --stack-name 
aws cloudformation detect-stack-drift --stack-name 
aws cloudtrail lookup-events --lookup-attributes AttributeKey=EventSource,AttributeValue=cloudformation.amazonaws.com --max-results 20
```

Read `references/guardrails.md` before concluding on any Application Composer issue.

## Tool quick reference

| Tool / API | When to use |
|------------|-------------|
| `cloudformation validate-template` | Validate template syntax |
| `cloudformation describe-stack-events` | Check deployment event history |
| `cloudformation get-template` | Retrieve processed template |
| `sam validate` | Validate SAM template with linting |
| `sam build` | Build SAM application locally |
| `sam local invoke` | Test Lambda functions locally |
| `sam deploy` | Deploy SAM application |

## Gotchas: AWS Application Composer

- Application Composer generates SAM templates by default. CloudFormation templates require explicit export. SAM is a superset of CloudFormation with Transform: AWS::Serverless-2016-10-31.
- Project sync writes changes to local files in real-time. If the local project has unsaved changes or git conflicts, sync can overwrite or fail silently.
- Canvas connections create IAM policies and environment variables automatically. Removing a connection does NOT remove the generated IAM statements — manual cleanup is required.
- Template imports must be valid YAML/JSON. Application Composer silently drops unsupported resource types or properties it cannot render on the canvas.
- Local development with SAM CLI requires Docker for Lambda emulation. Missing Docker or incorrect Docker socket configuration causes cryptic build failures.
- IDE extension (VS Code Toolkit) requires AWS credentials configured. Extension errors often stem from expired or missing credentials, not Application Composer bugs.
- Custom resource cards only support resources with a defined CloudFormation schema. Custom::* resources render as generic cards with limited property editing.

## Anti-hallucination rules

1. Always cite specific template paths, stack names, or error messages as evidence.
2. SAM templates and CloudFormation templates have different syntax. Never conflate Transform sections.
3. Application Composer canvas state and the generated template can diverge. Always verify the template file.
4. Connection-generated IAM policies are additive. Never claim removing a connection cleans up policies.
5. Spend no more than 2 minutes on any single hypothesis. Pivot if inconclusive.

## 12 runbooks

| Category | IDs | Covers |
|----------|-----|--------|
| A — Project Sync | A1–A2 | Sync failures, template import errors |
| B — Resources | B1–B2 | Configuration errors, connection issues |
| C — Templates | C1–C2 | SAM generation, CloudFormation errors |
| D — Local Dev | D1–D2 | Local development, IDE extension errors |
| E — Deployment | E1–E2 | Deployment failures, resource policy issues |
| F — Custom | F1 | Custom resource cards |
| Z — Catch-All | Z1 | General troubleshooting |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [aws-samples](https://github.com/aws-samples)
- **Source:** [aws-samples/sample-ai-agent-skills](https://github.com/aws-samples/sample-ai-agent-skills)
- **License:** MIT-0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aws-samples-sample-ai-agent-skills-application-composer-troubleshooting
- Seller: https://agentstack.voostack.com/s/aws-samples
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.