project-scripts
Installation
SKILL.md
Project Scripts
Single-file shell scripts in scripts/ are the portable source of truth for project lifecycle actions. When mise is available, it orchestrates them with dependency management and environment injection. Runtimes (Conductor, Claude Code, devcontainers) invoke scripts through their own config formats — they decide when lifecycle actions run.
The Four Actions
| Action | Purpose | When it runs |
|---|---|---|
setup |
Install deps, link env, run migrations | Workspace creation, CI start |
run |
Start dev server or primary workflow | Development, may be long-running |
stop |
Stop processes, clean transient state | Workspace pause, session end |
archive |
Package outputs, push branches, clean up | Before workspace destruction |
setup
Idempotent and fast when nothing has changed. Should check state before doing work — if deps are installed and env is linked, exit early. Safe to run repeatedly.
run
Start the dev server or main workflow. May be long-running (blocks until killed). For projects without a dev server, this can run tests or a REPL.