You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update all user-facing and agent-facing guidance together after the underlying
contracts land. This is intentionally one documentation issue so configuration,
CLI examples, automation guidance, and the bundled /wt skill cannot drift
apart.
README updates
Product positioning and requirements
Describe databases as an optional isolation capability rather than a global
prerequisite.
Make the PostgreSQL requirement conditional on managed template-cloning mode.
Explain the three database states represented by an allocation: managed,
logical-name-only, and absent.
State what new, setup, remove, prune, and doctor do in each state.
Configuration examples
Preserve and verify the existing local Postgres template-cloning example.
Add a ports + env-only example that has no local database or DATABASE_URL.
Add a cloud/pre-provisioned database example that disables provisioning but
derives a per-slot logical DB name for the database env patch.
Document validation behavior for {{dbName}} and database patches when no
logical name is configured.
Multi-service cross-wiring
Add one complete example with at least a frontend and API service.
Show the API's PORT using a port patch.
Show the frontend's API_BASE_URL using a url patch targeting the API
service, proving both values resolve to the same allocated port.
Include the resulting env values for a concrete slot.
README configuration, command reference, requirements, patch-type reference,
registry example, JSON section, and LLM setup guide all use the final
implemented names and shapes.
skills/wt/SKILL.md matches the README and contains no unconditional
Postgres assumptions.
Examples are exercised against the CLI or corresponding contract tests.
Parent: #11
Implementation dependencies:
Goal
Update all user-facing and agent-facing guidance together after the underlying
contracts land. This is intentionally one documentation issue so configuration,
CLI examples, automation guidance, and the bundled
/wtskill cannot driftapart.
README updates
Product positioning and requirements
prerequisite.
logical-name-only, and absent.
new,setup,remove,prune, anddoctordo in each state.Configuration examples
DATABASE_URL.derives a per-slot logical DB name for the
databaseenv patch.{{dbName}}and database patches when nological name is configured.
Multi-service cross-wiring
PORTusing aportpatch.API_BASE_URLusing aurlpatch targeting the APIservice, proving both values resolve to the same allocated port.
Concurrent orchestration
relevant
doctor/prunebehavior.wt new --jsonprocesses.
JSON contract
new --json.list --jsonexample with resolved ports.Setup Guide for LLM Agents
Postgres
DATABASE_URL.database with logical per-slot naming, or no database integration.
self-consistent.
unmanaged mode.
output.
Bundled
skills/wt/SKILL.mddatabase-optional operation.
port+urlmapping example.behavior beyond Make slot allocation and registry mutation concurrency-safe #14 and Define a stable, versioned JSON contract for orchestration #15.
Acceptance criteria
registry example, JSON section, and LLM setup guide all use the final
implemented names and shapes.
skills/wt/SKILL.mdmatches the README and contains no unconditionalPostgres assumptions.
setup that is outside the accepted implementation scope.