@ihelpee/prumo-plugin-speckit 0.0.0-stage → 0.18.2

package/LICENSE

@@ -0,0 +1,51 @@
+Prumo Software License
+
+Copyright (c) 2026 IHELPEE TECNOLOGIA LTDA (https://ihelpee.com). All rights reserved.
+
+This license applies to Prumo version 0.17.0 and later: the @ihelpee/prumo
+package, its plugins and i18n packages, and their documentation (the
+"Software"). Versions published before 0.17.0 remain under the license each
+one was published with (MIT or Apache-2.0); this license does not change them.
+
+1. Grant. IHELPEE TECNOLOGIA LTDA ("IHELPEE") grants you a free,
+   non-exclusive, non-transferable, revocable license to install and run the
+   Software, as published by IHELPEE, to check your own projects. Your
+   projects may be commercial: a company may use the Software on the code of
+   the products it sells.
+
+2. Commercial exploitation is reserved. Only IHELPEE may make money from the
+   Software itself. Unless IHELPEE agrees in writing, you may not charge for,
+   or receive any payment or other consideration for, the Software or any
+   product or service whose value comes mainly from it, such as reselling
+   it, bundling it, hosting it, or paid consulting, training, support,
+   setup or certification built on it.
+
+3. Restrictions. Unless IHELPEE agrees in writing, you may not:
+   a. copy, modify, translate or create derivative works of the Software,
+      except copies made by installing and running it;
+   b. redistribute, sell, sublicense, rent or publish the Software, alone or
+      as part of another product;
+   c. offer the Software, or a substantial part of its functionality, to
+      third parties as a hosted or managed service;
+   d. reverse engineer, decompile or disassemble the Software, except where
+      the law allows it despite this restriction;
+   e. remove or alter any copyright, trademark or license notice.
+
+4. Trademarks. This license grants no right to the "Prumo" name, logo or
+   other marks. See docs/TRADEMARK.md.
+
+5. Termination. This license ends automatically if you breach it. On
+   termination you must stop using the Software and delete your copies.
+
+6. No warranty. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A
+   PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+
+7. Limitation of liability. TO THE EXTENT PERMITTED BY LAW, IHELPEE IS NOT
+   LIABLE FOR ANY DAMAGES ARISING FROM THE USE OF, OR INABILITY TO USE, THE
+   SOFTWARE.
+
+8. Governing law. This license is governed by the laws of the Federative
+   Republic of Brazil.
+
+Other licensing: alexgotardi@gmail.com

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+# @ihelpee/prumo-plugin-speckit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Experimental planning and interview plugin for Prumo. Speckit helps an agent turn an unclear
+request into a human-approved intent before implementation. It does not write application code
+or approve decisions on the person's behalf.
+
+## What it adds
+
+- The `prumo/spec-interviewer` and `prumo/speckit-foreman` skills, available after the project
+  harness is synchronized.
+- An interview catalog with starter questions for common architecture and validation findings.
+- A status provider that reports `speckitPhase` as `sem-intent`, `intent-rascunho`,
+  `intent-congelado` or `implementando`.
+- An optional `speckit-intent-mapped` rule when the plugin is configured with code globs.
+- A starter grill-me intent template for use with the plugin's scaffold API.
+
+The catalog is a starting point, not a substitute for decisions specific to the project. The
+human must approve the resulting intent; Speckit does not freeze contracts or implement the
+feature.
+
+## Installation
+
+Install the plugin alongside Prumo at matching versions:
+
+```bash
+pnpm add -D @ihelpee/prumo @ihelpee/prumo-plugin-speckit
+```
+
+## Configuration
+
+Register the plugin in `prumo.config.ts`:
+
+```ts
+import { defineConfig } from '@ihelpee/prumo';
+import speckit from '@ihelpee/prumo-plugin-speckit';
+
+export default defineConfig({ plugins: [speckit] });
+```
+
+Then synchronize the agent harness and start an interview:
+
+```bash
+npx prumo harness sync
+npx prumo interview
+```
+
+The plugin contributes to Prumo's existing interview and status commands. It does not replace
+the core gate or its verdict.
+
+## Extension API
+
+The package exports its catalog, skills, status provider and rule factory for integrations.
+`createSpeckitRules({ codeGlobs })` returns no rule when no globs are supplied; with globs, it
+reports matching source files when the project has no `.prumo/intent/*.md` file. The scaffold
+helper writes the starter `speckit_grill_me.md` under `.prumo/intent/` in the selected locale.
+
+## Compatibility
+
+This plugin is experimental. Keep it on the same release version as `@ihelpee/prumo`; its
+catalog and skill APIs may change between minor releases.

package/dist/catalog.d.ts

@@ -0,0 +1,4 @@
+import type { InterviewCatalogEntry } from '@ihelpee/prumo';
+/** Canonical English; `translations` carries other locales. */
+export declare const SPECKIT_INTERVIEW_CATALOG: InterviewCatalogEntry[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,EAAE,qBAAqB,EA8I5D,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,134 @@
+/** Canonical English; `translations` carries other locales. */
+export const SPECKIT_INTERVIEW_CATALOG = [
+    {
+        id: 'mutation-guards',
+        category: 'security',
+        title: 'Required Guard on Mutation Routes',
+        question: '{count} mutation route(s) (POST/PUT/PATCH/DELETE) were found without an authentication guard. Should state-changing routes always require authorization/authentication guards?',
+        options: [
+            'Yes, every mutation requires a guard (except routes explicitly declared public)',
+            'No, some mutations may be public without a guard',
+        ],
+        defaultOptionIndex: 0,
+        suggestedRuleId: 'mutation-routes-guarded',
+        moduleName: 'api',
+        trigger: { kind: 'finding', rule: 'mutation-routes-guarded' },
+        roles: ['engineer', 'qa'],
+        translations: {
+            'pt-BR': {
+                title: 'Guarda Obrigatória em Rotas de Mutação',
+                question: 'Foram detectadas {count} rota(s) de mutação (POST/PUT/PATCH/DELETE) sem guard de autenticação. Rotas que alteram estado devem sempre exigir guards de autorização/autenticação?',
+                options: [
+                    'Sim, toda mutação exige guard (exceto rotas públicas explicitamente declaradas)',
+                    'Não, algumas mutações podem ser públicas sem restrição de guard',
+                ],
+            },
+        },
+    },
+    {
+        id: 'cross-feature-imports',
+        category: 'architecture',
+        title: 'Boundaries and Isolation Between Features',
+        question: 'Direct imports crossing module boundaries were found (e.g. orders -> internal kyc). Should features communicate only through frozen public contracts?',
+        options: [
+            'Yes, sibling modules may not import each other\'s internal files (public contracts only)',
+            'Allow free imports between feature folders',
+        ],
+        defaultOptionIndex: 0,
+        suggestedRuleId: 'no-cross-feature-import',
+        moduleName: 'architecture',
+        trigger: { kind: 'finding', rule: 'no-cross-feature-import' },
+        roles: ['engineer', 'qa'],
+        translations: {
+            'pt-BR': {
+                title: 'Fronteiras e Isolamento entre Features',
+                question: 'Foram detectados imports diretos atravessando fronteiras de módulos (ex: orders -> kyc interno). Features devem se comunicar exclusivamente via contratos públicos congelados?',
+                options: [
+                    'Sim, módulos irmãos não podem importar arquivos internos entre si (apenas contratos públicos)',
+                    'Permitir importação livre entre pastas de features',
+                ],
+            },
+        },
+    },
+    {
+        id: 'monetary-precision',
+        category: 'data-integrity',
+        title: 'Integer Monetary Precision (Cents)',
+        question: 'Should monetary values (prices, totals, balances) be stored and handled strictly as integer cents (no floats)?',
+        options: [
+            'Yes, every monetary value is strictly an integer in cents (amountCents / totalCents)',
+            'No, the system will keep accepting float numbers with decimals',
+        ],
+        defaultOptionIndex: 0,
+        suggestedRuleId: 'monetary-is-integer',
+        moduleName: 'finance',
+        trigger: {
+            kind: 'finding-or-src',
+            rule: 'monetary-is-integer',
+            srcSubstrings: ['order', 'payment'],
+            fallbackEvidence: 'Numeric fields found in order/payment entities',
+        },
+        roles: ['engineer', 'qa', 'po', 'stakeholder'],
+        translations: {
+            'pt-BR': {
+                title: 'Precisão Monetária Inteira (Centavos)',
+                question: 'Valores monetários (preços, totais, saldos) devem ser armazenados e manipulados estritamente como inteiros em centavos (sem floats)?',
+                options: [
+                    'Sim, todo valor monetário é estritamente inteiro em centavos (amountCents / totalCents)',
+                    'Não, o sistema continuará aceitando números float com casas decimais',
+                ],
+                fallbackEvidence: 'Campos numéricos detectados em entidades de pedidos/pagamentos',
+            },
+        },
+    },
+    {
+        id: 'dto-validation',
+        category: 'validation',
+        title: 'Strict Validation of Input Parameters (DTOs)',
+        question: 'DTOs received in the request body (@Body()) were found without validation decorators. Should every inbound payload have strict schema/property validation?',
+        options: [
+            'Yes, unvalidated parameters must be rejected before reaching domain services',
+            'No, free parameters without validation are allowed',
+        ],
+        defaultOptionIndex: 0,
+        suggestedRuleId: 'dto-has-validation',
+        moduleName: 'validation',
+        trigger: { kind: 'finding', rule: 'dto-has-validation' },
+        roles: ['engineer', 'qa'],
+        translations: {
+            'pt-BR': {
+                title: 'Validação Rígida de Parâmetros de Entrada (DTOs)',
+                question: 'Foram detectados DTOs recebidos no corpo de requisições (@Body()) sem decoradores de validação. Todo payload de entrada deve conter validação estrita de schema/propriedades?',
+                options: [
+                    'Sim, parâmetros não validados devem ser rejeitados antes de alcançar os serviços de domínio',
+                    'Não, parâmetros livres sem validação são permitidos',
+                ],
+            },
+        },
+    },
+    {
+        id: 'architectural-baseline',
+        category: 'architecture',
+        title: 'Engineering Constitutional Baseline',
+        question: 'No critical anomaly was found right away. Do you want to make oracle isolation and frozen contracts the project standard?',
+        options: [
+            'Yes, establish frozen contracts and oracle isolation under .prumo/',
+            'Only audit, without generating extra rules',
+        ],
+        defaultOptionIndex: 0,
+        suggestedRuleId: 'oracle-no-src',
+        moduleName: 'core',
+        trigger: { kind: 'baseline' },
+        roles: ['engineer', 'qa', 'po', 'stakeholder'],
+        translations: {
+            'pt-BR': {
+                title: 'Linha de Base Constitucional de Engenharia',
+                question: 'Nenhuma anomalia crítica foi encontrada de imediato. Deseja estabelecer o isolamento oracular e congelamento de contratos como padrão do projeto?',
+                options: [
+                    'Sim, estabelecer contratos congelados e isolamento de oráculos sob .prumo/',
+                    'Apenas auditar sem gerar regras adicionais',
+                ],
+            },
+        },
+    },
+];

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+export declare function register(program: {
+    description: (desc: string) => {
+        action: (fn: () => void) => void;
+    };
+}): void;
+declare const _default: {
+    register: typeof register;
+};
+export default _default;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAChC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;KAClC,CAAC;CACH,GAAG,IAAI,CAMP;;;;AAED,wBAEE"}

package/dist/cli.js

@@ -0,0 +1,10 @@
+export function register(program) {
+    program
+        .description('Speckit Prompt Zero and grill-me interview helpers')
+        .action(() => {
+        console.log('Speckit plugin active. Run `prumo interview` or activate skill prumo/spec-interviewer.');
+    });
+}
+export default {
+    register,
+};

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './catalog.js';
+export * from './skills.js';
+export * from './status.js';
+export * from './rules.js';
+export * from './scaffold.js';
+export declare function activate(): void;
+declare const _default: {
+    activate: typeof activate;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,wBAAgB,QAAQ,IAAI,IAAI,CAI/B;;;;AAED,wBAEE"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { registerInterviewCatalog, registerHarnessSkills, registerStatusProvider } from '@ihelpee/prumo';
+import { SPECKIT_INTERVIEW_CATALOG } from './catalog.js';
+import { SPECKIT_SKILLS } from './skills.js';
+import { speckitStatusProvider } from './status.js';
+export * from './catalog.js';
+export * from './skills.js';
+export * from './status.js';
+export * from './rules.js';
+export * from './scaffold.js';
+export function activate() {
+    registerInterviewCatalog('speckit', SPECKIT_INTERVIEW_CATALOG);
+    registerHarnessSkills('speckit', SPECKIT_SKILLS, 'prumo/');
+    registerStatusProvider('speckit', speckitStatusProvider);
+}
+export default {
+    activate,
+};

package/dist/messages.d.ts

@@ -0,0 +1,3 @@
+/** Rule messages. English is canonical; other locales fall back to it per key. */
+export declare const messages: import("@ihelpee/prumo/core").Translator<"speckit-intent-mapped">;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,eAAO,MAAM,QAAQ,mEAOnB,CAAC"}

package/dist/messages.js

@@ -0,0 +1,10 @@
+import { defineMessages } from '@ihelpee/prumo/core';
+/** Rule messages. English is canonical; other locales fall back to it per key. */
+export const messages = defineMessages({
+    en: {
+        'speckit-intent-mapped': 'code in codeGlobs requires a matching intent spec in .prumo/intent/',
+    },
+    'pt-BR': {
+        'speckit-intent-mapped': 'Código em codeGlobs requer especificação de intent correspondente em .prumo/intent/',
+    },
+});

package/dist/rules.d.ts

@@ -0,0 +1,5 @@
+import { type RuleDef } from '@ihelpee/prumo';
+export declare function createSpeckitRules(options?: {
+    codeGlobs?: string[];
+}): RuleDef[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAoB,MAAM,gBAAgB,CAAC;AAG7E,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,OAAO,EAAE,CAyBpF"}

package/dist/rules.js

@@ -0,0 +1,26 @@
+import { RuleBuilder } from '@ihelpee/prumo';
+import { messages } from './messages.js';
+export function createSpeckitRules(options = {}) {
+    if (!options.codeGlobs || options.codeGlobs.length === 0) {
+        return [];
+    }
+    const globs = options.codeGlobs;
+    const rule = new RuleBuilder('speckit-intent-mapped')
+        .severity('error')
+        .message(messages.text('speckit-intent-mapped'))
+        .needsData('declared')
+        .assert(async (ctx) => {
+        const targets = [];
+        const hasIntents = ctx.files.some((f) => f.includes('.prumo/intent') && f.endsWith('.md'));
+        if (!hasIntents) {
+            for (const file of ctx.files) {
+                if (globs.some((g) => file.includes(g.replace(/\*+/g, '')))) {
+                    targets.push({ target: file, location: file });
+                }
+            }
+        }
+        return targets;
+    })
+        .build();
+    return [rule];
+}

package/dist/scaffold.d.ts

@@ -0,0 +1,7 @@
+import { type SupportedLocale } from '@ihelpee/prumo/core';
+/** The grill-me intent template in `locale`, falling back to English. */
+export declare function speckitGrillMeTemplate(locale?: SupportedLocale): string;
+/** Canonical English template. */
+export declare const SPECKIT_GRILL_ME_TEMPLATE: string;
+export declare function scaffoldSpeckit(root: string, locale?: SupportedLocale): Promise<string[]>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAuC1E,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAEvE;AAED,kCAAkC;AAClC,eAAO,MAAM,yBAAyB,QAAe,CAAC;AAEtD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,eAAiC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMhH"}

package/dist/scaffold.js

@@ -0,0 +1,52 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { resolveLocale } from '@ihelpee/prumo/core';
+const TEMPLATES = {
+    en: `# Intent — Prumo Speckit (grill-me = plan mode / Prompt Zero)
+
+Authority for **specification driven by human decisions** before any code is implemented.
+
+<!-- prumo:rule: speckit-is-plan-mode -->
+## 1. Plan mode = grill-me, not implementation
+
+When the human asks to plan, for Prompt Zero, or for discovery:
+1. Activate the \`prumo/spec-interviewer\` skill (or \`prumo interview\`).
+2. Run grill-me: clear multiple-choice questions until decisions are recorded. No invented defaults.
+3. Forbidden: editing \`src/**\` or tests before the intent is frozen.
+
+## 2. Speckit outputs
+1. \`.prumo/intent/<scope>.md\`
+2. \`.prumo/invariants/<id>.ts\` (mechanical invariants only)
+3. \`.prumo/contract/**\` (when there is a public boundary)
+`,
+    'pt-BR': `# Intent — Prumo Speckit (grill-me = modo plano / Prompt Zero)
+
+Autoridade para **especificação orientada por decisões humanas** antes de qualquer implementação em código.
+
+<!-- prumo:rule: speckit-is-plan-mode -->
+## 1. Modo plano = grill-me, não implementação
+
+Quando o humano pede planejar, Prompt Zero ou descoberta:
+1. Ativar skill \`prumo/spec-interviewer\` (ou \`prumo interview\`).
+2. Conduzir grill-me: perguntas claras de múltipla escolha até registrar decisões. Zero defaults inventados.
+3. Proibido: editar \`src/**\` ou testes antes do intent congelado.
+
+## 2. Saídas do Speckit
+1. \`.prumo/intent/<escopo>.md\`
+2. \`.prumo/invariants/<id>.ts\` (apenas invariantes mecânicos)
+3. \`.prumo/contract/**\` (se houver fronteira pública)
+`,
+};
+/** The grill-me intent template in `locale`, falling back to English. */
+export function speckitGrillMeTemplate(locale) {
+    return (locale && TEMPLATES[locale]) || TEMPLATES.en;
+}
+/** Canonical English template. */
+export const SPECKIT_GRILL_ME_TEMPLATE = TEMPLATES.en;
+export async function scaffoldSpeckit(root, locale = resolveLocale()) {
+    const intentDir = join(root, '.prumo', 'intent');
+    await mkdir(intentDir, { recursive: true });
+    const grillMePath = join(intentDir, 'speckit_grill_me.md');
+    await writeFile(grillMePath, speckitGrillMeTemplate(locale), 'utf8');
+    return [grillMePath];
+}

package/dist/skills.d.ts

@@ -0,0 +1,5 @@
+import type { Skill } from '@ihelpee/prumo';
+export declare const SPEC_INTERVIEWER_SKILL: Skill;
+export declare const SPECKIT_FOREMAN_SKILL: Skill;
+export declare const SPECKIT_SKILLS: Skill[];
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,eAAO,MAAM,sBAAsB,EAAE,KAkCpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAoBnC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAAK,EAGjC,CAAC"}

package/dist/skills.js

@@ -0,0 +1,56 @@
+export const SPEC_INTERVIEWER_SKILL = {
+    name: 'spec-interviewer',
+    purpose: 'Conduct focused architectural interviews to derive intent specifications and executable AST rules.',
+    allowedReads: ['src/**', '.prumo/constitution.md', '.prumo/intent/**', 'AGENTS.md', '.agents/**', 'docs/**', 'public/docs/**'],
+    forbiddenReads: [],
+    emits: ['.prumo/intent/**', '.prumo/invariants/**', '.prumo/waivers/**'],
+    rationale: 'Resolves architectural ambiguities with the human developer before writing code, ' +
+        'capturing intent in docs and invariants simultaneously with strict boundary separation.',
+    gate: 'prumo interview',
+    titleEn: 'Spec Interviewer (Prumo Speckit)',
+    descriptionEn: 'Prumo Speckit: the plan / Prompt Zero path. Interactive grill-me interviews to derive human intent (.prumo/intent/) ' +
+        'and mechanical AST rules (.prumo/invariants/) only — then hand off to contract-author and oracle-author. ' +
+        'Replaces ad-hoc planning with decision-backed specs before any implementation brick.',
+    workflowEn: [
+        'This skill IS the Prumo plan mode. When the user says plan, specify, or discover: stay in Speckit until intent exists — no src/** or packages/*/src/** edits.',
+        'Read `packages/core/.prumo/intent/speckit_grill_me.md`, the root constitution, AGENTS.md, and existing intents; for framework work, align with product intents.',
+        'Brownfield: start from `npx prumo gaps <path>` — its questions come from the code (exported functions, optional fields of observed contracts). Ask them one at a time and wait for each answer; findings are interview input, not excuses to skip human decisions.',
+        'Before asking, read the effective `locale` from the nearest `prumo.config.ts` that owns the target scope (`en` when unset). Use it for every part of every question, regardless of the chat language: title, subtitle, introduction, facts, diagram, examples, counter-examples, options and recommendation. Keep code identifiers literal when translating them would make them incorrect.',
+        'Ask one decision at a time. Make each question self-contained so the human can answer without looking anything up: title (the decision); subtitle (module/function and location); introduction (what happens today and why the decision matters); facts needed to judge, grounded in code/intents and never assumed; a diagram when order/flow/structure matters; and options that state guarantees, an example, a counter-example and the consequence (rule enforced by oracle/gate or implementation detail). Put the recommended option first, marked "(Recommended)", and explain why.',
+        'Put the COMPLETE briefing and the decision inside the same question-tool payload. Never leave essential context only in preceding chat commentary: it can collapse or separate from the question card. If the tool exposes only `title` and `options`, make `title` a multiline briefing with labeled sections and put the full choice explanation in each option string; do not reduce options to bare labels. If the tool has separate description fields, place the relevant context there. If diagrams cannot render, use a compact text diagram inside the question payload.',
+        'If the payload is too large, remove repetition or split it into separate decisions; do not move essential facts outside the question or ask the human to consult external sources. Commentary may announce progress, but must not be the only place containing question context.',
+        'When resuming an interrupted interview or correcting its format, preserve answers already given and start at the next unresolved decision. Do not ask an answered decision again unless the human explicitly asks to revisit it.',
+        'Then submit the question through the question tool in the configured locale. If the human replies with a message instead of choosing an option, that message is the answer: record it and do not repeat the question.',
+        'Turn each answer into one rule: `<!-- prumo:rule id="R-<domain>-NNN" -->` with the statement, an example and a counter-example. If the human cannot give a counter-example, the rule is still vague: ask again.',
+        'Write the intent as `status: draft` with `covers: <module>` in its frontmatter. Show it and ask for approval; only an explicit yes sets `status: approved` and adds `<!-- prumo:approval by="<person>" -->` under each approved rule.',
+        'For each <!-- prumo:decision status=open --> in intent: MUST use the editor question tool — Cursor AskQuestion, Claude Code AskUserQuestion (one call per decision, options from <!-- option: id | label -->). Forbidden: "A or B?" only in chat prose. After human choice, write <!-- prumo:decision-resolved id=... choice=... --> in the intent file.',
+        'Grill-me without decision blocks: still use the question tool with explicit options; record outcomes in intent — never invent defaults (Art. IV).',
+        'Emit `.prumo/intent/<scope>.md` with acceptance criteria, fatia boundaries if large, and `<!-- prumo:rule id="..." -->` links where rules already exist.',
+        'Emit `.prumo/invariants/<id>.ts` (export default [rule]) ONLY for mechanical AST (guards, import boundaries, decorators). One file per rule. Business rules stay in intent + oracle/**.',
+        'Waivers: `.prumo/waivers/<id>.json` with rule, target, reason, expiry and approver (`approvedBy`) when the human approves debt.',
+        'Handoff: tell the human Speckit is complete; next agent step is contract-author and/or oracle-author per intent — then reference-implementer. Run `npx prumo gate` before claiming spec done.',
+    ],
+};
+export const SPECKIT_FOREMAN_SKILL = {
+    name: 'speckit-foreman',
+    purpose: 'Enforce Prompt Zero to Speckit interview conduction before any implementation touches code.',
+    allowedReads: ['.prumo/**', 'docs/**', 'public/docs/**', 'AGENTS.md', '.cursor/rules/**'],
+    forbiddenReads: [],
+    emits: [],
+    rationale: 'Agents attempting Prompt Zero without Speckit default to hallucinating unverified build plans. ' +
+        'This skill routes planning straight into spec-interviewer and speckit_grill_me.md.',
+    gate: 'prumo status',
+    titleEn: 'Speckit Foreman (Prompt Zero Conductor)',
+    descriptionEn: 'Dedicated conductor for Prompt Zero and early feature planning. Enforces that planning queries route ' +
+        'directly to spec-interviewer, preventing premature code generation and hallucinated requirements.',
+    workflowEn: [
+        'At Prompt Zero (new feature, redesign, or vague user prompt): activate `prumo/spec-interviewer` or run `prumo interview`.',
+        'Consult `packages/core/.prumo/intent/speckit_grill_me.md` for constitutional grill-me rules.',
+        'Halt all implementation (no edits under src/**, test/**, or oracle/**) until the human specification is committed in .prumo/intent/.',
+        'Confirm that open decision markers are resolved before handing off to contract-author.',
+    ],
+};
+export const SPECKIT_SKILLS = [
+    SPEC_INTERVIEWER_SKILL,
+    SPECKIT_FOREMAN_SKILL,
+];

package/dist/status.d.ts

@@ -0,0 +1,6 @@
+import type { StatusProviderContext } from '@ihelpee/prumo';
+export type SpeckitPhase = 'sem-intent' | 'intent-rascunho' | 'intent-congelado' | 'implementando';
+export declare function speckitStatusProvider(ctx: StatusProviderContext): Promise<{
+    speckitPhase: SpeckitPhase;
+}>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAEnG,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,YAAY,CAAA;CAAE,CAAC,CAkB/G"}

package/dist/status.js

@@ -0,0 +1,15 @@
+export async function speckitStatusProvider(ctx) {
+    const { snapshot, status } = ctx;
+    if (snapshot.intentCount === 0) {
+        return { speckitPhase: 'sem-intent' };
+    }
+    const hasOpenDecisions = snapshot.intentSpecs.some((s) => /<!--\s*prumo:decision\s+status=open/i.test(s.raw));
+    const hasSuggested = status.decisoes.some((d) => d.proveniencia === 'suggested');
+    if (hasOpenDecisions || hasSuggested) {
+        return { speckitPhase: 'intent-rascunho' };
+    }
+    if (status.etapa === 'execução' || status.etapa === 'verificação') {
+        return { speckitPhase: 'implementando' };
+    }
+    return { speckitPhase: 'intent-congelado' };
+}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@ihelpee/prumo-plugin-speckit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.18.2",
+  "type": "module",
+  "description": "Speckit plugin for Prumo: spec-interviewer, Prompt Zero foreman, interview catalog, and intent phase status.",
+  "author": "Alex Gotardi <alexgotardi@gmail.com> (https://github.com/alexgotardi)",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://github.com/ihelpee/prumo#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ihelpee/prumo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ihelpee/prumo/issues"
+  },
+  "maturity": "experimental",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "prumo": ">=0.12.0",
+  "contributes": {
+    "activate": "./dist/index.js",
+    "rules": "./dist/rules.js",
+    "cliCommands": "./dist/cli.js",
+    "statusProviders": "./dist/status.js",
+    "harness": {
+      "skills": "./dist/skills.js"
+    },
+    "description": "Speckit plugin for Prumo: spec-interviewer, Prompt Zero foreman, interview catalog, and intent phase status.",
+    "commands": [
+      "prumo interview",
+      "prumo status"
+    ]
+  },
+  "peerDependencies": {
+    "@ihelpee/prumo": "^0.18.2"
+  },
+  "devDependencies": {
+    "@ihelpee/prumo": "0.18.2",
+    "@ihelpee/prumo-plugin-typescript": "0.18.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "verify": "prumo gate --root ."
+  }
 }