# profile-resolver

profile-resolver — a subagent that reads a diff and the worktree, works out which project profiles are active, and reports which checklists load. Handy when detection has to run apart from the review.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 155 repo stars
- Author: serpro69
- License: Elastic-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/agents/profile-resolver.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/profile-resolver

## What it does

The agent takes three inputs: the diff text, the worktree root, and the absolute path to the plugin install. It reads the shared detection procedure, opens `DETECTION.md` for every known profile, then applies the three-part rule in order: path signals, filename signals, content signals. Its toolset is read-only (`Read`, `Grep`, `Glob`).

Output is a table with one row per diff file, the matching profile and the concrete `triggered_by` value, followed by two lists. One holds the checklists that load, the other the ones that stay out with the Load-if reason. Files where nothing matched still get a row marked `none`.

The plugin root arrives under a `## Plugin Root` heading. There is no shell here, so `${TOOLBOX_PLUGIN_ROOT}` cannot be expanded by the agent itself, and without that heading it halts with an error rather than guessing a path. It never reviews code or writes findings, that stays with `kk:code-reviewer`. Checklist lookup is wired for the `/kk:review-code` phase only.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add serpro69/claude-toolbox
```
In the agent chat (not a shell):
```text
/plugin install kk@claude-toolbox
```

2. **Manually: put the files in place**
- File: `.claude/agents/profile-resolver.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/profile-resolver.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/profile-resolver.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/agents/profile-resolver.md

## When to use it
- keep profile detection separate from the review step
- see which signal fired for each file in the diff
- list the checklists that were skipped and why
- grade the detection on its own, apart from review output
- keep procedure files out of the main session's context

## Example prompts
- Resolve the active profiles for this diff and tell me which checklists loaded and which were skipped.
- Run `profile-resolver` on the staged diff. Detection only, no code findings.
- Build the detection report for `Chart.yaml` and `values.yaml`; I'll pass the worktree root next.

## Similar
- [qodo-review-resolver](https://affpapa.org/en/nevibecode/skills/qodo-review-resolver.md) — skill · 103 installs
- [pr-comment-resolver](https://affpapa.org/en/nevibecode/agents/pr-comment-resolver.md) — subagent · ★ 1216 repo stars
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 437600 installs
- [understand-diff](https://affpapa.org/en/nevibecode/skills/understand-diff.md) — skill · 4200 installs
- [hunk-review](https://affpapa.org/en/nevibecode/skills/hunk-review.md) — skill · 2700 installs
- [difit-review](https://affpapa.org/en/nevibecode/skills/difit-review.md) — skill · 2000 installs

From the same set: [serpro69/claude-toolbox](https://affpapa.org/en/nevibecode/by/serpro69/claude-toolbox.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
