dd-harness 0.29.0 → 0.30.0

package/dist/escreve-config.js

@@ -126,4 +126,8 @@ de ler código, responder ou planejar.
 
 Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
 desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
-válido — não crie fase sem o usuário pedir.`;
+válido — não crie fase sem o usuário pedir.
+
+E \`listar_skills\`: são os procedimentos deste projeto. **Invoque a que couber
+ANTES de fazer o trabalho, não depois** — skill lida no fim vira revisão do que
+já saiu errado. A política diz quais são obrigatórias e quando.`;

package/dist/index.js

@@ -922,6 +922,31 @@ async function comandoPolitica(argv) {
  * so faria o Claude Code registrar falha no transcript — que ninguem le — enquanto a
  * sessao seguiria sem saber que esta sem protocolo.
  */
+/**
+ * Lembra que ha skills — so quando a POLITICA nao lembra.
+ *
+ * Medido em uso real: a skill aparecia na listagem do host, a descricao estava no
+ * contexto, e mesmo assim nao era invocada. Estar disponivel nao e ser usada.
+ *
+ * O conserto de verdade e a politica dizer quando cada skill e obrigatoria — e o passo 5
+ * do briefing agora manda escrever isso. Mas projeto ja briefado nao passa mais por la, e
+ * a politica dele continua sem a regra. Esta linha cobre esse intervalo.
+ *
+ * CALA quando a politica ja fala de skill: repetir o que ela diz treina a ler a politica
+ * como se fosse opcional, e a politica e a unica coisa aqui que o agente trata como
+ * regra. A deteccao e grosseira de proposito — qualquer mencao basta, porque o custo de
+ * calar a mais e zero e o de repetir e corroer a autoridade do texto principal.
+ */
+function lembreteDeSkills(politica) {
+    if (/skill/i.test(politica))
+        return "";
+    return ("\n\n---\n\n" +
+        "Este projeto pode ter **skills** — procedimentos escritos para o trabalho que se " +
+        "repete. `listar_skills` mostra quais, e `ler_skill` traz o passo a passo.\n\n" +
+        "Invoque a que couber **antes** de fazer o trabalho, não depois: skill lida no fim " +
+        "vira revisão do que já saiu errado. Se a política não disser quais são " +
+        "obrigatórias, vale propor ao usuário que ela passe a dizer.");
+}
 function contextoDaSessao(r, worker) {
     const base = { hookEventName: "SessionStart" };
     const fila = avisoDaFila(r.esperandoIndexacao ?? 0, worker);
@@ -934,6 +959,7 @@ function contextoDaSessao(r, worker) {
                 // Depois da politica, antes dos avisos operacionais: o roadmap e contexto de
                 // trabalho, a fila e ruido de infraestrutura. Vazio quando nao ha fase aberta.
                 blocoDeSessao(r.roadmap) +
+                lembreteDeSkills(r.conteudo) +
                 fila,
         };
     }
@@ -980,6 +1006,15 @@ function contextoDaSessao(r, worker) {
                 "sessão, e ao terminá-la o agente **propõe** concluí-la (`editar_fase` com " +
                 "`status: \"concluida\"`) — nunca conclui por conta própria, porque quem decide " +
                 "que uma fase acabou é o usuário.\n" +
+                // Medido em uso real: a skill aparecia na listagem, a descricao estava no
+                // contexto, e mesmo assim nao era invocada. Estar disponivel nao e ser usada — o
+                // que faz o agente parar e invocar e a POLITICA dizer que e obrigatorio, porque
+                // ela e o unico texto que ele trata como regra em vez de catalogo.
+                "   Inclua também QUANDO cada skill é obrigatória — o gatilho, não a lista. " +
+                "Chame `listar_skills` para ver o que o projeto tem e escreva uma linha por " +
+                "skill que não pode ser pulada. Exemplo: \"ao escrever ou editar código, " +
+                "invoque `como-desenvolver` ANTES de começar\". Sem isso a skill existe, " +
+                "aparece na listagem e mesmo assim não é usada — foi medido.\n" +
                 "6. Depois de escrever os dois, sobrescreva o `CLAUDE.md` da raiz com um " +
                 "ponteiro curto para a política deste serviço — a verdade passa a morar " +
                 "aqui, e o `CLAUDE.md` local nunca mais precisa ser editado à mão. O ponteiro " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dd-harness",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "type": "module",
   "description": "Cliente do dd-harness: politica no inicio da sessao, e memoria por busca — nada em disco. Sem dependencia: fetch, crypto e fs sao do Node.",
   "license": "UNLICENSED",