source-command-hdd-research

Name: source-command-hdd-research
Author: Kastalien-Research/thoughtbox

$npx mdskill add Kastalien-Research/thoughtbox/source-command-hdd-research

Routes HDD research tasks to the research-brief module.

Solves the need to build context and hypotheses for ADR initiatives.
Depends on the research-brief module and delegation-handoff schema.
Uses task goal, paths to inspect, and acceptance checks to guide research.
Outputs a research summary with hypotheses, unknowns, and risks for approval.

SKILL.md

.github/skills/source-command-hdd-researchView on GitHub ↗

---
name: "source-command-hdd-research"
description: "Phase 1 router for HDD research"
---

# source-command-hdd-research

Use this skill when the user asks to run the migrated source command `hdd-research`.

## Command Template

# /hdd:research

Build context and hypotheses for a new ADR initiative.

## Usage

```bash
/hdd:research "<task-goal>"
```

## Delegation

- Primary module: `./modules/research-brief.md`
- Handoff schema: `../_contracts/delegation-handoff-schema.md`

## Inputs

- `task_goal`
- `paths_to_inspect` (accepted ADRs, rejected ADRs, staging ADRs, relevant specs)
- `acceptance_checks`

## Steps

1. Delegate research to the module using path-scoped inputs.
2. Capture hypotheses, unknowns, and open risks.
3. Ask for user approval before moving to ADR staging.

## Output

- Research summary with SOFT hypotheses and blockers.

More from Kastalien-Research/thoughtbox

Skill	Description
assumptions	Manage the assumption registry — track, verify, and query assumptions about external dependencies and system behavior. Prevents costly rediscovery of known failures.
capture-learning	Capture significant learnings from the current work session. Structures insights for future sessions and updates agent memory.
claude-opus-4-6-prompting	>
claude-prompt	Write or improve prompts for Claude using Anthropic's official best practices. Creates system prompts, agent prompts, tool descriptions, and MCP resource templates. Pass an existing prompt to improve it, or describe what you need to create one from scratch.
coolify-compose	Convert Docker Compose files to Coolify templates. Use when creating Coolify services, converting docker-compose.yml for Coolify deployment, working with SERVICE_URL/SERVICE_PASSWORD magic variables, or troubleshooting Coolify compose errors.
crafting-effective-readmes	Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.
diagram	Generate architecture diagrams for a codebase subsystem or module. Explores source files and produces Mermaid diagrams in docs/.
diataxis	Structure, classify, and write documentation using the Diátaxis framework. Use when writing docs, README files, guides, tutorials, how-to guides, API references, or organizing documentation architecture. Also use when asked to improve documentation, restructure docs, decide what type of doc to write, or classify existing content. Covers tutorials, how-to guides, reference, and explanation.
escalate	Format a structured escalation to the human decision-maker (Chief Agentic). Use when hitting an escalation threshold.
frontend-design-principles	Create polished, intentional frontend interfaces. Use this skill when building any UI — dashboards, admin panels, landing pages, marketing sites, or web applications. Routes to specialized guidance based on context.