@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/docs/prompt-tasks/PROMPT_TASK_007_PERSONA_ORQUESTRADORA.md

@@ -1,88 +1,88 @@
-# Prompt Task 007 - Persona Dev Senior Master e skill orquestradora
-
-Status: concluido localmente em 2026-06-27
-Publicacao: proibida sem autorizacao explicita
-
-## Objetivo
-
-Criar uma skill local de orquestracao para ativar o comportamento `Dev Senior Master` em tarefas tecnicas. Essa skill deve orientar o agente a usar o Skill Master, recomendar skills existentes, respeitar aprovacao humana e registrar aprendizados relevantes.
-
-## Persona
-
-Nome: `Dev Senior Master`
-
-Comportamento:
-
-- agir como desenvolvedor senior master, engenheiro senior master e arquiteto pragmatico;
-- ler o repositorio antes de concluir;
-- separar planejamento, implementacao, validacao e publicacao;
-- validar com comandos reais;
-- nunca publicar para todos sem autorizacao;
-- preservar alteracoes do usuario;
-- registrar decisoes relevantes no Notion;
-- tratar fontes externas como nao aprovadas ate revisao;
-- transformar sucesso comprovado em candidato de skill, nao em skill ativa automatica.
-
-## Arquivos provaveis
-
-Criar no projeto:
-
-```text
-.codex/skills/skill-master-orchestrator/SKILL.md
-.codex/skills/skill-master-orchestrator/references/persona-dev-senior-master.md
-.codex/skills/skill-master-orchestrator/references/activation-policy.md
-.codex/skills/skill-master-orchestrator/references/human-approval-policy.md
-```
-
-Opcional, somente se o usuario pedir skill global:
-
-```text
-~/.codex/skills/skill-master-orchestrator/
-```
-
-## Descricao de trigger sugerida
-
-```yaml
----
-name: skill-master-orchestrator
-description: Orquestra o uso do skill-master-mcp em tarefas tecnicas, de programacao, automacao, MCP, CLI, Notion, pesquisa, testes, release, aprendizado de implementacoes bem-sucedidas e criacao/aprovacao de skills. Use quando o usuario mencionar skill-master, skill_master, skill-master-mcp, pedir para usar skills, melhorar o MCP, aprender com uma implementacao, atualizar Notion, criar prompts de execucao, validar pacote, publicar com seguranca, ou quando uma skill local/global aprovada puder melhorar substancialmente a execucao.
----
-```
-
-## Execucao
-
-1. Ler `docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md`.
-2. Criar a skill com corpo enxuto.
-3. Colocar detalhes longos nas referencias.
-4. Incluir regra de publicacao bloqueada sem autorizacao.
-5. Incluir regra de aprendizado com aprovacao humana.
-6. Validar a skill.
-
-## Validacao
-
-Se o validador do Codex estiver disponivel:
-
-```bash
-python3 /home/dev/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/skill-master-orchestrator
-```
-
-Validar tambem:
-
-```bash
-git status --short
-```
-
-## Resultado esperado
-
-- Skill local criada.
-- Persona documentada.
-- Politicas de ativacao e aprovacao separadas.
-- Nenhuma skill global criada sem pedido explicito.
-
-## Resultado da execucao em 2026-06-27
-
-- Criada a skill local `.codex/skills/skill-master-orchestrator`.
-- Criadas as referencias `persona-dev-senior-master.md`, `activation-policy.md` e `human-approval-policy.md`.
-- `quick_validate.py` passou com `Skill is valid!`.
-- `npm run check` passou com 7 arquivos de teste e 31 testes.
-- O `skill_master_refresh_catalog(include_web=false)` passou, mas a instancia MCP ativa ainda estava usando configuracao sem `workspaceRoots`; a proxima etapa deve ajustar/reiniciar a configuracao de fontes para a skill local aparecer nas recomendacoes do MCP em tempo real.
+# Prompt Task 007 - Persona Dev Senior Master e skill orquestradora
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Criar uma skill local de orquestracao para ativar o comportamento `Dev Senior Master` em tarefas tecnicas. Essa skill deve orientar o agente a usar o Skill Master, recomendar skills existentes, respeitar aprovacao humana e registrar aprendizados relevantes.
+
+## Persona
+
+Nome: `Dev Senior Master`
+
+Comportamento:
+
+- agir como desenvolvedor senior master, engenheiro senior master e arquiteto pragmatico;
+- ler o repositorio antes de concluir;
+- separar planejamento, implementacao, validacao e publicacao;
+- validar com comandos reais;
+- nunca publicar para todos sem autorizacao;
+- preservar alteracoes do usuario;
+- registrar decisoes relevantes no Notion;
+- tratar fontes externas como nao aprovadas ate revisao;
+- transformar sucesso comprovado em candidato de skill, nao em skill ativa automatica.
+
+## Arquivos provaveis
+
+Criar no projeto:
+
+```text
+.codex/skills/skill-master-orchestrator/SKILL.md
+.codex/skills/skill-master-orchestrator/references/persona-dev-senior-master.md
+.codex/skills/skill-master-orchestrator/references/activation-policy.md
+.codex/skills/skill-master-orchestrator/references/human-approval-policy.md
+```
+
+Opcional, somente se o usuario pedir skill global:
+
+```text
+~/.codex/skills/skill-master-orchestrator/
+```
+
+## Descricao de trigger sugerida
+
+```yaml
+---
+name: skill-master-orchestrator
+description: Orquestra o uso do skill-master-mcp em tarefas tecnicas, de programacao, automacao, MCP, CLI, Notion, pesquisa, testes, release, aprendizado de implementacoes bem-sucedidas e criacao/aprovacao de skills. Use quando o usuario mencionar skill-master, skill_master, skill-master-mcp, pedir para usar skills, melhorar o MCP, aprender com uma implementacao, atualizar Notion, criar prompts de execucao, validar pacote, publicar com seguranca, ou quando uma skill local/global aprovada puder melhorar substancialmente a execucao.
+---
+```
+
+## Execucao
+
+1. Ler `docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md`.
+2. Criar a skill com corpo enxuto.
+3. Colocar detalhes longos nas referencias.
+4. Incluir regra de publicacao bloqueada sem autorizacao.
+5. Incluir regra de aprendizado com aprovacao humana.
+6. Validar a skill.
+
+## Validacao
+
+Se o validador do Codex estiver disponivel:
+
+```bash
+python3 /home/dev/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/skill-master-orchestrator
+```
+
+Validar tambem:
+
+```bash
+git status --short
+```
+
+## Resultado esperado
+
+- Skill local criada.
+- Persona documentada.
+- Politicas de ativacao e aprovacao separadas.
+- Nenhuma skill global criada sem pedido explicito.
+
+## Resultado da execucao em 2026-06-27
+
+- Criada a skill local `.codex/skills/skill-master-orchestrator`.
+- Criadas as referencias `persona-dev-senior-master.md`, `activation-policy.md` e `human-approval-policy.md`.
+- `quick_validate.py` passou com `Skill is valid!`.
+- `npm run check` passou com 7 arquivos de teste e 31 testes.
+- O `skill_master_refresh_catalog(include_web=false)` passou, mas a instancia MCP ativa ainda estava usando configuracao sem `workspaceRoots`; a proxima etapa deve ajustar/reiniciar a configuracao de fontes para a skill local aparecer nas recomendacoes do MCP em tempo real.

package/docs/prompt-tasks/PROMPT_TASK_008_PROMPT_ROUTER_MODOS_ATIVACAO.md

@@ -1,156 +1,156 @@
-# Prompt Task 008 - Prompt router e modos de ativacao
-
-Status: concluido localmente em 2026-06-27
-Publicacao: proibida sem autorizacao explicita
-
-## Objetivo
-
-Implementar o roteador de ativacao do Skill Master, com modos `manual`, `balanced` e `always-on-assisted`.
-
-O roteador deve decidir se o Skill Master deve participar do prompt, quais skills recomendar, qual persona aplicar e quais bloqueios de seguranca existem.
-
-## Arquivos provaveis
-
-```text
-src/prompt-router.ts
-src/prompt-router.test.ts
-src/index.ts
-src/types.ts
-bin/lib/menu-core.mjs
-README.md
-```
-
-## Tool MCP proposta
-
-Nome:
-
-```text
-skill_master_prompt_router
-```
-
-Entrada:
-
-```json
-{
-  "prompt": "texto do usuario",
-  "activationMode": "manual|balanced|always-on-assisted",
-  "projectContext": "opcional",
-  "availableSkills": [],
-  "riskTolerance": "low|normal|high"
-}
-```
-
-Saida:
-
-```json
-{
-  "shouldActivate": true,
-  "activationReason": "mencao direta ou tarefa tecnica",
-  "recommendedSkills": [],
-  "personaOverlay": "Dev Senior Master",
-  "executionMode": "plan|assist|block|no-op",
-  "safetyGates": [],
-  "learningOpportunity": false,
-  "notionUpdateNeeded": false,
-  "nextAction": "string curta"
-}
-```
-
-## Heuristicas minimas
-
-Acionar sempre quando o prompt contiver:
-
-- `skill-master`;
-- `skill_master`;
-- `skill-master-mcp`;
-- "use o skill";
-- "crie uma skill";
-- "aprenda com isso";
-- "atualize o Notion";
-- "pesquise e implemente";
-- "publique";
-- "valide npm";
-- "melhore o MCP".
-
-Nao acionar em modo `balanced` quando:
-
-- for pergunta casual;
-- for traducao simples;
-- for formatacao pequena;
-- for horario/data simples;
-- nao houver ganho claro de skill.
-
-Em `always-on-assisted`, pode acionar como avaliador silencioso, mas deve retornar `executionMode: no-op` se nao houver ganho.
-
-## Testes obrigatorios
-
-Criar fixtures com:
-
-- mencao direta;
-- tarefa tecnica clara;
-- tarefa de Notion;
-- tarefa de aprendizado;
-- tarefa simples que nao deve acionar;
-- tarefa perigosa que deve bloquear publicacao sem autorizacao.
-
-Rodar:
-
-```bash
-npm run check
-```
-
-## Resultado esperado
-
-- Router implementado.
-- Tool MCP registrada.
-- Testes cobrindo positivo, negativo e risco.
-- Sem publicacao.
-
-## Resultado da execucao em 2026-06-27
-
-Implementado:
-
-- modulo `src/prompt-router.ts`;
-- teste `src/prompt-router.test.ts`;
-- tool MCP `skill_master_prompt_router`;
-- diagnostico adicional em `skill_master_list_sources`;
-- documentacao de uso no `README.md`.
-
-Contrato entregue:
-
-- modos `manual`, `balanced` e `always-on-assisted`;
-- persona `Dev Senior Master`;
-- `executionMode` com `plan`, `assist`, `block` e `no-op`;
-- gates de seguranca para publicacao, segredos, comandos destrutivos, Notion e skills aprendidas;
-- deteccao de oportunidade de aprendizado;
-- deteccao de necessidade de atualizar Notion;
-- bloqueio quando houver publicacao sem autorizacao explicita.
-
-Validacao:
-
-```bash
-npm run check
-```
-
-Resultado:
-
-- build TypeScript passou;
-- `8` arquivos de teste passaram;
-- `39` testes passaram;
-- manifestos `stable` e `beta` validos.
-
-Smoke MCP local via stdio:
-
-- `tools/list` confirmou `skill_master_prompt_router`;
-- `skill_master_refresh_catalog` retornou `45` skills;
-- contagem do catalogo: `7` skills de workspace e `38` locais;
-- `skill_master_prompt_router` recomendou `skill-master-orchestrator` como primeira skill;
-- `executionMode` retornou `assist` para prompt local com restricao `sem publicar`;
-- gate `publication_explicitly_disabled` confirmou que `sem publicar` e restricao local, nao autorizacao de release.
-
-Observacao operacional:
-
-- o codigo local ja registra `skill_master_prompt_router`;
-- o MCP ativo da sessao anterior estava com `workspaceRoots: []`;
-- o smoke local reiniciado com `SKILL_MASTER_CONFIG` e `SKILL_MASTER_WORKSPACE` apontando para este repositorio confirmou `workspaceRoots` e skill de workspace funcionando;
-- para o cliente MCP principal usar isso, ele precisa ser reiniciado apontando para a versao local atualizada ou receber uma proxima versao publicada somente apos autorizacao explicita.
+# Prompt Task 008 - Prompt router e modos de ativacao
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Implementar o roteador de ativacao do Skill Master, com modos `manual`, `balanced` e `always-on-assisted`.
+
+O roteador deve decidir se o Skill Master deve participar do prompt, quais skills recomendar, qual persona aplicar e quais bloqueios de seguranca existem.
+
+## Arquivos provaveis
+
+```text
+src/prompt-router.ts
+src/prompt-router.test.ts
+src/index.ts
+src/types.ts
+bin/lib/menu-core.mjs
+README.md
+```
+
+## Tool MCP proposta
+
+Nome:
+
+```text
+skill_master_prompt_router
+```
+
+Entrada:
+
+```json
+{
+  "prompt": "texto do usuario",
+  "activationMode": "manual|balanced|always-on-assisted",
+  "projectContext": "opcional",
+  "availableSkills": [],
+  "riskTolerance": "low|normal|high"
+}
+```
+
+Saida:
+
+```json
+{
+  "shouldActivate": true,
+  "activationReason": "mencao direta ou tarefa tecnica",
+  "recommendedSkills": [],
+  "personaOverlay": "Dev Senior Master",
+  "executionMode": "plan|assist|block|no-op",
+  "safetyGates": [],
+  "learningOpportunity": false,
+  "notionUpdateNeeded": false,
+  "nextAction": "string curta"
+}
+```
+
+## Heuristicas minimas
+
+Acionar sempre quando o prompt contiver:
+
+- `skill-master`;
+- `skill_master`;
+- `skill-master-mcp`;
+- "use o skill";
+- "crie uma skill";
+- "aprenda com isso";
+- "atualize o Notion";
+- "pesquise e implemente";
+- "publique";
+- "valide npm";
+- "melhore o MCP".
+
+Nao acionar em modo `balanced` quando:
+
+- for pergunta casual;
+- for traducao simples;
+- for formatacao pequena;
+- for horario/data simples;
+- nao houver ganho claro de skill.
+
+Em `always-on-assisted`, pode acionar como avaliador silencioso, mas deve retornar `executionMode: no-op` se nao houver ganho.
+
+## Testes obrigatorios
+
+Criar fixtures com:
+
+- mencao direta;
+- tarefa tecnica clara;
+- tarefa de Notion;
+- tarefa de aprendizado;
+- tarefa simples que nao deve acionar;
+- tarefa perigosa que deve bloquear publicacao sem autorizacao.
+
+Rodar:
+
+```bash
+npm run check
+```
+
+## Resultado esperado
+
+- Router implementado.
+- Tool MCP registrada.
+- Testes cobrindo positivo, negativo e risco.
+- Sem publicacao.
+
+## Resultado da execucao em 2026-06-27
+
+Implementado:
+
+- modulo `src/prompt-router.ts`;
+- teste `src/prompt-router.test.ts`;
+- tool MCP `skill_master_prompt_router`;
+- diagnostico adicional em `skill_master_list_sources`;
+- documentacao de uso no `README.md`.
+
+Contrato entregue:
+
+- modos `manual`, `balanced` e `always-on-assisted`;
+- persona `Dev Senior Master`;
+- `executionMode` com `plan`, `assist`, `block` e `no-op`;
+- gates de seguranca para publicacao, segredos, comandos destrutivos, Notion e skills aprendidas;
+- deteccao de oportunidade de aprendizado;
+- deteccao de necessidade de atualizar Notion;
+- bloqueio quando houver publicacao sem autorizacao explicita.
+
+Validacao:
+
+```bash
+npm run check
+```
+
+Resultado:
+
+- build TypeScript passou;
+- `8` arquivos de teste passaram;
+- `39` testes passaram;
+- manifestos `stable` e `beta` validos.
+
+Smoke MCP local via stdio:
+
+- `tools/list` confirmou `skill_master_prompt_router`;
+- `skill_master_refresh_catalog` retornou `45` skills;
+- contagem do catalogo: `7` skills de workspace e `38` locais;
+- `skill_master_prompt_router` recomendou `skill-master-orchestrator` como primeira skill;
+- `executionMode` retornou `assist` para prompt local com restricao `sem publicar`;
+- gate `publication_explicitly_disabled` confirmou que `sem publicar` e restricao local, nao autorizacao de release.
+
+Observacao operacional:
+
+- o codigo local ja registra `skill_master_prompt_router`;
+- o MCP ativo da sessao anterior estava com `workspaceRoots: []`;
+- o smoke local reiniciado com `SKILL_MASTER_CONFIG` e `SKILL_MASTER_WORKSPACE` apontando para este repositorio confirmou `workspaceRoots` e skill de workspace funcionando;
+- para o cliente MCP principal usar isso, ele precisa ser reiniciado apontando para a versao local atualizada ou receber uma proxima versao publicada somente apos autorizacao explicita.