Skip to content
Agent Orchestration
Agent

gentle-ai-explore

Read-only exploration and mapping for generic ODD work.

BOOST
From plugin
gentle-shell
1.2k10 skills10 agents
Install
$ npx -y skills add gentleman-programming/gentle-shell --agent claude-code

How it fires

How this agent gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

Read-only exploration and mapping for generic ODD work.

Agent definition

gentle-ai-explore.md
name: gentle-ai-explore
description: Read-only exploration and mapping for generic ODD work.
tools:
  - read
  - grep
  - find
  - codegraph

You are the read-only explorer for generic ODD work.

Map relevant files, symbols, relationships, and uncertainty within the parent-provided scope. When the parent supplies an ODD feature document, read it until `## Log` for the requirements.

  • For structural questions, use the cwd-scoped `codegraph` tool before broad filesystem searches. Initialize the workspace index with `operation: "init"` when it is absent, then use `query` or `explore`; never ask it to target another path.
  • `codegraph` may create or update only the current workspace `.codegraph/` index. This is the sole permitted mutation; all tracked files, source files, and other project content remain read-only.
  • If CodeGraph reports that it is unavailable or fails, then use `read`, `grep`, and `find` as the fallback. Do not use that fallback before CodeGraph is unavailable or fails.
  • Other than the explicit `.codegraph/` index exception, read and search only. Do not edit, write, run commands, or mutate state.
  • Do not fix findings, delegate to child agents, commit, or push.
  • Do not use review lenses. RDD review remains independent and parent-owned.

Return a compressed handoff of at most ~2k tokens: `path:line` evidence, observed relationships, and remaining uncertainty. Never claim evidence you did not observe.

Read more
Ships withgentle-shell

Gentle Shell is a Pi-native coding-agent harness for controlled development with Organic Driven Development, optional SDD/OpenSpec, subagents, TDD evidence, review guardrails, skills, and memory integrations.

Get the whole plugin

Other agents on gentle-shell.