dotfiles

Reconstruct a past Claude Code session's multi-agent orchestration (Agent/Task spawns, nested subagents, handoffs, respawns, skills loaded) into a JSON timeline, then render it as a self-contained interactive SPA sequence graph. Use when the user asks to visualise agents/subagents/handoffs from a session, mentions "agent graph"/"session timeline"/"agent handoff chart", or wants to regenerate or update such a graph.

Scaffold and structure a Dockerized FastAPI backend with uv-managed dependencies — multi-stage builds optimised for build speed, split internal/external API services, an env-file + profile driven docker-compose, and a Makefile that passes through host architecture and env vars. Use when setting up Docker for a Python/FastAPI project, writing a multi-stage uv Dockerfile, splitting a backend-only service from an outward-facing (http/https) API, designing docker-compose profiles, or wiring a Makefile around docker buildx bake. Also use when optimising an existing setup: shrinking a Python/FastAPI Docker image, reducing image size, speeding up slow Docker builds, improving layer caching, or trimming heavy ML/native dependencies out of the shipped runtime image. Modeled on the TenderAI repo's ops setup.

Scaffold and structure a Dockerized frontend web UI — multi-stage builds optimised for build speed, npm cache mounts, non-root nginx serving the production build, live-reload dev mode via Vite dev server with bind-mounts, runtime env-var injection for SPAs, and nginx security headers. Use when setting up Docker for a TypeScript/Vite/React/Vue project, writing a multi-stage node→nginx Dockerfile, wiring a Vite dev container with HMR, configuring nginx for SPA routing and CSP headers, or injecting runtime config into a static build. Partners with the docker-fastapi skill.

Conventions and invariants for editing home/linux/.bashrc — the interactive prompt (PS0 timer, PROMPT_COMMAND=_mk_prompt, exit-status capture, prefix array), the PS1_* colour vars, and performance rules (no forks per prompt). Use when editing home/linux/.bashrc, the prompt, PS1, PS0, _mk_prompt, PROMPT_COMMAND, or adding/changing prompt segments or colours.

Write pytest tests for this repo — correct structure, no unnecessary mocking, xdist-safe, consistent setup/result/expected/assert shape. Use when writing or editing test files, adding test coverage, or reviewing tests for style.

Apply personal Python code style — stdlib-first, single quotes, low nesting, named ANSI constants, performance-driven, vertical kwarg alignment. Use when writing or editing Python (.py files), setting up pyproject.toml, choosing between implementations, or naming tests.

Keeps the skill set lean by leasing disabled, on-demand skills to live sessions and reaping skills left enabled by dead ones. Use at session start, whenever a task might need a skill that is currently disabled (e.g. docker, deep-research, a domain skill not in context), or when cleaning up skillOverrides. Searches disabled skills, enables the relevant one for the duration of the work, then re-disables it when the task is done or the session ends.