# signal-discoverer

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/agents/signal-discoverer.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/signal-discoverer

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-memory@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/signal-discoverer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/signal-discoverer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/signal-discoverer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/agents/signal-discoverer.md

## When to use it
- 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
- 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

## Similar
- [emulo](https://affpapa.org/en/nevibecode/plugins/emulo.md) — plugin · ★ 1596 repo stars
- [signal-postmortem](https://affpapa.org/en/nevibecode/skills/signal-postmortem.md) — skill · 3700 installs
- [edge-signal-aggregator](https://affpapa.org/en/nevibecode/skills/edge-signal-aggregator.md) — skill · 3500 installs
- [scope-discoverer](https://affpapa.org/en/nevibecode/agents/scope-discoverer.md) — subagent · ★ 720 repo stars
- [binance-futures-signal-bot](https://affpapa.org/en/nevibecode/skills/binance-futures-signal-bot.md) — skill · 608 installs
- [skill-doctor](https://affpapa.org/en/nevibecode/plugins/skill-doctor.md) — plugin · ★ 30251 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
