grinrus/researcher
skills/researcher/SKILL.md
Generates or refreshes research artifacts and RLM evidence for a ticket. Use when research stage should produce or update canonical RLM outputs. Do not use when the request is initial ticket bootstrap in `idea-new` or implementation planning in `plan-new`.
$ install --global
skillsauthnpx skillsauth add grinrus/ai_driven_dev researcherInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 9:13 PM138.6s1 file scanned
SKILL.md
- name:
- researcher
- description:
- Generates or refreshes research artifacts and RLM evidence for a ticket. Use when research stage should produce or update canonical RLM outputs. Do not use when the request is initial ticket bootstrap in `idea-new` or implementation planning in `plan-new`.
- argument-hint:
- $1 [note...] [--paths path1,path2] [--keywords kw1,kw2] [--note text]
- lang:
- en
- prompt_version:
- 1.2.35
- source_version:
- 1.2.35
- model:
- inherit
- disable-model-invocation:
- true
- user-invocable:
- true
Follow feature-dev-aidd:aidd-core.
Steps
- Set active feature and stage
research. - Run
python3 ${CLAUDE_PLUGIN_ROOT}/skills/researcher/runtime/research.py --ticket <ticket> --auto. - Re-run the same entrypoint with optional overrides (
--paths,--keywords,--note) when targeted refresh is needed. - Validate RLM outputs (
*-rlm-targets.json,*-rlm-manifest.json,*-rlm.worklist.pack.json, optional*-rlm.pack.json). - Run subagent
feature-dev-aidd:researcher. First action: read RLM pack/worklist. - In
--automode run bounded canonical finalize recovery once (rlm_finalize --bootstrap-if-missing) from stage runtime. - If RLM is still pending after auto recovery, return deterministic pending reason + explicit next action (
python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-rlm/runtime/rlm_finalize.py --ticket <ticket>) and append research handoff viapython3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-flow-state/runtime/tasks_derive.py --source research --append. - Ready path: return
/feature-dev-aidd:plan-new <ticket>only when RLM readiness isreadyand the research document is synchronized with the current evidence. - Pending or blocked path: if readiness is not
ready, return the deterministic blocker or pending output instead of guessing a downstream handoff. - Runtime-path safety: execute only canonical runtime commands from this contract (
python3 ${CLAUDE_PLUGIN_ROOT}/skills/.../runtime/...). - Root-relative
/skills/...runtime paths are forbidden; use only${CLAUDE_PLUGIN_ROOT}/skills/.../runtime/....
Command contracts
python3 ${CLAUDE_PLUGIN_ROOT}/skills/researcher/runtime/research.py
- When to run: always as canonical researcher pipeline entrypoint.
- Inputs:
--ticket <ticket>with optional path/keyword/note overrides. - Outputs: research artifacts, stage status, and RLM readiness/handoff markers (
rlm_status,rlm_pack_status). - Failure mode: non-zero exit when required inputs/artifacts are missing or RLM artifact generation fails.
- Next action: fix missing inputs/paths, rerun this entrypoint; in auto mode finalize/bridge runs once, then pending outcomes include deterministic
reason_code+next_action.
Notes
- Planning stage:
AIDD:ACTIONS_LOG: n/a.
Migration policy
- Legacy pre-RLM research context/targets artifacts are ignored by runtime/gates.
- For old workspace state, rerun:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/researcher/runtime/research.py --ticket <ticket> --auto. - If
rlm_statusremainspendingafter bounded auto recovery, hand off to shared owner:python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-rlm/runtime/rlm_finalize.py --ticket <ticket>.
Additional resources
- Research template source: templates/research.template.md (when: drafting or reviewing
aidd/docs/research/<ticket>.md; why: keep artifact shape aligned with canonical workspace template). - Shared RLM owner skill: ../aidd-rlm/SKILL.md (when:
rlm_statusis notreadyor RLM pack is missing; why: run canonical shared RLM API outside stage-local orchestration).
Related Skills
grinrus/tasks-new
tools
VerifiedTrustedCommunity
Derives or refines tasklist items from PRD and plan artifacts. Use when tasklist stage prepares implementation-ready work items. Do not use when the request is plan authoring in `plan-new` or loop execution in `implement`.
5SKILL.mdUpdated Apr 5, 2026
grinrus/status
testing
VerifiedTrustedCommunity
Generates consolidated ticket status summary and key artifact pointers. Use when checking current stage state or handoff readiness. Do not use when the request is diagnostics/inventory from `aidd-observability` or flow-state mutation via `aidd-flow-state`.
5SKILL.mdUpdated Apr 5, 2026
grinrus/spec-interview
testing
VerifiedTrustedCommunity
Collects missing spec inputs and synchronizes answers into `spec.yaml`. Use when review-spec leaves unresolved specification fields. Do not use when the request is readiness gating in `review-spec` or task derivation in `tasks-new`.
5SKILL.mdUpdated Apr 5, 2026
grinrus/review
testing
VerifiedTrustedCommunity
Runs review-stage validation for scope changes, findings, and follow-up task derivation. Use when review stage needs verdict and handoff tasks. Do not use when the request is direct implementation execution in `implement` or QA validation in `qa`.
5SKILL.mdUpdated Apr 5, 2026