@thiagodiogo/pscode 2.2.2 → 2.3.0

package/dist/core/profile-sync-drift.js

@@ -23,6 +23,7 @@ export const WORKFLOW_TO_SKILL_DIR = {
     'draft': 'pscode-trello-draft',
     // Productivity workflows
     'handoff': 'pscode-handoff',
+    'grill-me': 'pscode-grill-me',
     // Dixi-specific workflows
     'rfc': 'pscode-dixi-rfc',
     'design': 'pscode-dixi-design',

package/dist/core/profiles.d.ts

@@ -5,7 +5,7 @@
  * `pscode init --profile <name>` or `pscode config profile <name>`.
  * The workflow lists are fixed in code — users cannot customise them.
  */
-export declare const ALL_WORKFLOWS: readonly ["propose", "explore", "new", "continue", "apply", "ff", "complete", "bulk-archive", "verify", "onboard", "trello-setup", "draft", "rfc", "design", "tasks", "arch-check", "adr", "jira-sync", "dod", "handoff"];
+export declare const ALL_WORKFLOWS: readonly ["propose", "explore", "new", "continue", "apply", "ff", "complete", "bulk-archive", "verify", "onboard", "trello-setup", "draft", "rfc", "design", "tasks", "arch-check", "adr", "jira-sync", "dod", "handoff", "grill-me"];
 export type WorkflowId = (typeof ALL_WORKFLOWS)[number];
 export interface ProfileDefinition {
     description: string;
@@ -14,11 +14,11 @@ export interface ProfileDefinition {
 export declare const PROFILES: {
     readonly standard: {
         readonly description: "Padrão — propose, explore, apply, complete";
-        readonly workflows: readonly ["propose", "explore", "apply", "complete", "trello-setup", "draft", "handoff"];
+        readonly workflows: readonly ["propose", "explore", "apply", "complete", "trello-setup", "draft", "handoff", "grill-me"];
     };
     readonly dixi: {
         readonly description: "Dixi — propose, explore, apply, complete com guardrails para Java/Spring e React/Next.js";
-        readonly workflows: readonly ["propose", "explore", "apply", "complete", "trello-setup", "draft", "handoff"];
+        readonly workflows: readonly ["propose", "explore", "apply", "complete", "trello-setup", "draft", "handoff", "grill-me"];
     };
 };
 export type ProfileName = keyof typeof PROFILES;

package/dist/core/profiles.js

@@ -26,15 +26,16 @@ export const ALL_WORKFLOWS = [
     'jira-sync',
     'dod',
     'handoff',
+    'grill-me',
 ];
 export const PROFILES = {
     standard: {
         description: 'Padrão — propose, explore, apply, complete',
-        workflows: ['propose', 'explore', 'apply', 'complete', 'trello-setup', 'draft', 'handoff'],
+        workflows: ['propose', 'explore', 'apply', 'complete', 'trello-setup', 'draft', 'handoff', 'grill-me'],
     },
     dixi: {
         description: 'Dixi — propose, explore, apply, complete com guardrails para Java/Spring e React/Next.js',
-        workflows: ['propose', 'explore', 'apply', 'complete', 'trello-setup', 'draft', 'handoff'],
+        workflows: ['propose', 'explore', 'apply', 'complete', 'trello-setup', 'draft', 'handoff', 'grill-me'],
     },
 };
 export const DEFAULT_PROFILE = 'standard';

package/dist/core/shared/skill-generation.js

@@ -3,7 +3,7 @@
  *
  * Shared utilities for generating skill and command files.
  */
-import { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getCompleteChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOnboardSkillTemplate, getProposeSkillTemplate, getTrelloSetupSkillTemplate, getTrelloDraftSkillTemplate, getHandoffSkillTemplate, getPsExploreCommandTemplate, getPsNewCommandTemplate, getPsContinueCommandTemplate, getPsApplyCommandTemplate, getPsFfCommandTemplate, getPsCompleteCommandTemplate, getPsBulkArchiveCommandTemplate, getPsVerifyCommandTemplate, getPsOnboardCommandTemplate, getPsProposeCommandTemplate, getTrelloSetupCommandTemplate, getTrelloDraftCommandTemplate, getHandoffCommandTemplate, } from '../templates/skill-templates.js';
+import { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getCompleteChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOnboardSkillTemplate, getProposeSkillTemplate, getTrelloSetupSkillTemplate, getTrelloDraftSkillTemplate, getHandoffSkillTemplate, getGrillMeSkillTemplate, getPsExploreCommandTemplate, getPsNewCommandTemplate, getPsContinueCommandTemplate, getPsApplyCommandTemplate, getPsFfCommandTemplate, getPsCompleteCommandTemplate, getPsBulkArchiveCommandTemplate, getPsVerifyCommandTemplate, getPsOnboardCommandTemplate, getPsProposeCommandTemplate, getTrelloSetupCommandTemplate, getTrelloDraftCommandTemplate, getHandoffCommandTemplate, getGrillMeCommandTemplate, } from '../templates/skill-templates.js';
 /**
  * Gets skill templates with their directory names, optionally filtered by workflow IDs.
  *
@@ -26,6 +26,7 @@ export function getSkillTemplates(workflowFilter) {
         { template: getTrelloDraftSkillTemplate(), dirName: 'pscode-trello-draft', workflowId: 'draft' },
         // Productivity workflows
         { template: getHandoffSkillTemplate(), dirName: 'pscode-handoff', workflowId: 'handoff' },
+        { template: getGrillMeSkillTemplate(), dirName: 'pscode-grill-me', workflowId: 'grill-me' },
     ];
     if (!workflowFilter)
         return all;
@@ -54,6 +55,7 @@ export function getCommandTemplates(workflowFilter) {
         { template: getTrelloDraftCommandTemplate(), id: 'draft' },
         // Productivity workflows
         { template: getHandoffCommandTemplate(), id: 'handoff' },
+        { template: getGrillMeCommandTemplate(), id: 'grill-me' },
     ];
     if (!workflowFilter)
         return all;

package/dist/core/templates/skill-templates.d.ts

@@ -18,4 +18,5 @@ export { getFeedbackSkillTemplate } from './workflows/feedback.js';
 export { getTrelloSetupSkillTemplate, getTrelloSetupCommandTemplate } from './workflows/trello-setup.js';
 export { getTrelloDraftSkillTemplate, getTrelloDraftCommandTemplate } from './workflows/trello-draft.js';
 export { getHandoffSkillTemplate, getHandoffCommandTemplate } from './workflows/handoff.js';
+export { getGrillMeSkillTemplate, getGrillMeCommandTemplate } from './workflows/grill-me.js';
 //# sourceMappingURL=skill-templates.d.ts.map

package/dist/core/templates/skill-templates.js

@@ -19,4 +19,5 @@ export { getTrelloSetupSkillTemplate, getTrelloSetupCommandTemplate } from './wo
 export { getTrelloDraftSkillTemplate, getTrelloDraftCommandTemplate } from './workflows/trello-draft.js';
 // Productivity workflows
 export { getHandoffSkillTemplate, getHandoffCommandTemplate } from './workflows/handoff.js';
+export { getGrillMeSkillTemplate, getGrillMeCommandTemplate } from './workflows/grill-me.js';
 //# sourceMappingURL=skill-templates.js.map

package/dist/core/templates/workflows/grill-me.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Grill Me Skill / Command Template
+ *
+ * Conducts a structured interrogation of a plan — one question at a time,
+ * each with a recommended answer — exploring the codebase when evidence is
+ * available, until shared understanding is reached. Ported (in Portuguese)
+ * from the `grill-me` skill (mattpocock/skills).
+ */
+import type { SkillTemplate, CommandTemplate } from '../types.js';
+export declare function getGrillMeSkillTemplate(): SkillTemplate;
+export declare function getGrillMeInstructions(): string;
+export declare function getGrillMeCommandTemplate(): CommandTemplate;
+//# sourceMappingURL=grill-me.d.ts.map

package/dist/core/templates/workflows/grill-me.js

@@ -0,0 +1,64 @@
+export function getGrillMeSkillTemplate() {
+    return {
+        name: 'pscode-grill-me',
+        description: 'Interroga um plano antes da implementação — uma pergunta por vez, com resposta recomendada, explorando o código quando há evidência, até entendimento compartilhado. Use quando o usuário quer validar e refinar um plano antes de escrever artefatos ou código.',
+        instructions: getGrillMeInstructions(),
+        compatibility: 'Works with any pscode project.',
+        metadata: { author: 'pscode', version: '1.0' },
+    };
+}
+export function getGrillMeInstructions() {
+    return `Interrogue o plano do usuário até atingir entendimento compartilhado sobre o que realmente deve existir — não apenas sobre o que foi descrito. O objetivo é pressionar cada decisão e ambiguidade do plano **antes** de escrever qualquer artefato ou código.
+
+**Princípio central**: faça **uma pergunta por vez**. Nunca despeje uma lista de perguntas de uma só vez. Aguarde a resposta, incorpore-a ao seu entendimento e só então formule a próxima.
+
+**Steps**
+
+1. **Entenda o plano inicial**
+
+   Leia a descrição do usuário (e qualquer artefato/contexto já disponível). Identifique a árvore de decisões: requisitos, escopo, abordagem técnica, trade-offs e os pontos onde o plano está vago, ambíguo ou assume algo não dito.
+
+2. **Explore o código antes de perguntar**
+
+   Se uma pergunta pode ser respondida com evidência presente no próprio repositório (convenções existentes, padrões de arquitetura, como features semelhantes já foram feitas), **investigue o código** em vez de perguntar ao usuário. Use o resultado da investigação para formular perguntas melhores ou para já resolver a decisão.
+
+   Só pergunte ao usuário o que o código não responde — decisões de produto, prioridades, trade-offs e intenção.
+
+3. **Conduza a interrogação — uma pergunta por vez**
+
+   Para cada ponto não resolvido, na ordem em que as dependências entre decisões exigem (resolva primeiro o que destrava as demais):
+
+   - Faça **uma** pergunta clara e específica.
+   - Sempre acompanhe a pergunta com a **sua resposta recomendada** e um motivo curto — para orientar a decisão e permitir que o usuário apenas concorde e siga em frente quando a recomendação fizer sentido.
+   - Quando houver opções discretas, use a **ferramenta AskUserQuestion** com a recomendação como primeira opção (marcada como "(Recomendada)"). Para perguntas abertas, formule a recomendação no texto.
+   - Aguarde a resposta antes de prosseguir. Incorpore-a e reavalie a árvore de decisão: a resposta pode tornar perguntas seguintes desnecessárias ou abrir novas.
+
+4. **Navegue a árvore de decisão progressivamente**
+
+   À medida que cada decisão é resolvida, atualize seu entendimento e siga para a próxima decisão relevante. Não pergunte algo que já foi respondido (direta ou indiretamente) por uma resposta anterior ou pelo código.
+
+5. **Encerre por entendimento compartilhado**
+
+   Quando todos os ramos relevantes da árvore de decisão estiverem resolvidos e não restar ambiguidade material, **encerre a interrogação** e apresente um **resumo do entendimento compartilhado**: o que será construído, as decisões tomadas (com seus motivos) e os pontos explicitamente fora de escopo.
+
+   Confirme com o usuário que o resumo reflete o que deve existir. A partir daí, o plano está pronto para virar artefatos/implementação.
+
+**Guardrails**
+- Uma pergunta por vez — sempre. Nunca despeje várias perguntas juntas.
+- Toda pergunta vem com uma resposta recomendada.
+- Prefira investigar o código a perguntar, quando a resposta está no repositório.
+- Não invente decisões: se algo é genuinamente do usuário, pergunte.
+- Pare assim que houver entendimento compartilhado — não prolongue a interrogação além do necessário.
+- Se o usuário passou argumentos, trate-os como a descrição do plano a ser interrogado.
+`;
+}
+export function getGrillMeCommandTemplate() {
+    return {
+        name: 'PS: Grill Me',
+        description: 'Interroga um plano antes da implementação — uma pergunta por vez, com resposta recomendada, até entendimento compartilhado',
+        category: 'Workflow',
+        tags: ['grill', 'refinamento', 'plano', 'workflow'],
+        content: getGrillMeInstructions(),
+    };
+}
+//# sourceMappingURL=grill-me.js.map

package/dist/core/templates/workflows/propose.js

@@ -52,6 +52,18 @@ When ready to implement, run /ps:apply
 
    **IMPORTANT**: Do NOT proceed without understanding what the user wants to build.
 
+1b. **Fase de grill — interrogue o plano antes de gerar artefatos**
+
+   Antes de criar a change e gerar os artefatos, conduza a **fase de grill** para garantir que a proposta reflita o que realmente deve existir — não apenas a descrição inicial. Aplique o mesmo comportamento da skill \`grill-me\` (\`/ps:grill-me\`):
+
+   - Faça **uma pergunta por vez** — nunca despeje várias perguntas juntas. Aguarde a resposta antes da próxima.
+   - Acompanhe **cada** pergunta com a **sua resposta recomendada** e um motivo curto. Quando houver opções discretas, use a **ferramenta AskUserQuestion** com a recomendação como primeira opção ("(Recomendada)").
+   - **Explore o código quando há evidência**: se uma pergunta pode ser respondida pelo próprio repositório (convenções, padrões, features semelhantes), investigue o código em vez de perguntar. Só pergunte ao usuário decisões de produto, prioridades, trade-offs e intenção.
+   - Navegue a árvore de decisão progressivamente, resolvendo dependências; não repergunte o que já foi respondido pelo código ou por uma resposta anterior.
+   - Encerre quando houver **entendimento compartilhado** e apresente um resumo curto (o que será construído, decisões com motivos, fora de escopo) antes de seguir.
+
+   Os artefatos gerados a partir do Passo 2 SHALL refletir esse entendimento refinado.
+
 2. **Create the change directory**
    \`\`\`bash
    pscode new change "<name>"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thiagodiogo/pscode",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "pscode",