One-click install
npx skills add https://github.com/ssiumha/dots --skill dev-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-docs
Source: https://github.com/ssiumha/dots/tree/main/prompts/skills/dev-docs
Command: npx skills add https://github.com/ssiumha/dots --skill dev-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and templates (resource) components.

What problem does it solve?

This Skill addresses the challenge of losing context during large or complex development tasks, especially when switching between projects or resuming work after a break. It ensures that all relevant information—plans, architectural notes, decisions, and tasks—is systematically captured and easily retrievable, boosting developer productivity and reducing cognitive load.

Core Features & Use Cases

  • Structured Task Management: Organizes development tasks into three core documents: plan.md (goals, steps, risks), context.md (key files, architectural notes, decisions), and tasks.md (checklists, blockers). Use it when starting a new feature or tackling a complex bugfix to keep all details organized.
  • Context Preservation: Automatically captures and updates critical information like architectural decisions, key files, and important notes. This is invaluable when you need to quickly re-engage with a task after a period of inactivity or hand over work to another developer.
  • Seamless Integration with Living Docs: Facilitates the promotion of completed task knowledge (e.g., significant decisions, reusable architectural patterns) into the permanent project knowledge base. Use it upon task completion to ensure valuable insights are not lost and contribute to the team's collective knowledge.

Quick Start

Start a new dev-docs task for 'feature-user-profile-avatar-upload', and outline the main goals and phases.

Frequently Asked Questions about dev-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain development context across complex tasks without losing track of decisions?

Maintain development context by structuring tasks into three linked documents: plan.md for goals and phases, context.md for architectural notes and key files, and tasks.md for checklists and blockers. This triplet workflow captures and persists critical information so you can resume work after switching projects or taking a break without cognitive overhead.

What's the best way to organize documentation for large, complex development projects?

Organize development documentation using a three-document structure per task under project directories with kebab-case naming. Frontmatter and templates enforce consistency, enabling automated lifecycle management from task start through archival and integration with your project knowledge base.

How do I hand off in-progress development work while preserving all context?

Structure task context with plan.md, context.md, and tasks.md documents that capture goals, architectural decisions, key files, and progress. This systematic capture enables another developer to quickly re-engage with your work, reducing handoff friction and ensuring nothing is lost.

Can I integrate task documentation with a living knowledge base?

Yes. This workflow enables seamless integration with Living Docs, allowing you to promote completed task knowledge—such as architectural patterns and significant decisions—into your permanent project knowledge base upon task completion.

What documentation should I capture when starting a new feature or complex bugfix?

When starting a feature or bugfix, document goals and phases in plan.md, capture architectural notes and key files in context.md, and outline task checklists with blockers in tasks.md. This structured approach keeps all details organized and retrievable throughout development.

Why do development teams lose context on large projects, and how is it prevented?

Teams lose context when switching between projects or resuming after breaks because critical information—plans, decisions, and task status—scatters across tools. A three-document workflow with systematic capture and retrieval prevents this loss and reduces developer cognitive load.