saffron-health/libretto

Address Review systematically fetches PR feedback, applies requested code changes, and verifies them with tests and checks. Use it when responding to human review comments on a pull request.

CLI Development designs command-line interfaces with scoped help, clear success messages, and diagnosable failures. Use it when creating or updating commands, argument parsing, exit codes, or human- and machine-friendly CLI output.

Errore is Go-style error handling for TypeScript, where functions return Error | T instead of throwing. Use it when you want typed, visible error handling with early returns and cause chains.

External Electron Apps automates user-installed Electron desktop apps through Libretto and CDP. Use it to control apps like Slack, VS Code, Discord, Notion, Figma, or Spotify on the user's machine.

Fix Merge Conflicts resolves Git merge, rebase, and cherry-pick conflicts by checking PR intent and preserving compatible changes from both sides. Use it when unmerged paths or conflict markers need careful resolution before validation.

Generate Spec creates a spec sheet in the specs directory for a significant feature or complex fix. Use it to research the codebase, clarify open questions, and define goals, non-goals, and an implementation plan.

Generate Spec V2 creates a code-based implementation spec in specs/ for a feature, fix, or refactor. Use it when planning work that needs Mermaid flows, key types, phased diffs, and checks before implementation.

Glimpse Changes creates a single HTML walkthrough of the current session diff and opens it in a native Glimpse window. Use it when you want a visual review of local code changes instead of a plain text diff.

Implement Spec guides an agent through reading a spec, implementing one phase, and running checks before marking tasks done. Use it when you need to complete a specific phase from a spec file.

Improve Codebase Architecture finds deepening opportunities in a codebase by locating shallow modules, tight coupling, and weak test seams. Use it when you want to improve architecture, locality, testability, or AI-navigability.

Libretto is a browser automation CLI for exploring live sites, prototyping interactions, and turning those steps into reusable workflow scripts. It is used to inspect pages, responses, and state while building or debugging automations.

Libretto Read Only inspects live browser state without clicks, typing, navigation, or other mutations. Use it to diagnose pages with snapshot and readonly-exec while keeping the session unchanged.

PR Review Comments formats the latest pull request review comments by file and line, with threads preserved. Use it when you need a concise view of feedback on a PR.

Prompting guides writing effective system prompts for LLM agents. Use it when creating or editing prompts for applications, agent configurations, or development tools.

Push commits and create or update a pull request as needed. Push is used for the standard branch, commit, and PR workflow after making changes.

Push Everything stages, commits, and pushes all changes in a Git repository, not just the current session's work. Use it when you need to bundle pending changes into a branch and PR.

Review evaluates changes for simplicity and correctness after an implementation is complete. Use it to check whether code meets its goals with minimal necessary complexity.

Spec Review checks a spec for under-specified decisions, design-level bugs, and adherence to the review structure. Use it when you need to critique a spec before implementation.

Summarize creates concise Slack-ready writeups from a spec or current changes. Use it when you need a short problem-and-solution summary for team communication.

Technical Writing guides concise, clear documentation, specs, and markdown files. Use it when creating or editing READMEs, AGENTS.md files, or other codebase docs.

Turborepo configures task pipelines, caching, and affected-package runs for JavaScript and TypeScript monorepos. Use it to set up package scripts, CI builds, filters, and shared code across apps and packages.

Update Docs refreshes AGENTS.md files with patterns, commands, and conventions learned during a development session. Use it when new project knowledge should be recorded at the right scope.

Writing Tests helps you create and edit test files that model real user flows. Use it when adding, modifying, or reviewing tests that should match the product interface closely.