Skip to content

feat(skill): add warden-env.yml customization reference - #1

Open
lbajsarowicz wants to merge 2 commits into
wardenenv:mainfrom
lbajsarowicz:feat/customization-docs
Open

lbajsarowicz wants to merge 2 commits into
wardenenv:mainfrom
lbajsarowicz:feat/customization-docs

Conversation

@lbajsarowicz

Copy link
Copy Markdown
Collaborator

Description

Add documentation for the .warden/warden-env.yml Docker Compose override mechanism to the AI skill. This feature is documented in the official Warden docs but was completely missing from the skill, meaning AI agents had no awareness of per-project environment customization.

Changes

  • SKILL.md: New "Customizing Environments" section with use-case table and YAML examples for custom PHP images and PHP config overrides
  • references/customizing.md: New reference file with detailed patterns for:
    • Docker Compose override mechanics and load order
    • Custom PHP images
    • PHP configuration override (php.ini)
    • Nginx configuration override
    • Multiple domains via Traefik labels
    • Adding extra services
    • OS-specific overrides (.darwin.yml, .linux.yml)
    • Agent behavior guidelines

Validation

  • SKILL.md: 199 lines (within 500-line limit)
  • All referenced files exist
  • warden env config documented as verification command

Checklist

  • All commits follow Conventional Commits
  • SKILL.md remains under 500 lines
  • metadata.json and package.json are valid JSON

Type of Change

  • feat – New feature (minor version bump)

Add documentation for .warden/warden-env.yml Docker Compose override
mechanism, including custom PHP images, PHP config, Nginx config,
multiple domains, and extra services patterns.
…docs

# Conflicts:
#	skills/warden/references/customizing.md
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.

1 participant