Skill

domain-research

Research a domain end-to-end before scaffolding an agentic system for it. Use when the user asks to "research [domain]", "learn about [field]", "what are the best practices for X", "survey the tools for Y", "what MCPs exist for Z", "before we build the agent, understand [topic]", or when kicking off a new /agents-architect:new for an unfamiliar domain. Covers methodology: taxonomy → tools → MCPs → idioms → anti-patterns → eval cases. Produces DOMAIN.md.

npx claudepluginhub ibrahim-3d/agents-architect --plugin agents-architect

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Before you build an agentic system for a domain, you research the domain the way a senior practitioner would brief a new hire. Output: a single `DOMAIN.md` that later agents consume.

SKILL.md

Similar Skills

cache-components

139.4k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

pdf

131.6k

Processes PDFs: extracts text/tables/images, merges/splits/rotates pages, adds watermarks, creates/fills forms, encrypts/decrypts, OCRs scans. Activates on PDF mentions or output requests.

11 files

document-skills

Stats

Stars0

Forks0

Last CommitApr 14, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Domain Research

Before you build an agentic system for a domain, you research the domain the way a senior practitioner would brief a new hire. Output: a single DOMAIN.md that later agents consume.

Research layers

Taxonomy: core concepts, sub-fields, canonical workflows. (e.g., 3D modeling → modeling / UV / rigging / animation / shading / lighting / rendering / post.)
Tools: the 5-10 dominant programs, libraries, APIs. Note open-source vs. commercial, CLI vs. GUI, scriptable vs. not.
MCPs / programmatic interfaces: what's already exposed via MCP? What's scriptable via SDK? What requires GUI automation?
Idioms & conventions: how do practitioners name things, structure projects, version files, share work? (e.g., Blender → bpy API, collections, linked libraries.)
Best practices: top 10 rules practitioners would cite unprompted. Sourced from docs, style guides, community consensus.
Anti-patterns: top 10 ways novices and AI go wrong. Common failure modes.
Eval seeds: 10 concrete tasks that an agent in this domain should ace, and 10 harder ones it should survive.

Research methodology

WebSearch for current-year docs, "best practices ", "[tool] Python API", "anti-patterns in ".
WebFetch the official docs, top 3 community style guides, one textbook if available.
MCP registry search (search_mcp_registry) for each major tool.
arxiv / scholar (if connected) for recent methodology papers.
Cross-check sources: a practice is only "consensus" if it appears in 3+ independent sources.

DOMAIN.md structure

# Domain: <name>

## One-line definition

## Taxonomy
- Concept A — what it is, when it matters.
- ...

## Dominant tools
| Tool | License | Interface | Notes |
|---|---|---|---|

## Available MCPs
| MCP | Registry ID | Capabilities | Auth |
|---|---|---|---|

## Idioms
- Naming: ...
- Project layout: ...
- File versioning: ...

## Best practices (prioritized)
1. ...

## Anti-patterns
1. ...

## Eval seeds
### Core (must pass)
1. ...

### Stretch
1. ...

## Sources
- [Doc title](url)
- ...

Scope discipline

Time-box: 15-20 min of research per pass. Go deeper only when the user specifies a narrow sub-domain.
Breadth before depth: taxonomy + tool list first. Drill into the top 2-3 tools only.
Cite sources. Every best-practice bullet has a source link.

Output

Produce DOMAIN.md in the architect session's working directory. Return a 10-line summary to the orchestrator: scope, top 3 tools, recommended MCPs, top 3 anti-patterns to encode as red-lines, eval seed count.