You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements, and design before implementation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup.
Use when the user asks to publish or release the jrag-cli / java-codebase-rag pip packages to PyPI, cut a PyPI release, or recover a failed/diverged release. Primary path is tag-triggered CI (release.sh → release.yml dual-publish); the manual fallback covers CI-down and PyPI-reconciliation cases.
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation.
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback.
Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions.
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always.
MUST BE USED PROACTIVELY. Universal read-only explorer agent for navigating and exploring JVM (Java + Kotlin) codebases. Combines graph navigation via the jrag CLI (call chains, routes, service boundaries, clients, producers, impact, FQN resolution) with jrag search (locate code/config by meaning, keywords, or natural…
MUST BE USED PROACTIVELY. Universal read-only explorer agent. Combines jrag graph navigation (call chains, service boundaries, routes, impact analysis, FQN resolution) with broad file-system search (grep, glob, excerpt reading). Use for any exploration task: locating code, tracing dependencies, finding patterns…
MUST BE USED PROACTIVELY. Universal JVM (Java + Kotlin) codebase exploration (CLI surface): graph navigation (jrag callers/callees/routes/impact/flow/…) plus jrag search (locate code/config by meaning or keywords) and file-system search. Use for any exploration task: locating code, tracing dependencies, finding…
MUST BE USED PROACTIVELY. Universal read-only codebase exploration. Combines jrag graph navigation (call chains, routes, service boundaries, impact analysis, FQN resolution) with broad file-system search (grep, glob, file reading). Use for any exploration: locating code, tracing dependencies, finding patterns, 'where…