Dev Kit Research

Phase 3: Documentation

• Create Knowledge File: Generate a new markdown file in .dev-kit/knowledge/.
• Filename Format: brief-topic-name.md (e.g., better-auth-patterns.md, tailwind-theming-strategy.md).
• Content Structure:
  • Overview: High-level summary of the technology/topic.
  • Key Concepts: Core building blocks and terminology.
  • Best Practices: Recommended patterns for this specific project.
  • Implementation Tips: Code snippets, configuration examples, and CLI commands.
  • References: Links to official docs or external resources.

Phase 4: Integration

• Update TECH.md: If the research results in a configuration change or a new standard, propose updates to .dev-kit/docs/TECH.md.
• Link Tickets: If this research was triggered by a ticket, update the ticket with a link to the new knowledge file and suggest next implementation steps.

Quality Rules

• Actionable: Findings should directly help developers implement features or resolve bugs.
• Context-Specific: Don't just copy-paste generic docs; explain why this matters for the current project.
• Concise: Use bullet points and code blocks over long paragraphs.
• Verified: Ensure code snippets and commands actually work in the project's environment.

Inputs

• topic (optional): A specific technology or concept to research.
• ticket (optional): A Research-category ticket from .dev-kit/tickets/.

Output Expectations

• New or updated markdown file(s) in .dev-kit/knowledge/.
• Proactive updates to project docs if relevant.
• Summary of findings provided to the user.

Example Usage

• /dev-kit.research topic="Better Auth with Next.js 16"
• /dev-kit.research ticket=PROJ-005 (where PROJ-005 is a research ticket for Stripe Connect)

Run this workflow whenever the tech stack is ambiguous, when a research ticket is assigned, or when starting with a new complex library.