Skip to content

feat: add 'prepare' skill for Defang compose compatibility#2123

Merged
raphaeltm merged 3 commits into
mainfrom
sam/add-prepare-skill
May 22, 2026
Merged

feat: add 'prepare' skill for Defang compose compatibility#2123
raphaeltm merged 3 commits into
mainfrom
sam/add-prepare-skill

Conversation

@simple-agent-manager
Copy link
Copy Markdown
Contributor

Summary

  • Adds a new skills/prepare.md skill that guides agents to prepare a project for deployment with Defang
  • Handles both creating compose files / Dockerfiles from scratch and adapting existing ones
  • Covers the full checklist: unsupported directives, volumes, ports, secrets/config, service discovery, healthchecks, resource reservations, x-defang extensions, build config, and GitHub Actions

Key areas addressed

Based on research across samples, docs, and CLI validation code, the skill specifically tackles common confusion points:

  • Service discovery: explains service-name-as-hostname pattern, mode: host requirement for internal DNS
  • Build args: empty values skipped with warning, explicit values needed, frontend URL baking
  • GitHub Actions config: config-env-vars for secrets, OIDC auth, AWS_PROFILE gotcha
  • Volumes: not supported — guides toward managed services and compose.local.yaml with extends

Test plan

  • Review skill content for accuracy against current CLI validation
  • Test with an agent on a project that has no compose file (creation flow)
  • Test with an agent on a project with an existing non-Defang compose file (adaptation flow)

🤖 Generated with Claude Code

Guides agents to prepare a Docker Compose file (and Dockerfiles) for
deployment with Defang. Covers creating files from scratch or adapting
existing ones: unsupported directives, volumes, ports, secrets, service
discovery, healthchecks, resource reservations, x-defang extensions,
build config, and GitHub Actions integration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Comment thread skills/prepare.md Outdated
Comment thread skills/prepare.md Outdated
Comment thread skills/prepare.md Outdated
Comment thread skills/prepare.md
raphaeltm and others added 2 commits May 21, 2026 15:32
- Use explicit ${VAR} interpolation syntax instead of bare variable names
  for better developer readability
- Add guidance for agents to include `defang config set` comments in
  compose files
- Clarify that build args are NOT resolved from defang config
- Note OIDC auth prerequisites (Portal cloud connection or `defang cd setup`)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@raphaeltm raphaeltm marked this pull request as ready for review May 21, 2026 16:40
@raphaeltm raphaeltm requested a review from jordanstephens as a code owner May 21, 2026 16:40
Copy link
Copy Markdown
Member

@jordanstephens jordanstephens left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not opposed to this, but I suspect we could push at least some of this down a layer into the cli itself—we shouldn't need a language model for many of these.

@raphaeltm raphaeltm merged commit 09c0ed3 into main May 22, 2026
14 checks passed
@raphaeltm raphaeltm deleted the sam/add-prepare-skill branch May 22, 2026 09:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants