Skip to main content
subagent CX Codex

stellar-comparison — Claude Code subagent: checks and installation

stellar-comparison — a Claude Code subagent for comparison checks in the stellar-review pipeline. It receives a prepared brief and returns findings as JSON.

Apache-2.0 ★ 423 updated 2026-11-16

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/stellar-comparison.md
Open on GitHub

What stellar-comparison does

stellar-comparison runs a comparison review on the units assigned in its brief. It checks for duplication, inconsistency, and resolution issues. Sealed units and open or waived findings already listed in the brief header are out of scope. Each finding needs a verbatim quote and exact line numbers from the new file.

Before reviewing, it reads four mandate and reference files, then reads .stellar/briefs/brief-comparison[-N].md in full. It can inspect project files for context when its mandate calls for that, but findings must stay within the assigned units. The subagent cannot edit files or run shell commands. Its response is JSON containing findings and coverage, with resolutions included when the brief has resolution checks.

What it helps with

  • find duplicates in assigned units
  • check comparisons for consistency
  • spot resolution issues
  • return findings with quotes and line numbers

Example prompts for the agent

  • Run the stellar-review pipeline and assign stellar-comparison the comparison pass for these units.
  • Use stellar-review to run the comparison pass on .stellar/briefs/brief-comparison.md.

How to install stellar-comparison

Manually: put the files in place

.claude/agents/stellar-comparison.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about stellar-comparison

How do I install stellar-comparison in Claude Code?

Add the agent file at .claude/agents/stellar-comparison.md.

What does stellar-comparison do?

It checks assigned units for duplication, inconsistency, and resolution issues, then returns findings as JSON. The stellar-review pipeline dispatches it with a prepared brief.

Which files does stellar-comparison read before reviewing?

It reads .agents/skills/stellar-review/passes/comparison.md, then references/full-checklist.md, references/finding-schema.md, and references/severity-rubric.md under .agents/skills/stellar-review. It then reads the supplied brief in full.

Source text

stellar-comparison.md · Apache-2.0
---
description: Stellar review — comparison — duplication, consistency, resolution checks pass. Dispatched by the stellar-review pipeline with a pre-digested brief; never invoke directly for general questions.
mode: subagent
permissions:
  - action: edit
    resource: "*"
    effect: deny
  - action: shell
    resource: "*"
    effect: deny
---

You are a stellar-review **comparison** pass agent (ADR-0271). The caller
dispatches you with one pre-digested brief file; your whole job is to
judge it and return findings as JSON.

Before reviewing, read these files (paths relative to the repository
root), in this order:

1. `.agents/skills/stellar-review/passes/comparison.md` — your mandate
2. `.agents/skills/stellar-review/references/full-checklist.md` — doctrine
3. `.agents/skills/stellar-review/references/finding-schema.md` — output shape
4. `.agents/skills/stellar-review/references/severity-rubric.md` — severity rules

Then read the brief file the caller named (`.stellar/briefs/brief-comparison[-N].md`)
fully. Its assigned units are your entire scope.

Rules:

- Report only findings inside your mandate, only on assigned units.
  Sealed units are decided — never report them, never re-report open or
  waived findings listed in the brief header.
- Be exhaustive within your mandate: every finding, with a verbatim quote
  and exact new-file line numbers. Never ration in your head — severity
  and nit-capping are the poster's job.
- You may open real files for context (callers, module layout) when the
  mandate calls for it, but findings anchor to in-scope units.
- Your final message is exactly one JSON document in the finding-schema
  shape — no prose, no markdown fences. Example:
  {"findings": [...], "resolutions": [...], "coverage": ["brief-comparison.md"]}
  (include `resolutions` only when your brief has Resolution checks).

© relatedb · Apache-2.0 · relatedb/relate

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set18

The whole set →
relate This Claude Code skill guides Python work with Relate, an embedded openCypher graph database. It activates for building a local database, running Cypher queries, and handling query results. CX Codex +1 ★ 423repo stars relate This Claude Code skill guides JavaScript and TypeScript work with Relate, a local graph database queried with openCypher. It covers connections, transactions, and result handling. CX Codex +1 ★ 423repo stars rust-reviewer The rust-reviewer skill for Claude Code and Codex reviews Rust code for ownership, lifetimes, and error handling issues. It examines the whole project, including unsafe blocks and idiomatic Rust patterns. CX Codex +1 ★ 423repo stars agent-backlog-autopilot The agent-backlog-autopilot Claude Code skill takes one agent-backlog task from selection through a pull request. It pauses after the draft checks pass and waits for a human to mark the PR ready for review. CX Codex +1 ★ 423repo stars stellar-code-quality-review The stellar-code-quality-review Claude Code skill audits maintainability, abstraction quality, and file growth. Its staged review examines changes and related code units. CX Codex +1 ★ 423repo stars stellar-structure stellar-structure — a subagent for Claude Code that runs a code structure pass covering size, decomposition, and layer placement. Triggered by the stellar-review pipeline. CX Codex +1 ★ 423repo stars stellar-branching stellar-branching — a Claude Code subagent reviews branching growth and conditional logic. The stellar-review pipeline dispatches it with a prepared brief. CX Codex +1 ★ 423repo stars stellar-boundaries Claude Code subagent stellar-boundaries reviews boundaries, abstractions, and type contracts during a code review pipeline. CX Codex +1 ★ 423repo stars

Project sponsors

Companies that keep this analytics open