doc-writer

Crea documentos técnicos organizados en la estructura correcta del proyecto.

Triggers

Frases que activan el skill
“crear documento”
“escribir spec”
“documentar esto”
“creame una spec”
“escribime documentación”
“hacer documentación”

¿Qué hace?

Busca estructura de docs existente
Pregunta categoría al usuario
Genera nombre con timestamp
Aplica template según tipo
Crea documento en la ubicación correcta

Categorías disponibles

Categoría	Uso
`specs/`	Especificaciones de features/sistemas
`plans/`	Planes de implementación
`architecture/`	ADRs, decisiones arquitectónicas
`reference/`	Documentación técnica de referencia
`backlog/`	Features pendientes, ideas futuras
`work-in-progress/`	Documentación de trabajo activo

Formato de nombre

YYYY-MM-DD-HH-MM-<feature-name>.md

Ejemplo: 2025-12-25-14-30-user-authentication.md

Templates

Spec Template

# [Feature Name] - Specification

## Overview
Brief description of what this feature does.

## Requirements
- [ ] Requirement 1
- [ ] Requirement 2

## Technical Approach
How this will be implemented.

## Dependencies
- Dependency 1

## Open Questions
- Question 1?

Plan Template

# [Feature Name] - Implementation Plan

## Goal
What we're trying to achieve.

## Steps
1. Step 1
2. Step 2

## Considerations
- Risk/consideration 1

## Success Criteria
- [ ] Criteria 1

ADR Template

# ADR: [Decision Title]

## Status
Proposed | Accepted | Deprecated | Superseded

## Context
What is the issue that we're seeing that is motivating this decision?

## Decision
What is the change that we're proposing and/or doing?

## Consequences
What becomes easier or more difficult because of this change?

Reference Template

# [Topic] Reference

## Overview
What this document covers.

## Details
Technical details and usage.

## Examples
Code or usage examples.

## Related
- Link to related docs

Ejemplo de uso

Usuario: "Escribime una spec para el sistema de autenticación"

1. Buscar docs/: Existe, tiene subcarpetas specs/, plans/
2. Preguntar categoría: "¿En qué categoría va?"
   → Usuario elige specs/
3. Nombre: 2025-12-25-15-30-authentication-system.md
4. Crear: docs/specs/2025-12-25-15-30-authentication-system.md
   con Spec Template

Herramientas disponibles

Read - Leer docs existentes
Glob - Buscar estructura
Grep - Buscar patrones
Write - Crear documento
Edit - Modificar documento
Bash - Crear carpetas
LS - Listar contenido