Skip to main content
subagent CX Codex

boundary-guardian — Claude Code subagent: setup and details

boundary-guardian monitors reasoning boundaries and detects semantic drift to stop AI hallucinations before invalid statements occur.

no license ★ 1,357 updated 2026-03-01

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

What boundary-guardian does

The Sentinel subagent assigns reasoning steps into four color-coded categories based on a tension metric (ΔS): safe, transitional, risk, and danger. Crossing into the danger zone prompts an immediate halt to reasoning and triggers a BBCR sequence to retreat to verified concepts.

It provides built-in commands prefixed with an asterisk, such as *detect-boundary, *assess-risk, and *show-heatmap. Because its command execution resolves against markdown scripts inside .claude/commands/boundary/ and .claude/commands/wfgy/, the agent cannot run those specific procedures if those directories are missing.

What it helps with

  • detect when reasoning drifts past verifiable knowledge boundaries
  • stop runaway hallucinations using an automated BBCR fallback sequence
  • evaluate conversation risk levels across categorized metric zones
  • build bridging concepts to explore uncertain topics without guessing

Example prompts for the agent

  • Run *detect-boundary to inspect current knowledge limits
  • Check the risk score of this explanation with *assess-risk
  • Build a safe conceptual path toward the target topic using *find-bridge

How to install boundary-guardian

Manually: put the files in place

.claude/agents/boundary-guardian.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 boundary-guardian

How to install boundary-guardian in Claude Code?

Add the agent definition file to your workspace at .claude/agents/boundary-guardian.md.

What does boundary-guardian do?

It tracks semantic tension thresholds to identify when model reasoning approaches unreliable territory and enforces corrective recovery steps.

What dependencies does this subagent require?

It expects related command files to exist in .claude/commands/boundary/ and .claude/commands/wfgy/ when executing specific operations.

Similar subagents

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

From the same set112

The whole set →
cleanup-vibes cleanup-vibes turns a vibecoded repo into something deployable: pulls hardcoded keys into .env, sorts files into folders, writes the README. CX Codex +1 ★ 1,357repo stars sync-pr-to-task sync-pr-to-task connects GitHub pull requests to Linear issues, mapping review statuses and comments bidirectionally. CX Codex +1 ★ 1,357repo stars nextjs-pro nextjs-pro — a Next.js subagent for architecture, rendering choices, SEO, testing, and performance work across an existing or new application. CX Codex ★ 1,357repo stars retrospective-analyzer retrospective-analyzer pulls sprint numbers from Linear and Git, finds problems that repeat across retros, and drafts action items with owners and dates. CX Codex +1 ★ 1,357repo stars react-pro react-pro — a React-focused subagent for building components, refactoring code, and tackling UI problems. It examines existing project patterns and includes testing in its workflow. CX Codex ★ 1,357repo stars Linear Todo Sync Linear Todo Sync pulls your open Linear tasks through the API and writes them as a markdown todo file in the project root. Useful when you want a quick view of assigned work. CX Codex +1 ★ 1,357repo stars reasoning-validator The reasoning-validator subagent for Claude Code checks reasoning chains with WFGY formulas and quantitative metrics, helping identify logical errors in assistant reasoning. CX Codex ★ 1,357repo stars strategic-analyst strategic-analyst simulates business and architecture scenarios, maps project constraints, and logs planned initiatives directly into Linear. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open