# Research Orchestration

> Agents should invoke this skill for broad multi-claim research projects needing planning, parallel investigation, source merging, gap closure, citation audit, and final synthesis when narrower research skills are insufficient.

- **Type:** Skill
- **Install:** `agentstack add skill-firstp1ck-pi-coding-agent-forge-research-orchestration`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Firstp1ck](https://agentstack.voostack.com/s/firstp1ck)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Firstp1ck](https://github.com/Firstp1ck)
- **Source:** https://github.com/Firstp1ck/pi-coding-agent-forge/tree/main/pi-skill-research-orchestration/skills/research-orchestration

## Install

```sh
agentstack add skill-firstp1ck-pi-coding-agent-forge-research-orchestration
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Research orchestration

Single workflow entry point for **end-to-end** investigations. Detailed rules live in `workspace-researcher/AGENTS.md` (task class, parallel investigation, Deep Research Protocol, citation audit); this skill is the **ordered checklist** for executing them.

## When to use

- Broad question with **several independent sub-questions** or claim clusters.
- Mixed sources (web + docs + papers) and **one** final report or contract output.
- User or delegating agent asked for **deep research** without pointing at a single comparison or single paper.

Prefer **tech-deep-dive**, **competitor-analysis**, or **paper-summarizer** when the task clearly matches one of those shapes.

## Pipeline

1. **Classify depth** — Quick / standard / deep (`AGENTS.md` task-class table). Honor explicit **quick** / **standard** / **deep** or **`/deep-research` quick|standard|max** when the user names them. Set expected tool budget.
2. **Plan sub-questions** — List facets and claims to verify; note which are **high-stakes** (citation audit mandatory). Prefer **internal → official → web** (`AGENTS.md` data source order) when gathering evidence.
3. **Parallel pass** — Batch `web_search` / `web_fetch` per independent facet; optional subagents with **tight scopes** and structured handoff.
4. **Merge** — One synthesis pass; resolve contradictions; prefer primary sources.
5. **Gap closure** — List unresolved material gaps; targeted follow-up searches or explicit “blocked” notes.
6. **Citation audit** — For mandatory cases: every key finding → source row or `unsupported` / `inferential` (`AGENTS.md`).
7. **Deliver** — Default report shape, contract JSON, or consumer-specific packet from `AGENTS.md`; include **Limitations** and **Research trace** when depth is standard/deep or requested (`APPEND_SYSTEM.md`).
8. **Log** — Append a row to `workspace-researcher/MEMORY.md` → **Research History** (topic, task class, tool bucket, major gaps, notable sources).

## Scout scripts → pipeline step

Run from the installed skill directory, or adjust paths to absolute locations. Policy defaults to `./scripts/policy.json` next to the bundled scripts.

| Step | Script | When |
|------|--------|------|
| After depth + topic fixed | `./scripts/scout_query_plan.py` | Emit ordered queries (`Q001`…) and `plan_hash` for the research trace |
| After URL collection | `./scripts/scout_normalize_sources.py` | Dedupe and sort sources before the final table |
| Long / multi-session runs | `./scripts/scout_evidence_bundle.py` | Freeze fetch records (JSONL → `evidence_bundle.json` + `content_sha256`) |
| Before high-stakes delivery | `./scripts/scout_citation_audit.py` | Gate: every `key_findings[]` row has `source_ids` or `unsupported` / `inferential` |

Details and exit codes: `./scripts/README.md`.

## Handoff schema (optional, for subagents)

```markdown
## Scope
[One sentence]

## Findings
- [Bullet + URL]

## Gaps
- [What could not be verified]

## Sources touched
- [Title](URL) — quality flag
```

---

_Scout skill — Orchestrated research pipeline · 2026-04-10_

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Firstp1ck](https://github.com/Firstp1ck)
- **Source:** [Firstp1ck/pi-coding-agent-forge](https://github.com/Firstp1ck/pi-coding-agent-forge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-firstp1ck-pi-coding-agent-forge-research-orchestration
- Seller: https://agentstack.voostack.com/s/firstp1ck
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.