Doc Writer
Skill para crear documentos tecnicos en la estructura correcta del proyecto.
Proceso de Creacion
Paso 1: Buscar estructura de docs existente
Verificar si existe docs/ y sus subcarpetas.
Paso 2: Determinar categoria
Si existen subcarpetas en docs/: ofrecerlas como opciones.
Si no existen subcarpetas, preguntar al usuario:
| Categoria | Uso |
|---|---|
specs/ | Especificaciones de features/sistemas |
planning/ | Planes de implementacion activos |
archive/ | Documentos completados o superseded |
architecture/ | ADRs, decisiones arquitectonicas |
reference/ | Documentacion tecnica de referencia |
backlog/ | Features pendientes, ideas futuras |
work-in-progress/ | Documentacion de trabajo activo |
Paso 3: Generar nombre de archivo
Formato: YYYY-MM-DD-<feature-name>.md
- Usar fecha actual (sin hora)
<feature-name>en kebab-case, descriptivo, sin espacios- Excepcion: ADRs usan
NNNN-<name>.md(numero secuencial)
Paso 4: Crear el documento
- Crear subcarpeta si no existe
- Leer y aplicar el template correspondiente de
references/:
- Spec: references/spec-template.md - Plan: references/plan-template.md - ADR: references/adr-template.md - Reference: references/reference-template.md
- Escribir archivo en la ubicacion correcta
Recursos
Para ver ejemplos completos de cada tipo de documento, leer los archivos en references/:
| Tipo | Template | Ejemplo |
|---|---|---|
| Spec | references/spec-template.md | references/spec-example.md |
| Plan | references/plan-template.md | references/plan-example.md |
| ADR | references/adr-template.md | references/adr-example.md |
| Reference | references/reference-template.md | references/reference-example.md |