---
name: maintain-environment
description: Maintain the repo devcontainer environment and related workflow files. Use when changing .devcontainer or environment setup scripts.
---

# Maintain Environment

## Scope

- Single reproducible development environment.
- Definition files: `.devcontainer/Dockerfile`, `.devcontainer/devcontainer.json`, `scripts/devcontainer-post-create.sh`, `ai-forecasting-hackathon.code-workspace`.

## Change policy

- Environment changes require project owner approval and a devcontainer rebuild.
- Modify definition files directly, not ad-hoc local installs, to keep reproducibility and documentation.

## Available tools

- Base image: `mcr.microsoft.com/devcontainers/base:ubuntu`
- Node and npm
- Common CLIs: `git`, `gh`, `rg`, `jq`, `fd`, `curl`, `tree`, `inotifywait`, `entr`
- IDE for project owner: `code-tunnel`

## Host binds and worktrees

- Host binds are defined in `devcontainer.json` and must exist or rebuilds fail.
- Host binds persist caches, oauth tokens, and configs across rebuilds.
- Worktrees persist in `/workspaces/worktrees/`.
- Shared across worktrees: host binds and `/workspaces/worktrees/shared/`.

## Notes

- Toolchain usage is documented in package-level docs.
- All agents and the project owner use the same devcontainer on the same ubuntu 24.04 host OS.
- No other clones of the repo exist, so gitignored changes and caches persist unless removed during worktree removal.