Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneesstack72

Relationships

#1944 Swamp skill repo reference missing datastore config expression interpolation docs

Opened by stack72 · 9/1/2026· Shipped 9/2/2026

Problem

The swamp skill's repo reference (.claude/skills/swamp/references/repo/reference.md) does not document the ${{ env.VAR }} and ${{ vault.get(name, key) }} expression syntax for datastore config values in .swamp.yaml, added in PR #2340 (swamp-club#1801).

The design doc (design/enablers/datastores.md lines 148-196) has full documentation of this feature, but the skill reference — which is what Claude loads when helping users — has no mention of it. The Datastores section covers SWAMP_DATASTORE env var override but not per-value expression interpolation.

Proposed Solution

Add a "Config Value Interpolation" subsection to the Datastores section in references/repo/reference.md, covering:

  • ${{ env.VAR_NAME }} syntax for environment variable references
  • ${{ vault.get(vaultName, secretKey) }} syntax for vault secret references
  • The limitation that only env.* and vault.get() are supported (not full CEL)
  • The managedConfig circular dependency constraint (vault expressions not supported when managedConfig: true)
  • Examples showing mixed expressions in extension datastore config

Content should match the design doc at design/enablers/datastores.md lines 148-196.

Alternatives

Could document this only in the vault or data guides, but it belongs in the repo reference since it's about .swamp.yaml config resolution — the repo guide is where users learn about datastore setup.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 11 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

9/2/2026, 2:39:35 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/1/2026, 11:42:45 PM

Sign in to post a ripple.