tdk-utils

Use this agent when you need to conduct comprehensive research on software development topics, including investigating new technologies, finding documentation, exploring best practices, or gathering information about plugins, packages, and open source projects. This agent excels at synthesizing information from multiple sources including searches, website content, YouTube videos, and technical documentation to produce detailed research reports. <example>Context: The user needs to research a new technology stack for their project. user: "I need to understand the latest developments in React Server Components and best practices for implementation" assistant: "I'll use the researcher agent to conduct comprehensive research on React Server Components, including latest updates, best practices, and implementation guides." <commentary>Since the user needs in-depth research on a technical topic, use the Task tool to launch the researcher agent to gather information from multiple sources and create a detailed report.</commentary></example> <example>Context: The user wants to find the best authentication libraries for their Flutter app. user: "Research the top authentication solutions for Flutter apps with biometric support" assistant: "Let me deploy the researcher agent to investigate authentication libraries for Flutter with biometric capabilities." <commentary>The user needs research on specific technical requirements, so use the researcher agent to search for relevant packages, documentation, and implementation examples.</commentary></example> <example>Context: The user needs to understand security best practices for API development. user: "What are the current best practices for securing REST APIs in 2024?" assistant: "I'll engage the researcher agent to research current API security best practices and compile a comprehensive report." <commentary>This requires thorough research on security practices, so use the researcher agent to gather information from authoritative sources and create a detailed summary.</commentary></example>

Hostile reliability reviewer for /tdk-plan red-team workflow. Spawned in parallel with tdk-red-team-skeptic and tdk-red-team-security. Reads plan.md + phase-*.md, surfaces failure modes, rollback gaps, missing tests, deployment-order risks. Returns strict JSON findings; never writes files.

Hostile security reviewer for /tdk-plan red-team workflow. Spawned in parallel with tdk-red-team-skeptic and tdk-red-team-reliability. Reads plan.md + phase-*.md, surfaces OWASP-class vulnerabilities, auth/authz holes, data-exposure paths, supply-chain risks. Returns strict JSON findings; never writes files.

Hostile reviewer (assumption destroyer) for /tdk-plan red-team workflow. Spawned in parallel with tdk-red-team-security and tdk-red-team-reliability. Reads plan.md + phase-*.md, surfaces unstated assumptions, missing dependencies, integration gaps, and undefined error paths. Returns strict JSON findings; never writes files.

Codebase navigation specialist. Reads pre-processed Tier 1 structural JSON + samples a small file budget to produce a markdown navigation report. Use ONLY when caller has already run Tier 1 (the tdk-scout TS resolver) and provides tier1_json_path; do NOT invoke directly without that contract field. Typical caller: the tdk-scout skill orchestrator.

Pack repositories into AI-friendly files with Repomix (XML, Markdown, plain text). Use for codebase snapshots, LLM context preparation, security audits, third-party library analysis.

Research technical solutions, analyze architectures, gather requirements thoroughly. Use for technology evaluation, best practices research, solution design, scalability/security/maintainability analysis.

Split large markdown documents into smaller files by heading level. Replaces extracted sections with Obsidian [[wikilinks]] in the original. Use when: document exceeds 200+ lines, needs modularization, or sections should be independently navigable.

Load project configuration and resolve feature directory from validated TASK_ID. Called by: tdk-analyze, tdk-checklist, tdk-clarify, tdk-implement, tdk-plan, tdk-specify (supports --fast mode). NOT user-invocable.

Codebase navigation skill (S4 hierarchical 2-tier). Pre-process a repomix pack via deterministic TS Tier 1 parser, then dispatch the tdk-scout-runner agent (Tier 2) to produce a markdown navigation report (file list + descriptions + unresolved questions). Use for understanding unfamiliar codebases, locating task-relevant files, or pre-processing for downstream skills like tdk-sub-workspace-docs.