jamesmcroft

Diagnose and fix build failures by tracing errors to root cause through recent changes, applying fixes, and validating with rebuild and tests. Loops up to 3 iterations. Flags environment issues it cannot fix.

Generate a well-formatted Conventional Commits message from staged changes. Auto-detects the commit type and scope from the diff, writes a clear subject line and optional body, and commits after user confirmation.

Review your own changes on the current branch before publishing a PR. Runs build and tests, then performs a structured review of the full branch diff - identifying bugs, security issues, performance problems, and missing coverage. Auto-fixes straightforward issues and flags complex ones.

Create and publish a pull request from the current branch. Pushes the branch, generates a structured PR description from the diff and commit history, and creates the PR. Supports GitHub repos.

Review a pull request on GitHub. Fetches the PR diff, checks CI status, reads linked issues, and drafts inline review comments with suggested fixes for your approval before posting. Supports re-reviews after author updates. Use when you're assigned a PR to review.

Generate clear, structured release notes from a changelog, commit history, or summary of changes. Use when publishing a new version of a project, SDK, or library.

Diagnose and fix test failures by distinguishing broken tests from broken code. Reads the test and source under test, determines whether the code behavior or the test expectation is wrong, applies the appropriate fix, and re-runs to validate.

Create GitHub Issues from a natural language description. Generates a structured specification with context, requirements, and expected functionality. Analyzes the codebase for context, checks for duplicates, and assigns to the user. Use when you need to track a new task, bug, improvement, or piece of work.

Create new notes in the Obsidian vault following established templates and PARA conventions. Supports creating Areas, Techniques, Resources, Projects, and People notes. Automatically decomposes topics into multiple linked notes when appropriate, searches the existing knowledge base for cross-links, and reactivates archived content instead of duplicating it. Use when the user asks to add, create, or document a new topic, technology, process, person, or project in their vault.

Update, enrich, or restructure existing notes in the Obsidian vault. Merges new information into existing sections, adds cross-links to related content, decomposes overloaded notes into properly linked multi-note structures, and reactivates archived content when relevant. Use when the user asks to update, edit, expand, enrich, revise, or reorganize an existing note or topic in their vault.

Search and retrieve knowledge from the PARA knowledge base (Areas, Techniques, Resources). Use when the user asks about a technology, concept, process, or domain, or when you need background context from their Second Brain to support another task.