promode

Prepare for context clear by writing a handoff document

Analyzes Claude Code agent behaviour from output files, primarily during after action reviews. Knows output format (JSON per line) and that tail -1 efficiently retrieves the final summary.

Reviews implementation work. Marks tasks done or requests rework. Use with model=sonnet for standard review, model=opus for complex architectural review.

Investigates failures, analyzes logs, and finds root causes. Produces a reproduction test and reports findings. Does NOT implement fixes unless explicitly asked. Use for debugging, logging analysis, and error investigation.

Manages dev environments: health checks, docker, services, scripts. Ensures environments are healthy and easily manageable.

Implements code using TDD workflow. Updates task docs with what was done. Commits changes before reporting.

Researches questions using web search, fetching, and MCPs (context7, grep_app, exa if available). Checks today's date first to ensure up-to-date results, especially for fast-moving areas like AI, developer tooling, and libraries.

Consults on user-facing product decisions. Thinks holistically: UX, psychology, behavioural economics, network effects, growth. Maintains design system in docs/product/.

Blackbox QA expert who runs through key scenarios from the outside in. Creates and maintains testing tools, vigilant about test performance.

Runs tests and returns AI-optimized results. Critiques test quality (naming, coverage, outside-in).

MUST be loaded before working with any Skill. Covers creating, building, reviewing, assessing, checking, auditing, evaluating, updating, modifying, and improving skills. Invoke PROACTIVELY before writing or changing any SKILL.md file. Provides structure, workflows, and validation for skill development. Supports both personal skills and standalone distributable skills (GitHub repos). (user)

MUST be loaded when setting up, installing, migrating, reviewing, auditing, or checking CLAUDE.md files in projects. Covers installing the promode CLAUDE.md into new projects, migrating existing CLAUDE.md content to AGENT_ORIENTATION.md (progressive disclosure), and auditing projects for conformance. Invoke PROACTIVELY when user mentions CLAUDE.md, project setup, agent configuration, or code meta files.

Install, update, list, and remove Claude Code skills. Supports GitHub repositories (user/repo), GitHub subdirectory URLs (github.com/user/repo/tree/branch/path), and .skill zip files. Use when user wants to install, add, download, update, sync, list, remove, uninstall, or delete skills.