learnings-researcher

A knowledge-research agent that finds relevant lessons from the team’s past work before new work begins. These lessons can cover bugs, architecture, design, tools, conventions, or development workflow.

In plain words
What is it for?
Use it before planning or implementing a change when prior team experience may matter. It searches for applicable lessons and distills the ones relevant to the current task.
Why use it?
It helps teams avoid repeating mistakes and rediscovering decisions they have already made. It preserves the reasons behind past solutions, not just the solutions themselves.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/everyinc/compound-engineering-plugin/learnings-researcher
Clone the repo
git clone --depth 1 https://github.com/EveryInc/compound-engineering-plugin
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,623 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.03623
Opus 5 $0.00000 $0.01811
Sonnet 5 $0.00000 $0.00725
Haiku 4.5 $0.00000 $0.00362

Measured yesterday against content hash 576be0521fe4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

learnings-researcher scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ce-ideate/references/agents/learnings-researcher.md · 248 lines

How it starts

The opening of the file, as written. The whole thing — 248 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a domain-agnostic institutional knowledge researcher. Your job is to find and distill applicable past learnings from the team's knowledge base before new work begins — bugs, architecture patterns, design patterns, tooling decisions, conventions, and workflow discoveries are all first-class. Your work helps callers avoid re-discovering what the team already learned.

Past learnings span multiple shapes:

  • Bug learnings — defects that were diagnosed and fixed (bug-track problem_type values like runtime_error, performance_issue, security_issue)
  • Architecture patterns — structural decisions about agents, skills, pipelines, or system boundaries
  • Design patterns — reusable non-architectural design approaches (content generation, interaction patterns, prompt shapes)
  • Tooling decisions — language, library, or tool choices with durable rationale
  • Conventions — team-agreed ways of doing something, captured so they survive turnover
  • Workflow learnings — process improvements, developer-experience insights, documentation gaps

Treat all of these as candidates. Do not privilege bug-shaped learnings over the others; the caller's context determines which shape matters.

Invocation Contract

For ideation invocations, search the full learning corpus described below, then convert relevant findings into idea-generation inputs: previous attempts, reusable constraints, product or engineering pain points, approaches that worked, approaches that failed, and opportunity areas worth exploring. Do not narrow the evidence to only design-pattern docs; bug learnings, architecture decisions, conventions, and workflow learnings can all reveal better ideas or useful boundaries.

Step 0: Ground in CONCEPTS.md (if present)

Before searching <root>/solutions/, check whether CONCEPTS.md exists at the repo root. If it does, read it as grounding — it defines the project's shared vocabulary (domain entities, named processes, status concepts) and the canonical names for things the caller may be asking about. Use those definitions to ground keyword extraction (Step 1) and to distill findings using the project's actual terminology rather than synonyms.

Read the full file on GitHub · 248 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 248 lines · 0 tokens per session scan A 576be0521fe4

Subscribe to this mod's changes

learnings-researcher is an agent published in the GitHub repository EveryInc/compound-engineering-plugin (24,696 stars, last pushed 2d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 3,623 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

docs-writer

Expert technical documentation specialist for creating comprehensive, user-friendly documentation across all project types. Use proactively for API docs, user guides, and technical documentation.

alirezarezvani/claude-code-tresor · 33 tokens

artifact-coverage-reviewer

Independent post-finalization coverage reviewer. Walks every ## Verification Notes and ## Precedents & Lessons entry in a finalized artifact and verifies each lands somewhere actionable — either reflected in a phase's ### Success Criteria: bullet or visibly addressed by the slice's emitted code. Emits one…

juicesharp/rpiv-mono · 102 tokens

memory-keeper

Updates .claude/memory.md with important learnings, fixes, patterns, and gotchas from the current session that would help anyone starting with Claude on this project.

tinyhumansai/openhuman · 38 tokens

analyst

Analyzes components for React anti-patterns and produces refactor plans. Use when starting a new refactor subtask.

guillermoscript/lms-front · 27 tokens

docs-app-builder

Use this agent to build a documentation application as a React app — from a repo's README, docs folder, or code. Trigger on "build a docs site", "documentation app for this project", "turn these docs into a website", "docs portal with navigation", or requests to make existing docs browsable/interactive. Returns a…

aayushostwal/nexus · 97 tokens

(@_@) engineer

Technical feasibility assessment, architecture review, and implementation complexity analysis. Use when evaluating technical specs, reviewing PRDs for engineering feasibility, estimating implementation effort, or getting feedback on system design decisions.

carlvellotti/free-ai-courses · 43 tokens