qbarev/para-plugin

Áreas

Áreas são responsabilidades contínuas sem data de término — saúde, finanças, a carreira. Não são projetos e nunca são "finalizadas". Uma área que ficou quieta é exatamente o que essa skill existe para revelar: diferentemente de um projeto, nada em uma área anuncia que ela foi negligenciada.

Como as Áreas são organizadas não é decidido aqui. areas.md é o dono do modelo: se há uma camada de agrupamento ou não, como os grupos são chamados, qual campo do frontmatter registra o grupo e para onde uma nova nota deve ir. Esta skill contém o algoritmo e lê o modelo — ela nunca define um nome de grupo fixo nem supõe quantos existem.

Camada base

Leia antes de agir, cada um como ../../para/<arquivo>.md relativo ao diretório base desta skill — eles contêm as regras compartilhadas, não as repita de memória:

• ../../para/paths.md — sempre, incluindo "Idioma": as strings abaixo vêm de lang/<IDIOMA>.md
• .claude/para/areas.md (configuração do cofre, sob REPO_ROOT) — sempre; esta skill não tem sentido sem o modelo
• ../../para/note-format.md — para create; para review sob TASKS = files, "Campos legados"
• ../../para/find-target.md — quando review precisar resolver uma área nomeada
• ../../para/confirm.md — create escreve; review não escreve nada
• ../../para/thresholds.md — para review

Subcomandos

A primeira palavra de $ARGUMENTS escolhe o subcomando: create ou review. Vazio → mostra ambos e pergunta.

---

create <nome> — iniciar uma área

1. Leia Templates/Area.md do disco, literalmente.
2. Decida o grupo. Um dos valores que GROUPS lista em areas.md, a partir da descrição. Se não estiver claro, pergunte — o campo de agrupamento é o que determina para onde o arquivo vai, portanto não pode ficar em branco. Com GROUPING = none esta etapa não se aplica.
3. Preencha o frontmatter conforme a linha Área do esquema em note-format.md: title, tags: [area/<slug>] com o slug preenchido conforme note-format.md, e o campo de agrupamento se o modelo tiver um.
4. Preencha o corpo:
   • a seção common.links — wikilinks para notas relacionadas, caso contrário o - vazio do template.
   • a seção area.current_state — onde essa responsabilidade está agora, nas próprias palavras do usuário a partir da descrição. Em branco se ele não disse nada.
   • a seção area.notes — deixe vazia; ela se preenche com o tempo.
5. Escreva no caminho que PLACEMENT fornece em areas.md, indo mais fundo se a descrição implicar uma subpasta. Verifique se o nome base não colide com algo no cofre primeiro.
6. Relate o caminho e o grupo.

Se a descrição tiver um estado final e uma meta, é um projeto, não uma área — diga isso e ofereça /projects create.

---

review — o que ficou quieto

Somente leitura. Responde "quais das minhas responsabilidades não estou olhando". Com um argumento, revise apenas aquela área; sem nenhum, cada grupo que GROUPS lista — não importa quantos sejam.

1. Percorra Areas/ recursivamente. Para cada nota: caminho, campo de agrupamento e mtime (stat -f '%m %N'). Sob TASKS = files, exclua */Tasks/*: essas são notas de tarefa, não notas de área (note-format.md "Campos legados").

2. Leia o frontmatter de cada uma, e a seção area.current_state quando presente. Não leia os corpos completos — esta é uma varredura, não um resumo de cada nota.

3. Calcule por grupo: quantas notas, quando o grupo foi tocado pela última vez e quais notas individuais ultrapassaram o limite de estagnação de área em thresholds.md, que é deliberadamente muito mais frouxo que o de um projeto.

4. Sinalize apenas o que realmente dispara:

   • um grupo sem nenhuma nota;
   • uma nota além desse limite — diga há quanto tempo, não que é ruim;
   • uma nota que viola PLACEMENT_CHECK — o campo de agrupamento discordando da pasta onde está. Pule quando o modelo define PLACEMENT_CHECK = none;
   • uma nota de área com um slug de etiqueta area/ vazio;
   • uma nota sem frontmatter (anterior à convenção — declare isso, não a migre);
   • wikilinks pendentes na seção common.links;
   • uma área que parece conter trabalho de projeto — uma meta com um estado final. Nomeie-a e ofereça separá-la.

5. Renderize no IDIOMA conforme REVIEW_GROUPING, omitindo qualquer grupo que não tenha nada a relatar, usando as strings areas.review.*. A forma exata da saída está em areas.md — depende do modelo, portanto está escrita onde o modelo está.

6. Não escreva nada. Se a revisão descobrir algo que vale a pena fazer, diga e deixe o usuário decidir.

Notas

• Silêncio em uma área é informação, não um veredito. Relate factualmente — "inalterada por 74 dias", nunca "você a abandonou".
• Uma área raramente é arquivada; responsabilidades contínuas não terminam. Se for solicitado a arquivar uma, isso normalmente significa que a nota está obsoleta, não a responsabilidade — veja /archive.
• Tudo no IDIOMA.