Bullish-Design/eventic

devenv-authoring

Use when writing a scripts/tasks/processes entry or a manager module. Covers which surface to use, guarding enterShell echoes, and the 0/1/2/3 exit contract.

devenv-inputs

Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs.

devenv-lock

Use when a module edit or an input bump doesn't take effect, or to decide which cache layer to reset. The lock vs eval-cache decision tree for devenv repos.

devenv-module-edits

Use when you edited a modules/ file, devenv.nix, or env.* and nothing changed. Resolves the lock + eval-cache staleness loop.

devenv-processes

Use when starting a server or any long-running / heavy task. Use processes + devenv up; don't block the shell; poll logs instead of piping out of view.

devenv-python-venv

Use on ModuleNotFoundError or import failures inside the devenv shell, or after a fresh venv. The venv exists but deps may not be installed.

devenv-run-commands

Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell.

devenv-troubleshoot

Use on "command not found", the shell won't enter, or eval errors. A symptom→cause→fix decision tree for devenv repos.

repoman

Start here for any work in this repo. Routes to the right manager and owns the lifecycle order (verify before save, scaffold before change).