# Maintain Environment

> Maintain the repo devcontainer environment and related workflow files. Use when changing .devcontainer or environment setup scripts.

- Skill: `majiayu000/maintain-environment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/maintain-environment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/maintain-environment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/maintain-environment

---


# 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.