research

Consolidate codebase and external evidence into a structured research.md.

1|1|Updated Feb 25, 2025
One-click install
npx skills add https://github.com/JamSuite/jim --skill research-jamsuite
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research
Source: https://github.com/JamSuite/jim/tree/main/skills/research
Command: npx skills add https://github.com/JamSuite/jim --skill research-jamsuite

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Investigates codebase, external docs, and technical landscape to produce a grounded research.md for feasibility assessments, planning context, and informed decision-making.

Core Features & Use Cases

  • Collects local signals from the repository (anchors, code patterns, tests) and external sources to form a cohesive evidence base for specs and architecture.
  • Outputs a structured research.md that can be used by PMs, architects, and engineers to guide planning and risk assessment.
  • Supports differential updates and alignment checks against existing plans or visions, ensuring research remains actionable.

Quick Start

Ask Jim to research a spec directory or topic to generate a grounded research.md.

Frequently Asked Questions about research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a research brief for codebase feasibility and planning context?

To generate a research brief, the Skill consolidates evidence from local codebase anchors, external docs, and the technical landscape into a structured research.md. It formats results using a template with frontmatter spec references and status markers.

What is a grounded research.md and when do I need it for spec evaluation?

A grounded research.md is a structured document containing consolidated evidence from your repository and external sources. You need it when evaluating spec feasibility, gathering planning context, or assessing technical risks before architecture decisions.

How to research local codebase patterns and external docs for risk management?

Research local codebase patterns by identifying code anchors, tests, and existing plans, then consolidating them with external documentation. This forms a cohesive evidence base for risk management and differential updates against existing visions.

Can I update an existing research.md without losing previous local archaeology findings?

Yes, you can update an existing research.md because the Skill respects existing research and supports differential updates. It performs alignment checks against existing plans or visions to ensure your local archaeology findings remain actionable.

What's the best way to document spec feasibility before starting architecture planning?

The best way to document spec feasibility is to collect local signals from your repository and external sources into a research.md. This provides PMs, architects, and engineers with a grounded evidence base for planning and risk assessment.

Does the research output require a specific directory or output location?

Yes, the research output requires a defined output location to generate the research.md file. You must specify a spec directory or topic so the Skill can place the formatted results with the correct frontmatter and status markers.