Skip to main content
subagent CX Codex

signal-discoverer — Claude Code subagent: what it does, how to install

The signal-discoverer subagent for Claude Code mines recent sessions for undocumented user corrections, architectural decisions, behavioral patterns and preferences to save to project memory.

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@Claudest
Open on GitHub

What signal-discoverer does

The subagent runs recent_chats.py, reads up to ten recent conversations in the current project and extracts what is worth recording: where the user corrected the agent ("don't do X", "stop Y"), what decisions were made and why, what repeats across sessions. Output is a list of candidates with a label for where each belongs: global layer L0, project CLAUDE.md (L1), working memory MEMORY.md (L2), separate topic file (L3) or new skill.

Requires Python 3 and the claude-memory plugin installed, which contains the session retrieval script. Without it the subagent will not start. If the script fails to detect the project and widens search to all sessions, the subagent stops rather than mining other repositories.

Generalizes each finding to a principle, not an incident. Instead of "on March 15 spent half an hour debugging the hook, turned out CLAUDECODE blocks nested calls" it gives "strip CLAUDECODE before spawning claude -p in subprocesses". Filters duplicates against what is already in memory itself, does not return them to the reader.

What it helps with

  • find user corrections and remarks the agent should remember
  • turn architectural decisions from dialogues into project memory entries
  • detect repeating steps worth extracting into a separate skill
  • populate project memory without duplicating what is already recorded

Example prompts for the agent

  • Check recent sessions and tell me what is worth recording in project memory
  • See if there is anything in recent dialogues that is not in MEMORY.md
  • Extract from the last ten sessions corrections and decisions I made

How to install signal-discoverer

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@Claudest

2Manually: put the files in place

.claude/agents/signal-discoverer.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 signal-discoverer

How to install signal-discoverer in Claude Code?

Run /plugin marketplace add gupsammy/Claudest, then /plugin install claude-memory@Claudest. The subagent file will appear at .claude/agents/signal-discoverer.md.

What does signal-discoverer do?

The subagent analyzes recent project sessions, finds corrections, architectural decisions and repeating patterns worth recording in memory. Output is a list of candidates with a label for where each belongs: global layer, CLAUDE.md, MEMORY.md or separate file.

What does signal-discoverer need to work?

Python 3 and the claude-memory plugin installed, which contains the session retrieval script recent_chats.py. Without it the subagent will not start.

Similar subagents

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

From the same set47

The whole set →
get-pr-comments get-pr-comments collects GitHub pull request feedback and separates required fixes from optional suggestions. Use it to review discussion, formal reviews, and inline notes in one report. CX Codex +1 ★ 276repo stars share-social share-social reshapes a clip to a network's upload spec — frame ratio, resolution, length and bitrate — from built-in presets. CX Codex +1 ★ 276repo stars convert-video convert-video handles video tasks in Claude Code via FFmpeg: remuxes containers, trims clips, adjusts playback speed, and scales footage. CX Codex +1 ★ 276repo stars commit This skill reviews Git changes and creates Conventional Commits. Use it to split unrelated work into separate commits and push when requested. CX Codex +1 ★ 276repo stars skill-lint skill-lint audits SKILL.md files against seven structural quality dimensions, fixing critical defects immediately and flagging minor issues for approval. CX Codex ★ 276repo stars memory-auditor The memory-auditor subagent for Claude Code checks memory against code and Git, flagging stale or duplicate entries. Run it after a major refactor. CX Codex ★ 276repo stars clean-branches clean-branches is a Claude Code skill that finds merged and stale git branches, marks protected ones, and asks before deletion. It helps clear accumulated branch clutter. CX Codex +1 ★ 276repo stars council council launches parallel personas to deliberate on technical questions, examine codebase files, and formulate an opinionated verdict. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open