manus-research

manus-research

Claude Code plugin that delegates user stories, requirements gathering, and discovery research to a Manus.im agent and imports the resulting markdown into your project — so Claude Code can use it as input to write the implementation.

PT-BR: plugin que delega criação de histórias de utilizador e levantamento de requisitos a um agente Manus.im e importa o markdown resultante para o teu projecto, para o Claude Code usar como input ao codificar. Ver secção em português.

---

Why

Claude Code is great at writing code from a clear spec, but writing the spec itself — user stories, acceptance criteria, edge cases, non-functional requirements — benefits from a different kind of agent that does deeper discovery work.

This plugin splits the workflow:

Step	Tool	Why
1. Discovery & requirements	Manus.im (/manus-research)	Deep web browsing, stories, BDD criteria
2. Read + synthesise	Claude Code	Reads the markdown, extracts the plan
3. Implementation	Claude Code	Writes the code from the spec

The hand-off is a markdown file in docs/research/ — auditable, reviewable, version-controlled.

---

What you get

• Skill manus-research — Claude knows when to delegate to Manus, how to refine prompts for stories/requirements, and which formats to suggest (INVEST + Given/When/Then, job stories, MoSCoW)
• Slash command /manus-research <feature or prompt> — one-shot stories/requirements workflow
• Bash orchestrator scripts/manus_research.sh — create task → poll (tolerant to transient waiting) → save markdown with YAML frontmatter

Workflow

You ──"/manus-research user stories para checkout com cupons"──▶ Claude
                                                                   │
                                                                   ▼
                                                  Refines prompt with you
                                                  (offers INVEST/BDD format)
                                                                   │
                                                                   ▼
                                                  POST /v2/task.create  ──▶  Manus.im
                                                                                  │
                                                  polls /v2/task.detail            │
                                                                ◀──── status: stopped
                                                                   │
                                                  fetches /v2/task.listMessages
                                                                   │
                                                                   ▼
                                                  docs/research/checkout-cupons.md
                                                                   │
                                                                   ▼
                                                  Claude reads + summarises
                                                                   │
                                                                   ▼
                                                  "Want me to implement these stories now?"
                                                                   │
                                                                   ▼
                                                  Claude writes the code

---

Install

Via marketplace (recommended)

In a Claude Code session:

/plugin marketplace add iaklopes/manus-research-plugin
/plugin install manus-research@manus-research-marketplace
/reload-plugins

Locally for development

git clone https://github.com/iaklopes/manus-research-plugin.git

Then in Claude Code:

/plugin marketplace add /absolute/path/to/manus-research-plugin
/plugin install manus-research@manus-research-marketplace
/reload-plugins

Verify install

Type / in Claude Code; you should see /manus-research in the list. Or run:

/help

---

Setup — Create your Manus API key

One-time step. Required before the plugin can talk to Manus.

1. Open the API integration settings

Direct link (logged into your Manus account):

https://manus.im/app?show_settings=integrations&app_name=api

Alternative path: in the Manus webapp, click your avatar → Settings → Integrations → tab API.

2. Click "Create API Key"