sxsphinxstack

Skills / Working / Create a local development environment

Working Code skill

Create a local development environment

Create a reproducible local development environment with pinned tools, isolated services, safe configuration, fixtures, reset, and verification.

Automate the smallest environment that reproduces real interfaces.

When to use

  • Use for onboarding, cross-platform development, isolated debugging, or consistent tests.
  • Do not copy production secrets, personal data, or unrestricted database dumps into local machines.

Procedure

  1. Inventory runtime, package manager, compiler, services, ports, system libraries, and supported platforms.
  2. Pin tool versions and define one bootstrap command with explicit prerequisites.
  3. Use safe example configuration and an approved secret-injection path.
  4. Provide synthetic or de-identified fixtures with deterministic creation.
  5. Isolate containers, databases, caches, queues, names, ports, and volumes by project or worktree.
  6. Add health checks, migrations, seed, start, stop, reset, and cleanup.
  7. Verify build, tests, service journey, offline or failure state, and a clean rebuild.
  8. Document troubleshooting from observable errors and maintain ownership.

Related skills

  • Create a feature flag rollout — Create a feature-flag rollout with targeting, defaults, exposure measurement, guardrails, rollback, ownership, and cleanup.
  • Create a synthetic monitor — Create a synthetic monitor for a critical user journey with safe data, controlled side effects, and useful diagnostics.
  • Create a data deletion runbook — Create a safe and verifiable procedure for deleting scoped data across systems.