Files
msd-core/scripts/research-profiles.cjs
Jakub Zych a9a7a328e6 refactor: hard-fork GSD -> MSD (Make Software Done)
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD
across contents and paths, upstream package/repo coordinates -> @golem15/msd-core
and golem15com/msd-core. Deep links into upstream history, sibling upstream
packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is.

Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line,
package/plugin identity, regenerated lockfile, install-tree fixtures, derived
registries and benchmark baseline; migration checksum baseline re-locked
(MSD keeps its own install state, so no install had applied the old sums);
sort-order and regex-escaped expectations in tests adjusted.
2026-10-06 01:47:40 +02:00

150 lines
6.1 KiB
JavaScript

#!/usr/bin/env node
'use strict';
/**
* research-profiles.cjs — hand-authored profile table for the 7 researcher agents.
*
* Each profile field is derived verbatim from the agent's current committed state so
* that the initial --check in gen-research-agents.cjs is green by construction.
*
* Fields:
* name — verbatim frontmatter `name:` value
* description — verbatim frontmatter `description:` value
* color — verbatim frontmatter `color:` value
* tools — verbatim frontmatter `tools:` value (single string, comma-separated)
* requiredIncludes — @~/.claude/msd-core/references/<file>.md strings the body MUST contain
* requiredSeamCalls — `msd_run query <cmd>` strings the body MUST contain
* outputContract — strings the body MUST contain (output path, return marker, etc.)
*/
const PROFILES = [
{
name: 'msd-project-researcher',
description:
'Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /msd:new-project or /msd:new-milestone orchestrators.',
color: 'cyan',
tools:
'Read, Write, Bash, Grep, Glob, Skill, WebSearch, WebFetch, mcp__context7__*, mcp__plugin_context7_context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*, mcp__perplexity__*',
requiredIncludes: [
'@~/.claude/msd-core/references/research-documentation-lookup.md',
'@~/.claude/msd-core/references/research-philosophy.md',
'@~/.claude/msd-core/references/research-verification-protocol.md',
],
requiredSeamCalls: [
'msd_run query research-plan',
'msd_run query research-store put',
'msd_run query classify-confidence',
],
outputContract: [
'.planning/research/',
'## RESEARCH COMPLETE',
],
},
{
name: 'msd-phase-researcher',
description:
'Researches how to implement a phase before planning. Produces RESEARCH.md consumed by msd-planner. Spawned by /msd:plan-phase orchestrator.',
color: 'cyan',
tools:
'Read, Write, Edit, Bash, Grep, Glob, Skill, WebSearch, WebFetch, mcp__context7__*, mcp__plugin_context7_context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*, mcp__perplexity__*',
requiredIncludes: [
'@~/.claude/msd-core/references/research-documentation-lookup.md',
'@~/.claude/msd-core/references/research-philosophy.md',
'@~/.claude/msd-core/references/research-verification-protocol.md',
],
requiredSeamCalls: [
'msd_run query research-plan',
'msd_run query research-store put',
'msd_run query classify-confidence',
'msd_run query package-legitimacy check',
],
outputContract: [
'.planning/phases/XX-name/{phase_num}-RESEARCH.md',
'## RESEARCH COMPLETE',
],
},
{
name: 'msd-advisor-researcher',
description:
'Researches a single gray area decision and returns a structured comparison table with rationale. Spawned by discuss-phase advisor mode.',
color: 'cyan',
tools: 'Read, Bash, Grep, Glob, Skill, WebSearch, WebFetch, mcp__context7__*, mcp__plugin_context7_context7__*',
requiredIncludes: [
'@~/.claude/msd-core/references/research-documentation-lookup.md',
],
requiredSeamCalls: [],
outputContract: [
'| Option | Pros | Cons | Complexity | Recommendation |',
'**Rationale:**',
],
},
{
name: 'msd-ai-researcher',
description:
'Researches a chosen AI framework\'s official docs to produce implementation-ready guidance — best practices, syntax, core patterns, and pitfalls distilled for the specific use case. Writes the Framework Quick Reference and Implementation Guidance sections of AI-SPEC.md. Spawned by /msd:ai-integration-phase orchestrator.',
color: 'green',
tools:
'Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, mcp__context7__*, mcp__plugin_context7_context7__*',
requiredIncludes: [
'@~/.claude/msd-core/references/research-documentation-lookup.md',
],
requiredSeamCalls: [],
outputContract: [
'AI-SPEC.md',
'Section 3',
'Section 4',
],
},
{
name: 'msd-domain-researcher',
description:
'Researches the business domain and real-world application context of the AI system being built. Surfaces domain expert evaluation criteria, industry-specific failure modes, regulatory context, and what "good" looks like for practitioners in this field — before the eval-planner turns it into measurable rubrics. Spawned by /msd:ai-integration-phase orchestrator.',
color: 'purple',
tools:
'Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__plugin_context7_context7__*',
requiredIncludes: [
'@~/.claude/msd-core/references/research-documentation-lookup.md',
],
requiredSeamCalls: [],
outputContract: [
'AI-SPEC.md',
'Section 1b',
],
},
{
name: 'msd-ui-researcher',
description:
'Produces UI-SPEC.md design contract for frontend phases. Reads upstream artifacts, detects design system state, asks only unanswered questions. Spawned by /msd:ui-phase orchestrator.',
color: 'purple',
tools:
'Read, Write, Edit, Bash, Grep, Glob, Skill, WebSearch, WebFetch, mcp__context7__*, mcp__plugin_context7_context7__*, mcp__firecrawl__*, mcp__exa__*, mcp__tavily__*, mcp__ref__*, mcp__jina__*',
requiredIncludes: [
'@~/.claude/msd-core/references/research-documentation-lookup.md',
],
requiredSeamCalls: [
'msd_run query commit',
],
outputContract: [
'UI-SPEC.md',
'## UI-SPEC COMPLETE',
],
},
{
name: 'msd-research-synthesizer',
description:
'Synthesizes research outputs from parallel researcher agents into SUMMARY.md. Spawned by /msd:new-project after 4 researcher agents complete.',
color: 'purple',
tools: 'Read, Write, Bash, Skill',
requiredIncludes: [],
requiredSeamCalls: [
'msd_run query commit',
],
outputContract: [
'.planning/research/SUMMARY.md',
'## SYNTHESIS COMPLETE',
],
},
];
module.exports = { PROFILES };