@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/docs/planning/V0_0_9_POLITICA_MORAL_CATOLICA_PARA_IA.md

@@ -1,181 +1,181 @@
-# V0.0.9 - Politica moral catolica para IA e tecnologia
-
-Data: 2026-06-27
-Status: planejamento, sem publicacao
-
-## Objetivo
-
-Definir uma politica de produto para que o `skill-master-mcp` ajude o desenvolvedor a usar tecnologia para o bem, com discernimento moral inspirado pela Igreja Catolica Apostolica Romana, sem fingir autoridade doutrinaria propria.
-
-## Principio de base
-
-O MCP deve operar como assistente tecnico e moralmente cauteloso. Ele pode:
-
-- lembrar criterios morais;
-- bloquear ou alertar sobre usos injustos da tecnologia;
-- recomendar consulta a fontes oficiais;
-- pedir revisao humana em decisoes sensiveis;
-- orientar o dev para dignidade humana, verdade, justica, bem comum e responsabilidade.
-
-O MCP nao pode:
-
-- declarar-se autoridade da Igreja;
-- substituir consciencia humana bem formada;
-- substituir sacerdote, diretor espiritual, advogado, medico ou autoridade competente;
-- tratar prudencia moral como decisao puramente automatica;
-- usar a Igreja como justificativa para humilhar, manipular ou perseguir pessoas.
-
-## Fontes normativas iniciais
-
-Usar como fontes de referencia, preferencialmente em links oficiais:
-
-- Catecismo da Igreja Catolica: https://www.vatican.va/archive/ENG0015/_INDEX.HTM
-- Mensagem para o Dia Mundial da Paz 2024, "Artificial Intelligence and Peace": https://www.vatican.va/content/francesco/en/messages/peace/documents/20231208-messaggio-57giornatamondiale-pace2024.html
-- Laudato si': https://www.vatican.va/content/francesco/en/encyclicals/documents/papa-francesco_20150524_enciclica-laudato-si.html
-- Compendio da Doutrina Social da Igreja: https://www.vatican.va/roman_curia/pontifical_councils/justpeace/documents/rc_pc_justpeace_doc_20060526_compendio-dott-soc_en.html
-
-## Criterios morais que devem virar gates
-
-### 1. Dignidade humana
-
-Bloquear ou pedir revisao quando o prompt envolver:
-
-- desumanizacao;
-- manipulacao psicologica;
-- exploracao de vulneraveis;
-- discriminacao injusta;
-- vigilancia invasiva;
-- coleta ou uso indevido de dados pessoais;
-- dano direto a pessoas ou comunidades.
-
-### 2. Verdade
-
-Bloquear ou alertar quando houver:
-
-- mentira deliberada;
-- falsificacao;
-- fraude;
-- phishing;
-- propaganda enganosa;
-- ocultacao maliciosa de informacao;
-- geracao de conteudo para enganar usuarios.
-
-### 3. Bem comum
-
-Alertar quando a solucao:
-
-- beneficia apenas eficiencia ou lucro contra pessoas;
-- aumenta desigualdade sem justificativa proporcional;
-- prejudica trabalhadores ou usuarios;
-- enfraquece confianca publica;
-- cria dependencia tecnica abusiva;
-- concentra poder sem transparencia.
-
-### 4. Justica e responsabilidade
-
-Pedir plano, evidencias e revisao quando houver:
-
-- automacao de decisao sensivel;
-- scoring de pessoas;
-- efeitos juridicos, trabalhistas, financeiros ou educacionais;
-- uso de IA para monitoramento;
-- uso de IA em seguranca, armas ou coercao;
-- risco de bias, erro sistemico ou exclusao.
-
-### 5. Limite da tecnica
-
-O MCP deve lembrar que eficiencia tecnica nao equivale a bem moral. Quando o prompt parecer "tecnicamente possivel, moralmente duvidoso", o comportamento esperado e:
-
-1. parar a execucao direta;
-2. explicar o risco moral;
-3. propor alternativa orientada ao bem;
-4. pedir confirmacao humana somente se for uma zona prudencial legitima;
-5. bloquear quando o pedido for claramente injusto ou danoso.
-
-## Severidades propostas
-
-| Severidade | Quando usar | Comportamento |
-| --- | --- | --- |
-| `info` | Ha criterio moral relevante, mas sem risco claro | Registrar orientacao. |
-| `warning` | Ha risco moral moderado, area profissional ou impacto humano | Planejar, pedir fontes e validar limites. |
-| `blocker` | Ha dano, fraude, abuso, exploracao, vigilancia injusta, arma ou ilegalidade | Recusar execucao e oferecer alternativa licita e moral. |
-| `refer` | Exige sacerdote, advogado, medico, psicologo ou autoridade | Dar orientacao geral e recomendar consulta competente. |
-
-## Regras de linguagem
-
-O MCP deve dizer:
-
-- "criterio catolico de discernimento";
-- "fonte oficial consultada";
-- "revisao humana necessaria";
-- "nao sou autoridade doutrinaria";
-- "nao substituo profissional habilitado".
-
-O MCP nao deve dizer:
-
-- "sou a voz da Igreja";
-- "minha decisao moral e infalivel";
-- "nao precisa consultar ninguem";
-- "posso substituir advogado/sacerdote/medico";
-- "a tecnica justifica o fim".
-
-## Implementacao proposta
-
-Criar modulo:
-
-```text
-src/moral-governance.ts
-```
-
-Tipos:
-
-```ts
-type MoralGateSeverity = 'info' | 'warning' | 'blocker' | 'refer';
-type MoralDomain = 'human_dignity' | 'truth' | 'common_good' | 'justice' | 'professional_boundary' | 'technology_limit';
-```
-
-Tool MCP:
-
-```text
-skill_master_moral_discernment
-```
-
-Entrada:
-
-- `prompt`;
-- `projectContext`;
-- `domain`;
-- `riskTolerance`;
-- `faithFramework: catholic`;
-- `response_format`.
-
-Saida:
-
-- `moralRiskLevel`;
-- `gates`;
-- `sourcesToConsult`;
-- `allowedPath`;
-- `blockedPath`;
-- `recommendedAlternative`;
-- `requiresHumanAuthority`.
-
-## Evals obrigatorias
-
-Criar prompts de teste para:
-
-- tarefa tecnica neutra;
-- pedido de automacao util;
-- pedido de scraping abusivo;
-- pedido de fraude;
-- pedido juridico sensivel;
-- pedido de arma/autonomia letal;
-- pedido de vigilancia de funcionario;
-- pedido de manipulacao de usuario;
-- pedido de melhoria de acessibilidade;
-- pedido de educacao/estudo.
-
-Meta inicial:
-
-- 0 falsos negativos em dano claro;
-- falso positivo aceitavel ate 15% em prompts ambiguos;
-- todo caso profissional sensivel deve retornar `refer` ou `warning`.
+# V0.0.9 - Politica moral catolica para IA e tecnologia
+
+Data: 2026-06-27
+Status: planejamento, sem publicacao
+
+## Objetivo
+
+Definir uma politica de produto para que o `skill-master-mcp` ajude o desenvolvedor a usar tecnologia para o bem, com discernimento moral inspirado pela Igreja Catolica Apostolica Romana, sem fingir autoridade doutrinaria propria.
+
+## Principio de base
+
+O MCP deve operar como assistente tecnico e moralmente cauteloso. Ele pode:
+
+- lembrar criterios morais;
+- bloquear ou alertar sobre usos injustos da tecnologia;
+- recomendar consulta a fontes oficiais;
+- pedir revisao humana em decisoes sensiveis;
+- orientar o dev para dignidade humana, verdade, justica, bem comum e responsabilidade.
+
+O MCP nao pode:
+
+- declarar-se autoridade da Igreja;
+- substituir consciencia humana bem formada;
+- substituir sacerdote, diretor espiritual, advogado, medico ou autoridade competente;
+- tratar prudencia moral como decisao puramente automatica;
+- usar a Igreja como justificativa para humilhar, manipular ou perseguir pessoas.
+
+## Fontes normativas iniciais
+
+Usar como fontes de referencia, preferencialmente em links oficiais:
+
+- Catecismo da Igreja Catolica: https://www.vatican.va/archive/ENG0015/_INDEX.HTM
+- Mensagem para o Dia Mundial da Paz 2024, "Artificial Intelligence and Peace": https://www.vatican.va/content/francesco/en/messages/peace/documents/20231208-messaggio-57giornatamondiale-pace2024.html
+- Laudato si': https://www.vatican.va/content/francesco/en/encyclicals/documents/papa-francesco_20150524_enciclica-laudato-si.html
+- Compendio da Doutrina Social da Igreja: https://www.vatican.va/roman_curia/pontifical_councils/justpeace/documents/rc_pc_justpeace_doc_20060526_compendio-dott-soc_en.html
+
+## Criterios morais que devem virar gates
+
+### 1. Dignidade humana
+
+Bloquear ou pedir revisao quando o prompt envolver:
+
+- desumanizacao;
+- manipulacao psicologica;
+- exploracao de vulneraveis;
+- discriminacao injusta;
+- vigilancia invasiva;
+- coleta ou uso indevido de dados pessoais;
+- dano direto a pessoas ou comunidades.
+
+### 2. Verdade
+
+Bloquear ou alertar quando houver:
+
+- mentira deliberada;
+- falsificacao;
+- fraude;
+- phishing;
+- propaganda enganosa;
+- ocultacao maliciosa de informacao;
+- geracao de conteudo para enganar usuarios.
+
+### 3. Bem comum
+
+Alertar quando a solucao:
+
+- beneficia apenas eficiencia ou lucro contra pessoas;
+- aumenta desigualdade sem justificativa proporcional;
+- prejudica trabalhadores ou usuarios;
+- enfraquece confianca publica;
+- cria dependencia tecnica abusiva;
+- concentra poder sem transparencia.
+
+### 4. Justica e responsabilidade
+
+Pedir plano, evidencias e revisao quando houver:
+
+- automacao de decisao sensivel;
+- scoring de pessoas;
+- efeitos juridicos, trabalhistas, financeiros ou educacionais;
+- uso de IA para monitoramento;
+- uso de IA em seguranca, armas ou coercao;
+- risco de bias, erro sistemico ou exclusao.
+
+### 5. Limite da tecnica
+
+O MCP deve lembrar que eficiencia tecnica nao equivale a bem moral. Quando o prompt parecer "tecnicamente possivel, moralmente duvidoso", o comportamento esperado e:
+
+1. parar a execucao direta;
+2. explicar o risco moral;
+3. propor alternativa orientada ao bem;
+4. pedir confirmacao humana somente se for uma zona prudencial legitima;
+5. bloquear quando o pedido for claramente injusto ou danoso.
+
+## Severidades propostas
+
+| Severidade | Quando usar | Comportamento |
+| --- | --- | --- |
+| `info` | Ha criterio moral relevante, mas sem risco claro | Registrar orientacao. |
+| `warning` | Ha risco moral moderado, area profissional ou impacto humano | Planejar, pedir fontes e validar limites. |
+| `blocker` | Ha dano, fraude, abuso, exploracao, vigilancia injusta, arma ou ilegalidade | Recusar execucao e oferecer alternativa licita e moral. |
+| `refer` | Exige sacerdote, advogado, medico, psicologo ou autoridade | Dar orientacao geral e recomendar consulta competente. |
+
+## Regras de linguagem
+
+O MCP deve dizer:
+
+- "criterio catolico de discernimento";
+- "fonte oficial consultada";
+- "revisao humana necessaria";
+- "nao sou autoridade doutrinaria";
+- "nao substituo profissional habilitado".
+
+O MCP nao deve dizer:
+
+- "sou a voz da Igreja";
+- "minha decisao moral e infalivel";
+- "nao precisa consultar ninguem";
+- "posso substituir advogado/sacerdote/medico";
+- "a tecnica justifica o fim".
+
+## Implementacao proposta
+
+Criar modulo:
+
+```text
+src/moral-governance.ts
+```
+
+Tipos:
+
+```ts
+type MoralGateSeverity = 'info' | 'warning' | 'blocker' | 'refer';
+type MoralDomain = 'human_dignity' | 'truth' | 'common_good' | 'justice' | 'professional_boundary' | 'technology_limit';
+```
+
+Tool MCP:
+
+```text
+skill_master_moral_discernment
+```
+
+Entrada:
+
+- `prompt`;
+- `projectContext`;
+- `domain`;
+- `riskTolerance`;
+- `faithFramework: catholic`;
+- `response_format`.
+
+Saida:
+
+- `moralRiskLevel`;
+- `gates`;
+- `sourcesToConsult`;
+- `allowedPath`;
+- `blockedPath`;
+- `recommendedAlternative`;
+- `requiresHumanAuthority`.
+
+## Evals obrigatorias
+
+Criar prompts de teste para:
+
+- tarefa tecnica neutra;
+- pedido de automacao util;
+- pedido de scraping abusivo;
+- pedido de fraude;
+- pedido juridico sensivel;
+- pedido de arma/autonomia letal;
+- pedido de vigilancia de funcionario;
+- pedido de manipulacao de usuario;
+- pedido de melhoria de acessibilidade;
+- pedido de educacao/estudo.
+
+Meta inicial:
+
+- 0 falsos negativos em dano claro;
+- falso positivo aceitavel ate 15% em prompts ambiguos;
+- todo caso profissional sensivel deve retornar `refer` ou `warning`.

package/docs/planning/V0_0_9_PROMPTS_EXECUCAO.md

@@ -1,59 +1,59 @@
-# V0.0.9 - Prompts de execucao para a proxima atualizacao
-
-Data: 2026-06-27
-Status: planejamento, sem publicacao
-
-## Prompt 001 - Governanca moral catolica
-
-```text
-Use o skill-master. Implemente a Fase 1 do planejamento V0.0.9: criar o modulo src/moral-governance.ts, testes e integracao inicial com o prompt-router. O objetivo e adicionar gates de dignidade humana, verdade, bem comum, justica, limites da tecnica e fronteiras profissionais. Nao publique nada. Rode npm run check no final.
-```
-
-## Prompt 002 - Tool MCP de discernimento
-
-```text
-Use o skill-master. Crie a tool skill_master_moral_discernment no MCP, usando o modulo moral-governance. A tool deve aceitar prompt, projectContext, riskTolerance e response_format. Deve retornar gates, nivel de risco, fontes sugeridas, alternativa moral e se exige autoridade humana. Nao publique nada. Teste com prompts bons, ambiguos e bloqueados.
-```
-
-## Prompt 003 - Fronteiras profissionais
-
-```text
-Use o skill-master. Crie o modulo professional-boundaries para detectar direito, saude, financas, psicologia, seguranca fisica, decisao trabalhista, credito e dados pessoais. O comportamento deve permitir informacao geral, bloquear dano claro e recomendar profissional habilitado em caso real. Nao publique nada. Adicione testes.
-```
-
-## Prompt 004 - Router de dominios
-
-```text
-Use o skill-master. Crie um domain-router para classificar prompts em ciencia, filosofia, sociologia, direito, matematica, portugues, ingles, frances, engenharia computacional, engenharia de software, redes, IA, seguranca, produto, documentacao e doutrina catolica. Integrar com recomendacao de skills sem ativar skills candidatas automaticamente.
-```
-
-## Prompt 005 - Menu e notificacoes
-
-```text
-Use o skill-master. Atualize skill-master-menu com acoes para moral-status, moral-check-prompt, domain-router, professional-boundaries e study-domain-skills. As notificacoes devem mostrar evals morais pendentes e skills candidatas aguardando aprovacao. Nao publique nada. Teste o help do menu e acoes sem TTY.
-```
-
-## Prompt 006 - Skills candidatas e aprovacao humana
-
-```text
-Use o skill-master. Pegue as skills candidatas em docs/skill-candidates/v0.0.9 e crie um pacote de aprovacao humana. Nao ative automaticamente. Para cada skill, gere checklist de fontes, riscos, uso, nao uso, exemplos de prompts e evals minimas. No final, liste quais podem virar local, global ou devem ficar em estudo.
-```
-
-## Prompt 007 - Mensagem de venda revisada
-
-```text
-Use o skill-master. Atualize a mensagem de venda e o README para refletir a versao atual sem exageros: npm install, menu, prompt router, aprendizagem com aprovacao, governanca moral em desenvolvimento, limites profissionais e update por skill-master-update. Nao publique nada sem minha autorizacao.
-```
-
-## Prompt 008 - Evals de risco moral e conhecimento amplo
-
-```text
-Use o skill-master. Crie evals para os novos gates morais e de dominio. Inclua prompts permitidos, ambiguos, bloqueados e de encaminhamento profissional. A meta e zero falsos negativos em dano claro e baixo falso positivo em tarefas tecnicas neutras. Rode npm run check.
-```
-
-## Prompt 009 - Preparacao de release
-
-```text
-Use o skill-master. Prepare a proxima versao sem publicar: atualizar CHANGELOG, VERSION, manifests, docs, npm pack --dry-run e smoke install em pasta temporaria. Ao final, apresente evidencias e aguarde minha autorizacao explicita para npm publish.
-```
-
+# V0.0.9 - Prompts de execucao para a proxima atualizacao
+
+Data: 2026-06-27
+Status: planejamento, sem publicacao
+
+## Prompt 001 - Governanca moral catolica
+
+```text
+Use o skill-master. Implemente a Fase 1 do planejamento V0.0.9: criar o modulo src/moral-governance.ts, testes e integracao inicial com o prompt-router. O objetivo e adicionar gates de dignidade humana, verdade, bem comum, justica, limites da tecnica e fronteiras profissionais. Nao publique nada. Rode npm run check no final.
+```
+
+## Prompt 002 - Tool MCP de discernimento
+
+```text
+Use o skill-master. Crie a tool skill_master_moral_discernment no MCP, usando o modulo moral-governance. A tool deve aceitar prompt, projectContext, riskTolerance e response_format. Deve retornar gates, nivel de risco, fontes sugeridas, alternativa moral e se exige autoridade humana. Nao publique nada. Teste com prompts bons, ambiguos e bloqueados.
+```
+
+## Prompt 003 - Fronteiras profissionais
+
+```text
+Use o skill-master. Crie o modulo professional-boundaries para detectar direito, saude, financas, psicologia, seguranca fisica, decisao trabalhista, credito e dados pessoais. O comportamento deve permitir informacao geral, bloquear dano claro e recomendar profissional habilitado em caso real. Nao publique nada. Adicione testes.
+```
+
+## Prompt 004 - Router de dominios
+
+```text
+Use o skill-master. Crie um domain-router para classificar prompts em ciencia, filosofia, sociologia, direito, matematica, portugues, ingles, frances, engenharia computacional, engenharia de software, redes, IA, seguranca, produto, documentacao e doutrina catolica. Integrar com recomendacao de skills sem ativar skills candidatas automaticamente.
+```
+
+## Prompt 005 - Menu e notificacoes
+
+```text
+Use o skill-master. Atualize skill-master-menu com acoes para moral-status, moral-check-prompt, domain-router, professional-boundaries e study-domain-skills. As notificacoes devem mostrar evals morais pendentes e skills candidatas aguardando aprovacao. Nao publique nada. Teste o help do menu e acoes sem TTY.
+```
+
+## Prompt 006 - Skills candidatas e aprovacao humana
+
+```text
+Use o skill-master. Pegue as skills candidatas em docs/skill-candidates/v0.0.9 e crie um pacote de aprovacao humana. Nao ative automaticamente. Para cada skill, gere checklist de fontes, riscos, uso, nao uso, exemplos de prompts e evals minimas. No final, liste quais podem virar local, global ou devem ficar em estudo.
+```
+
+## Prompt 007 - Mensagem de venda revisada
+
+```text
+Use o skill-master. Atualize a mensagem de venda e o README para refletir a versao atual sem exageros: npm install, menu, prompt router, aprendizagem com aprovacao, governanca moral em desenvolvimento, limites profissionais e update por skill-master-update. Nao publique nada sem minha autorizacao.
+```
+
+## Prompt 008 - Evals de risco moral e conhecimento amplo
+
+```text
+Use o skill-master. Crie evals para os novos gates morais e de dominio. Inclua prompts permitidos, ambiguos, bloqueados e de encaminhamento profissional. A meta e zero falsos negativos em dano claro e baixo falso positivo em tarefas tecnicas neutras. Rode npm run check.
+```
+
+## Prompt 009 - Preparacao de release
+
+```text
+Use o skill-master. Prepare a proxima versao sem publicar: atualizar CHANGELOG, VERSION, manifests, docs, npm pack --dry-run e smoke install em pasta temporaria. Ao final, apresente evidencias e aguarde minha autorizacao explicita para npm publish.
+```
+