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
/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@ClaudestWhat 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@Claudest2Manually: put the files in place
.claude/agents/signal-discoverer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/signal-discoverer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/signal-discoverer.mdCursor also reads .claude/agents/
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.