qbarev/para-plugin

Áreas

Las áreas son responsabilidades continuas sin fecha de fin — salud, finanzas, la carrera. No son proyectos y nunca se "terminan". Un área que ha quedado inactiva es lo que este skill existe para sacar a la luz: a diferencia de un proyecto, nada en un área anuncia que ha sido descuidada.

Aquí no se decide cómo se organizan las áreas. areas.md es el modelo: si hay una capa de agrupación, cómo se llaman los grupos, qué campo del frontmatter registra el grupo y dónde se coloca una nota nueva. Este skill contiene el algoritmo y lee el modelo — nunca escribe un nombre de grupo fijo ni asume cuántos hay.

Capa base

Leer antes de actuar, cada uno como ../../para/<archivo>.md relativo al directorio base de este skill — contienen las reglas compartidas, no repetirlas de memoria:

• ../../para/paths.md — siempre, incluido «Idioma»: las cadenas de abajo vienen de lang/<IDIOMA>.md
• .claude/para/areas.md (configuración del vault, bajo REPO_ROOT) — siempre; este skill no tiene sentido sin el modelo
• ../../para/note-format.md — para create; para review bajo TASKS = files, «Campos heredados»
• ../../para/find-target.md — cuando review necesita resolver un área nombrada
• ../../para/confirm.md — create escribe; review no escribe nada
• ../../para/thresholds.md — para review

Subcomandos

La primera palabra de $ARGUMENTS elige el subcomando: create o review. Vacío → mostrar ambos y preguntar.

---

create <nombre> — iniciar un área

1. Leer Templates/Area.md del disco, tal cual.
2. Decidir el grupo. Uno de los valores que GROUPS enumera en areas.md, a partir de la descripción. Si realmente no está claro, preguntar — el campo de agrupación es el que determina dónde va el archivo, así que no puede quedar vacío. Con GROUPING = none este paso no aplica.
3. Rellenar el frontmatter según la fila de Área del esquema en note-format.md: title, tags: [area/<slug>] con el slug rellenado según note-format.md, y el campo de agrupación si el modelo lo tiene.
4. Rellenar el cuerpo:
   • la sección common.links — wikienlaces a notas relacionadas, si no, el guión vacío de la plantilla.
   • la sección area.current_state — dónde se encuentra esta responsabilidad ahora, en palabras del usuario a partir de la descripción. En blanco si no dijo nada.
   • la sección area.notes — dejar vacía; se llena con el tiempo.
5. Escribir en la ruta que PLACEMENT indica en areas.md, yendo más profundo si la descripción implica una subcarpeta. Verificar primero el nombre base para evitar colisiones en todo el vault.
6. Informar la ruta y el grupo.

Si la descripción tiene un estado final y un objetivo, es un proyecto, no un área — decirlo y ofrecer /projects create.

---

review — qué ha quedado inactivo

Solo lectura. Responde "¿cuáles de mis responsabilidades no estoy revisando?". Con un argumento, revisar solo esa área; sin ninguno, cada grupo que GROUPS enumera — sin importar cuántos sean.

1. Recorrer Areas/ recursivamente. Por cada nota: ruta, el campo de agrupación y mtime (stat -f '%m %N'). Bajo TASKS = files, omitir */Tasks/*: son notas de tareas, no notas de área (note-format.md «Campos heredados»).

2. Leer el frontmatter de cada una, y la sección area.current_state donde exista. No leer los cuerpos completos — es un barrido, no un resumen de cada nota.

3. Calcular por grupo: cuántas notas, cuándo se tocó el grupo por última vez, y qué notas individuales han superado el umbral de inactividad en thresholds.md, que es deliberadamente mucho más laxo que el de un proyecto.

4. Señalar solo lo que realmente ocurre:

   • un grupo sin ninguna nota;
   • una nota que supera ese umbral — decir cuánto tiempo, no que está mal;
   • una nota que viola PLACEMENT_CHECK — su campo de agrupación no coincide con la carpeta donde está. Omitir cuando el modelo establece PLACEMENT_CHECK = none;
   • una nota de área con un slug de etiqueta area/ sin rellenar;
   • una nota sin frontmatter (anterior a la convención — indicarlo, no migrarla);
   • wikienlaces rotos en la sección common.links;
   • un área que parece contener trabajo de proyecto — un objetivo con un estado final. Nombrarlo y ofrecer separarlo.

5. Renderizar en LANG según REVIEW_GROUPING, omitiendo cualquier grupo que no tenga nada que informar, con las cadenas areas.review.*. La forma exacta de la salida está en areas.md — depende del modelo, así que está escrita donde está el modelo.

6. No escribir nada. Si la revisión descubre algo que vale la pena hacer, decirlo y dejar que el usuario decida.

Notas

• El silencio en un área es información, no un veredicto. Informarlo de manera objetiva — "sin cambios durante 74 días", nunca "la abandonaste".
• Un área rara vez se archiva; las responsabilidades continuas no terminan. Si se pide archivar una, normalmente significa que la nota está desactualizada, no la responsabilidad — ver /archive.
• Todo en LANG.