explaingit

mmthebest/research-architect

Analysis updated 2026-05-18

39PythonAudience · researcherComplexity · 2/5LicenseSetup · easy

TLDR

A skill suite for AI coding agents that walks researchers step by step from a raw idea to a structured, evidence-backed academic paper draft.

Mindmap

mindmap
  root((Research Architect))
    What it does
      Structures a paper draft
      Analyzes reference papers
      Audits claims vs evidence
    Tech stack
      Python
      Claude Code skill
      Codex skill
    Use cases
      Narrow a broad research topic
      Build a research spine
      Generate a first manuscript draft
    Audience
      Researchers
      Academic writers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a broad research idea into a focused research question and identified gap.

USE CASE 2

Analyze reference papers as structural examples to design your own study.

USE CASE 3

Generate a first manuscript draft with a citation-supported claim register.

What is it built with?

PythonClaude CodeCodex

How does it compare?

mmthebest/research-architectcybercal/hoic-baselinehadriansecurity/openhack
Stars393939
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity2/54/54/5
Audienceresearcherresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires Claude Code or Codex with the skill copied into its skills directory.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Research Architect is a skill suite for AI coding agents (Claude Code and Codex) that guides researchers through the process of turning a rough topic into a structured academic paper draft. The README is written in both Chinese and English. The tool is installed into the agent's skills directory, after which you trigger the workflow by typing "research-architect" in your agent session. The workflow runs in a defined sequence: start with a raw idea, map it against existing literature, narrow down to a specific research question and gap, build a research spine, design the study, plan experiments and analysis, collect and organize evidence, register claims, gather citation support for each claim, write a section blueprint, produce a first draft, and finally run an audit that generates a revision queue. The output is a folder of structured documents at paper_output/ covering each stage of that trail. A central feature is how the tool treats reference papers. Instead of treating a cited paper as a source of facts to quote, Research Architect analyzes published papers as examples of research design: how they framed the problem, how they controlled the scope, how they defined the gap, how they arranged baselines and controls, how they organized figures, and how they kept each claim within what the evidence actually supports. The goal is to apply that same structural logic to your own work. The problems the tool targets are common in academic writing: a topic that stays too broad, a contribution that sounds significant but lacks an evidence chain, claims that are stronger than the study design justifies, figures that display results without carrying an argument, and references that appear in the introduction but do not actually shape the experimental decisions. The project is MIT licensed and installable from either the repository's dist folder or a provided release tarball.

Copy-paste prompts

Prompt 1
Install Research Architect and run research-architect on my topic
Prompt 2
I have a broad idea: explain how Research Architect would narrow it into a research gap
Prompt 3
Use Research Architect to build a research spine from these reference papers
Prompt 4
Run the Research Architect audit step and show me the revision queue

Frequently asked questions

What is research-architect?

A skill suite for AI coding agents that walks researchers step by step from a raw idea to a structured, evidence-backed academic paper draft.

What language is research-architect written in?

Mainly Python. The stack also includes Python, Claude Code, Codex.

What license does research-architect use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is research-architect to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is research-architect for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.