@dynamicworks/br-openspec 2.0.1 → 2.1.0

package/README.md

@@ -97,7 +97,7 @@ openspec init
 
 Now tell your AI: `/opsx:propose <what-you-want-to-build>`
 
-If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
+If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
 
 > [!NOTE]
 > Not sure if your tool is supported? [View the full list](docs/supported-tools.md) – we support 25+ tools and growing.
@@ -116,6 +116,13 @@ If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/
 → **[Customization](docs/customization.md)**: make it yours
 
 
+## Community schemas
+
+Third-party schema bundles distributed via standalone repositories — these provide opinionated workflows that integrate BR-OpenSpec with other tools, similar to how [github/spec-kit's community extension catalog](https://github.com/github/spec-kit/tree/main/extensions) handles tool integrations.
+
+→ **[Browse the catalog](docs/customization.md#community-schemas)** in the customization docs.
+
+
 ## Why BR-OpenSpec?
 
 AI coding assistants are powerful but unpredictable when requirements live only in chat history. BR-OpenSpec adds a lightweight spec layer so you agree on what to build before any code is written.
@@ -161,10 +168,12 @@ openspec tools --remove windsurf
 
 ## Usage Notes
 
-**Model selection**: BR-OpenSpec works best with high-reasoning models. We recommend Opus 4.5 and GPT 5.2 for both planning and implementation.
+**Model selection**: BR-OpenSpec works best with high-reasoning models. We recommend Codex 5.5 and Opus 4.8 for both planning and implementation.
 
 **Context hygiene**: BR-OpenSpec benefits from a clean context window. Clear your context before starting implementation and maintain good context hygiene throughout your session.
 
+**Spec keywords stay in English**: BR-OpenSpec is PT-BR first, but the spec format is a protocol read by the tooling. Structural markers (`## ADDED Requirements`, `### Requirement:`, `#### Scenario:`) and normative/scenario keywords (RFC 2119 — `MUST`, `SHALL`, `SHOULD`, `MAY`, … — plus `WHEN`, `THEN`, `AND`, `GIVEN`, `ELSE`) are always written in English and UPPERCASE; only the descriptive text is in Portuguese. Translating these keywords breaks `openspec validate`. See the full list in [AGENTS.md](AGENTS.md#reserved-english-terms-never-translate).
+
 ## Contributing
 
 **Small fixes** — Bug fixes, typo corrections, and minor improvements can be submitted directly as PRs.

package/README.pt-BR.md

@@ -97,7 +97,7 @@ openspec init
 
 Agora diga à sua IA: `/opsx:propose <o-que-você-quer-construir>`
 
-Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), selecione-o com `openspec config profile` e aplique com `openspec update`.
+Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:bulk-archive`, `/opsx:onboard`), selecione-o com `openspec config profile` e aplique com `openspec update`.
 
 > [!NOTE]
 > Não tem certeza se sua ferramenta é suportada? [Veja a lista completa](docs/pt-BR/supported-tools.md) – suportamos mais de 25 ferramentas e crescendo.
@@ -116,6 +116,13 @@ Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/
 → **[Personalização](docs/pt-BR/customization.md)**: faça do seu jeito
 
 
+## Schemas da comunidade
+
+Bundles de schema de terceiros distribuídos em repositórios independentes — oferecem fluxos de trabalho opinativos que integram o BR-OpenSpec a outras ferramentas, de forma semelhante a como o [catálogo de extensões da comunidade do github/spec-kit](https://github.com/github/spec-kit/tree/main/extensions) trata integrações de ferramentas.
+
+→ **[Veja o catálogo](docs/pt-BR/customization.md#schemas-da-comunidade)** na documentação de personalização.
+
+
 ## Por que o BR-OpenSpec?
 
 Assistentes de codificação com IA são poderosos, mas imprevisíveis quando os requisitos vivem apenas no histórico do chat. O BR-OpenSpec adiciona uma camada leve de especificação para que você concorde sobre o que construir antes de qualquer código ser escrito.
@@ -163,10 +170,12 @@ openspec tools --remove windsurf
 
 ## Notas de Uso
 
-**Seleção de modelo**: O BR-OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Opus 4.5 e GPT 5.2 tanto para planejamento quanto para implementação.
+**Seleção de modelo**: O BR-OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Codex 5.5 e Opus 4.8 tanto para planejamento quanto para implementação.
 
 **Higiene de contexto**: O BR-OpenSpec se beneficia de uma janela de contexto limpa. Limpe seu contexto antes de iniciar a implementação e mantenha uma boa higiene de contexto ao longo da sua sessão.
 
+**Palavras-chave do formato de spec ficam em inglês**: O BR-OpenSpec é PT-BR first, mas o formato de spec é um protocolo lido pelas ferramentas. Os marcadores estruturais (`## ADDED Requirements`, `### Requirement:`, `#### Scenario:`) e as palavras-chave normativas/de cenário (RFC 2119 — `MUST`, `SHALL`, `SHOULD`, `MAY`, … — além de `WHEN`, `THEN`, `AND`, `GIVEN`, `ELSE`) são sempre escritas em inglês e em CAIXA ALTA; apenas o texto descritivo fica em português. Traduzir essas palavras-chave quebra o `openspec validate`. Veja a lista completa em [AGENTS.md](AGENTS.md#reserved-english-terms-never-translate).
+
 ## Contribuindo
 
 **Pequenas correções** — Correções de bugs, erros de digitação e melhorias menores podem ser enviadas diretamente como PRs.

package/dist/commands/config.js

@@ -48,6 +48,10 @@ const WORKFLOW_PROMPT_META = {
         name: CONFIG_MESSAGES.workflowVerifyName,
         description: CONFIG_MESSAGES.workflowVerifyDesc,
     },
+    'code-review': {
+        name: CONFIG_MESSAGES.workflowCodeReviewName,
+        description: CONFIG_MESSAGES.workflowCodeReviewDesc,
+    },
     onboard: {
         name: CONFIG_MESSAGES.workflowOnboardName,
         description: CONFIG_MESSAGES.workflowOnboardDesc,

package/dist/commands/schema.js

@@ -797,72 +797,72 @@ function createDefaultTemplate(artifactId) {
         case 'proposal':
             return `## Why
 
-<!-- Describe the motivation for this change -->
+<!-- Descreva a motivação para esta mudança -->
 
 ## What Changes
 
-<!-- Describe what will change -->
+<!-- Descreva o que vai mudar -->
 
 ## Capabilities
 
 ### New Capabilities
-<!-- List new capabilities -->
+<!-- Liste as novas capabilities -->
 
 ### Modified Capabilities
-<!-- List modified capabilities -->
+<!-- Liste as capabilities modificadas -->
 
 ## Impact
 
-<!-- Describe the impact on existing functionality -->
+<!-- Descreva o impacto sobre a funcionalidade existente -->
 `;
         case 'specs':
             return `## ADDED Requirements
 
-### Requirement: Example requirement
+### Requirement: Requisito de exemplo
 
-Description of the requirement.
+Descrição do requisito.
 
-#### Scenario: Example scenario
-- **WHEN** some condition
-- **THEN** some outcome
+#### Scenario: Cenário de exemplo
+- **WHEN** alguma condição
+- **THEN** algum resultado
 `;
         case 'design':
             return `## Context
 
-<!-- Background and context -->
+<!-- Contexto e antecedentes -->
 
 ## Goals / Non-Goals
 
 **Goals:**
-<!-- List goals -->
+<!-- Liste os objetivos -->
 
 **Non-Goals:**
-<!-- List non-goals -->
+<!-- Liste os não-objetivos -->
 
 ## Decisions
 
-### 1. Decision Name
+### 1. Nome da Decisão
 
-Description and rationale.
+Descrição e justificativa.
 
 **Alternatives considered:**
-- Alternative 1: Rejected because...
+- Alternativa 1: Rejeitada porque...
 
 ## Risks / Trade-offs
 
-<!-- List risks and trade-offs -->
+<!-- Liste os riscos e trade-offs -->
 `;
         case 'tasks':
             return `## Implementation Tasks
 
-- [ ] Task 1
-- [ ] Task 2
-- [ ] Task 3
+- [ ] Tarefa 1
+- [ ] Tarefa 2
+- [ ] Tarefa 3
 `;
         default:
             return `## ${artifactId}
 
-<!-- Add content here -->
+<!-- Adicione o conteúdo aqui -->
 `;
     }
 }

package/dist/core/completions/installers/zsh-installer.d.ts

@@ -59,14 +59,6 @@ export declare class ZshInstaller {
      * @returns true if .zshrc exists and has markers
      */
     private hasZshrcConfig;
-    /**
-     * Check if fpath configuration is needed for a given directory
-     * Used to verify if Oh My Zsh (or other) completions directory is already in fpath
-     *
-     * @param completionsDir - Directory to check for in fpath
-     * @returns true if configuration is needed, false if directory is already referenced
-     */
-    private needsFpathConfig;
     /**
      * Remove .zshrc configuration
      * Used during uninstallation

package/dist/core/completions/installers/zsh-installer.js

@@ -148,26 +148,6 @@ export class ZshInstaller {
             return false;
         }
     }
-    /**
-     * Check if fpath configuration is needed for a given directory
-     * Used to verify if Oh My Zsh (or other) completions directory is already in fpath
-     *
-     * @param completionsDir - Directory to check for in fpath
-     * @returns true if configuration is needed, false if directory is already referenced
-     */
-    async needsFpathConfig(completionsDir) {
-        try {
-            const zshrcPath = this.getZshrcPath();
-            const content = await fs.readFile(zshrcPath, 'utf-8');
-            // Check if fpath already includes this directory
-            return !content.includes(completionsDir);
-        }
-        catch (error) {
-            // If we can't read .zshrc, assume config is needed
-            console.debug(`Unable to read .zshrc to check fpath config: ${error instanceof Error ? error.message : String(error)}`);
-            return true;
-        }
-    }
     /**
      * Remove .zshrc configuration
      * Used during uninstallation
@@ -256,18 +236,10 @@ export class ZshInstaller {
             const backupPath = isUpdate ? await this.backupExistingFile(targetPath) : undefined;
             // Write the completion script
             await fs.writeFile(targetPath, completionScript, 'utf-8');
-            // Auto-configure .zshrc
+            // Auto-configure .zshrc for standard Zsh only.
+            // Oh My Zsh loads custom/completions and runs compinit itself.
             let zshrcConfigured = false;
-            if (isOhMyZsh) {
-                // For Oh My Zsh, verify that custom/completions is in fpath
-                // If not, add it to .zshrc
-                const needsConfig = await this.needsFpathConfig(targetDir);
-                if (needsConfig) {
-                    zshrcConfigured = await this.configureZshrc(targetDir);
-                }
-            }
-            else {
-                // Standard Zsh always needs .zshrc configuration
+            if (!isOhMyZsh) {
                 zshrcConfigured = await this.configureZshrc(targetDir);
             }
             // Generate instructions (only if .zshrc wasn't auto-configured)

package/dist/core/config.js

@@ -23,12 +23,13 @@ export const AI_TOOLS = [
     { name: 'iFlow', value: 'iflow', available: true, successLabel: 'iFlow', skillsDir: '.iflow' },
     { name: 'Junie', value: 'junie', available: true, successLabel: 'Junie', skillsDir: '.junie' },
     { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code', skillsDir: '.kilocode' },
-    { name: 'Kimi Code CLI', value: 'kimi', available: true, successLabel: 'Kimi Code CLI', skillsDir: '.kimi' },
+    { name: 'Kimi CLI', value: 'kimi', available: true, successLabel: 'Kimi CLI', skillsDir: '.kimi' },
     { name: 'Kiro', value: 'kiro', available: true, successLabel: 'Kiro', skillsDir: '.kiro' },
+    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
+    { name: 'Mistral Vibe', value: 'vibe', available: true, successLabel: 'Mistral Vibe', skillsDir: '.vibe' },
     { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode', skillsDir: '.opencode' },
     { name: 'Pi', value: 'pi', available: true, successLabel: 'Pi', skillsDir: '.pi' },
     { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },
-    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
     { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen' },
     { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo' },
     { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae' },

package/dist/core/global-config.d.ts

@@ -25,7 +25,12 @@ export declare function getGlobalConfigDir(): string;
  * - Unix/macOS fallback: ~/.local/share/openspec/
  * - Windows fallback: %LOCALAPPDATA%/openspec/
  */
-export declare function getGlobalDataDir(): string;
+export interface GlobalDataDirOptions {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    homedir?: string;
+}
+export declare function getGlobalDataDir(options?: GlobalDataDirOptions): string;
 /**
  * Gets the path to the global config file.
  */

package/dist/core/global-config.js

@@ -36,32 +36,31 @@ export function getGlobalConfigDir() {
     // Unix/macOS fallback: ~/.config
     return path.join(os.homedir(), '.config', GLOBAL_CONFIG_DIR_NAME);
 }
-/**
- * Gets the global data directory path following XDG Base Directory Specification.
- * Used for user data like schema overrides.
- *
- * - All platforms: $XDG_DATA_HOME/openspec/ if XDG_DATA_HOME is set
- * - Unix/macOS fallback: ~/.local/share/openspec/
- * - Windows fallback: %LOCALAPPDATA%/openspec/
- */
-export function getGlobalDataDir() {
+function joinGlobalDataPath(platform, ...segments) {
+    return platform === 'win32'
+        ? path.win32.join(...segments)
+        : path.posix.join(...segments);
+}
+export function getGlobalDataDir(options = {}) {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? os.platform();
     // XDG_DATA_HOME takes precedence on all platforms when explicitly set
-    const xdgDataHome = process.env.XDG_DATA_HOME;
+    const xdgDataHome = env.XDG_DATA_HOME;
     if (xdgDataHome) {
-        return path.join(xdgDataHome, GLOBAL_DATA_DIR_NAME);
+        return joinGlobalDataPath(platform, xdgDataHome, GLOBAL_DATA_DIR_NAME);
     }
-    const platform = os.platform();
+    const homedir = options.homedir ?? os.homedir();
     if (platform === 'win32') {
         // Windows: use %LOCALAPPDATA%
-        const localAppData = process.env.LOCALAPPDATA;
+        const localAppData = env.LOCALAPPDATA;
         if (localAppData) {
-            return path.join(localAppData, GLOBAL_DATA_DIR_NAME);
+            return joinGlobalDataPath(platform, localAppData, GLOBAL_DATA_DIR_NAME);
         }
         // Fallback for Windows if LOCALAPPDATA is not set
-        return path.join(os.homedir(), 'AppData', 'Local', GLOBAL_DATA_DIR_NAME);
+        return joinGlobalDataPath(platform, homedir, 'AppData', 'Local', GLOBAL_DATA_DIR_NAME);
     }
     // Unix/macOS fallback: ~/.local/share
-    return path.join(os.homedir(), '.local', 'share', GLOBAL_DATA_DIR_NAME);
+    return joinGlobalDataPath(platform, homedir, '.local', 'share', GLOBAL_DATA_DIR_NAME);
 }
 /**
  * Gets the path to the global config file.

package/dist/core/parsers/requirement-blocks.js

@@ -1,7 +1,7 @@
 export function normalizeRequirementName(name) {
     return name.trim();
 }
-const REQUIREMENT_HEADER_REGEX = /^###\s*Requirement:\s*(.+)\s*$/;
+const REQUIREMENT_HEADER_REGEX = /^###\s*Requirement:\s*(.+)\s*$/i;
 /**
  * Extracts the Requirements section from a spec file and parses requirement blocks.
  */
@@ -37,7 +37,7 @@ export function extractRequirementsSection(content) {
     let cursor = 0;
     let preambleLines = [];
     // Collect preamble lines until first requirement header
-    while (cursor < sectionBodyLines.length && !/^###\s+Requirement:/.test(sectionBodyLines[cursor])) {
+    while (cursor < sectionBodyLines.length && !REQUIREMENT_HEADER_REGEX.test(sectionBodyLines[cursor])) {
         preambleLines.push(sectionBodyLines[cursor]);
         cursor++;
     }
@@ -54,7 +54,7 @@ export function extractRequirementsSection(content) {
         cursor++;
         // Gather lines until next requirement header or end of section
         const bodyLines = [headerLineCandidate];
-        while (cursor < sectionBodyLines.length && !/^###\s+Requirement:/.test(sectionBodyLines[cursor]) && !/^##\s+/.test(sectionBodyLines[cursor])) {
+        while (cursor < sectionBodyLines.length && !REQUIREMENT_HEADER_REGEX.test(sectionBodyLines[cursor]) && !/^##\s+/.test(sectionBodyLines[cursor])) {
             bodyLines.push(sectionBodyLines[cursor]);
             cursor++;
         }
@@ -136,7 +136,7 @@ function parseRequirementBlocksFromSection(sectionBody) {
     let i = 0;
     while (i < lines.length) {
         // Seek next requirement header
-        while (i < lines.length && !/^###\s+Requirement:/.test(lines[i]))
+        while (i < lines.length && !REQUIREMENT_HEADER_REGEX.test(lines[i]))
             i++;
         if (i >= lines.length)
             break;
@@ -149,7 +149,7 @@ function parseRequirementBlocksFromSection(sectionBody) {
         const name = normalizeRequirementName(m[1]);
         const buf = [headerLine];
         i++;
-        while (i < lines.length && !/^###\s+Requirement:/.test(lines[i]) && !/^##\s+/.test(lines[i])) {
+        while (i < lines.length && !REQUIREMENT_HEADER_REGEX.test(lines[i]) && !/^##\s+/.test(lines[i])) {
             buf.push(lines[i]);
             i++;
         }

package/dist/core/parsers/spec-structure.js

@@ -1,7 +1,7 @@
 const REQUIREMENTS_SECTION_HEADER = /^##\s+Requirements\s*$/i;
 const TOP_LEVEL_SECTION_HEADER = /^##\s+/;
 const DELTA_HEADER = /^##\s+(ADDED|MODIFIED|REMOVED|RENAMED)\s+Requirements\s*$/i;
-const REQUIREMENT_HEADER = /^###\s+Requirement:\s*(.+)\s*$/;
+const REQUIREMENT_HEADER = /^###\s+Requirement:\s*(.+)\s*$/i;
 export function findMainSpecStructureIssues(content) {
     const normalized = content.replace(/\r\n?/g, '\n');
     const stripped = stripFencedCodeBlocksPreservingLines(normalized);

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

@@ -17,6 +17,7 @@ export const WORKFLOW_TO_SKILL_DIR = {
     'archive': 'openspec-archive-change',
     'bulk-archive': 'openspec-bulk-archive-change',
     'verify': 'openspec-verify-change',
+    'code-review': 'openspec-code-review',
     'onboard': 'openspec-onboard',
     'propose': 'openspec-propose',
 };

package/dist/core/profiles.d.ts

@@ -9,11 +9,11 @@ import type { Profile } from './global-config.js';
  * Core workflows included in the 'core' profile.
  * These provide the streamlined experience for new users.
  */
-export declare const CORE_WORKFLOWS: readonly ["propose", "explore", "apply", "archive"];
+export declare const CORE_WORKFLOWS: readonly ["propose", "explore", "apply", "sync", "archive"];
 /**
  * All available workflows in the system.
  */
-export declare const ALL_WORKFLOWS: readonly ["propose", "explore", "new", "continue", "apply", "ff", "sync", "archive", "bulk-archive", "verify", "onboard"];
+export declare const ALL_WORKFLOWS: readonly ["propose", "explore", "new", "continue", "apply", "ff", "sync", "archive", "bulk-archive", "verify", "code-review", "onboard"];
 export type WorkflowId = (typeof ALL_WORKFLOWS)[number];
 export type CoreWorkflowId = (typeof CORE_WORKFLOWS)[number];
 /**

package/dist/core/profiles.js

@@ -8,7 +8,7 @@
  * Core workflows included in the 'core' profile.
  * These provide the streamlined experience for new users.
  */
-export const CORE_WORKFLOWS = ['propose', 'explore', 'apply', 'archive'];
+export const CORE_WORKFLOWS = ['propose', 'explore', 'apply', 'sync', 'archive'];
 /**
  * All available workflows in the system.
  */
@@ -23,6 +23,7 @@ export const ALL_WORKFLOWS = [
     'archive',
     'bulk-archive',
     'verify',
+    'code-review',
     'onboard',
 ];
 /**

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, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getOnboardSkillTemplate, getOpsxProposeSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxBulkArchiveCommandTemplate, getOpsxVerifyCommandTemplate, getOpsxOnboardCommandTemplate, getOpsxProposeCommandTemplate, } from '../templates/skill-templates.js';
+import { getExploreSkillTemplate, getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getBulkArchiveChangeSkillTemplate, getVerifyChangeSkillTemplate, getCodeReviewSkillTemplate, getOnboardSkillTemplate, getOpsxProposeSkillTemplate, getOpsxExploreCommandTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxBulkArchiveCommandTemplate, getOpsxVerifyCommandTemplate, getOpsxCodeReviewCommandTemplate, getOpsxOnboardCommandTemplate, getOpsxProposeCommandTemplate, } from '../templates/skill-templates.js';
 /**
  * Gets skill templates with their directory names, optionally filtered by workflow IDs.
  *
@@ -20,6 +20,7 @@ export function getSkillTemplates(workflowFilter) {
         { template: getArchiveChangeSkillTemplate(), dirName: 'openspec-archive-change', workflowId: 'archive' },
         { template: getBulkArchiveChangeSkillTemplate(), dirName: 'openspec-bulk-archive-change', workflowId: 'bulk-archive' },
         { template: getVerifyChangeSkillTemplate(), dirName: 'openspec-verify-change', workflowId: 'verify' },
+        { template: getCodeReviewSkillTemplate(), dirName: 'openspec-code-review', workflowId: 'code-review' },
         { template: getOnboardSkillTemplate(), dirName: 'openspec-onboard', workflowId: 'onboard' },
         { template: getOpsxProposeSkillTemplate(), dirName: 'openspec-propose', workflowId: 'propose' },
     ];
@@ -44,6 +45,7 @@ export function getCommandTemplates(workflowFilter) {
         { template: getOpsxArchiveCommandTemplate(), id: 'archive' },
         { template: getOpsxBulkArchiveCommandTemplate(), id: 'bulk-archive' },
         { template: getOpsxVerifyCommandTemplate(), id: 'verify' },
+        { template: getOpsxCodeReviewCommandTemplate(), id: 'code-review' },
         { template: getOpsxOnboardCommandTemplate(), id: 'onboard' },
         { template: getOpsxProposeCommandTemplate(), id: 'propose' },
     ];

package/dist/core/shared/tool-detection.d.ts

@@ -6,12 +6,12 @@
 /**
  * Names of skill directories created by openspec init.
  */
-export declare const SKILL_NAMES: readonly ["openspec-explore", "openspec-new-change", "openspec-continue-change", "openspec-apply-change", "openspec-ff-change", "openspec-sync-specs", "openspec-archive-change", "openspec-bulk-archive-change", "openspec-verify-change", "openspec-onboard", "openspec-propose"];
+export declare const SKILL_NAMES: readonly ["openspec-explore", "openspec-new-change", "openspec-continue-change", "openspec-apply-change", "openspec-ff-change", "openspec-sync-specs", "openspec-archive-change", "openspec-bulk-archive-change", "openspec-verify-change", "openspec-code-review", "openspec-onboard", "openspec-propose"];
 export type SkillName = (typeof SKILL_NAMES)[number];
 /**
  * IDs of command templates created by openspec init.
  */
-export declare const COMMAND_IDS: readonly ["explore", "new", "continue", "apply", "ff", "sync", "archive", "bulk-archive", "verify", "onboard", "propose"];
+export declare const COMMAND_IDS: readonly ["explore", "new", "continue", "apply", "ff", "sync", "archive", "bulk-archive", "verify", "code-review", "onboard", "propose"];
 export type CommandId = (typeof COMMAND_IDS)[number];
 /**
  * Status of skill configuration for a tool.

package/dist/core/shared/tool-detection.js

@@ -19,6 +19,7 @@ export const SKILL_NAMES = [
     'openspec-archive-change',
     'openspec-bulk-archive-change',
     'openspec-verify-change',
+    'openspec-code-review',
     'openspec-onboard',
     'openspec-propose',
 ];
@@ -35,6 +36,7 @@ export const COMMAND_IDS = [
     'archive',
     'bulk-archive',
     'verify',
+    'code-review',
     'onboard',
     'propose',
 ];

package/dist/core/specs-apply.js

@@ -211,7 +211,7 @@ export async function buildUpdatedSpec(update, changeName) {
             throw new Error(SPECS_APPLY_MESSAGES.modifiedFailedNotFound(specName, mod.name));
         }
         // Replace block with provided raw (ensure header line matches key)
-        const modHeaderMatch = mod.raw.split('\n')[0].match(/^###\s*Requirement:\s*(.+)\s*$/);
+        const modHeaderMatch = mod.raw.split('\n')[0].match(/^###\s*Requirement:\s*(.+)\s*$/i);
         if (!modHeaderMatch || normalizeRequirementName(modHeaderMatch[1]) !== key) {
             throw new Error(SPECS_APPLY_MESSAGES.modifiedFailedHeaderMismatch(specName, mod.name));
         }

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

@@ -13,8 +13,8 @@ export { getSyncSpecsSkillTemplate, getOpsxSyncCommandTemplate } from './workflo
 export { getArchiveChangeSkillTemplate, getOpsxArchiveCommandTemplate } from './workflows/archive-change.js';
 export { getBulkArchiveChangeSkillTemplate, getOpsxBulkArchiveCommandTemplate } from './workflows/bulk-archive-change.js';
 export { getVerifyChangeSkillTemplate, getOpsxVerifyCommandTemplate } from './workflows/verify-change.js';
+export { getCodeReviewSkillTemplate, getOpsxCodeReviewCommandTemplate } from './workflows/code-review.js';
 export { getOnboardSkillTemplate, getOpsxOnboardCommandTemplate } from './workflows/onboard.js';
 export { getOpsxProposeSkillTemplate, getOpsxProposeCommandTemplate } from './workflows/propose.js';
 export { getFeedbackSkillTemplate } from './workflows/feedback.js';
-export { getUpstreamSyncSkillTemplate, getOpsxUpstreamSyncCommandTemplate } from './workflows/upstream-sync.js';
 //# sourceMappingURL=skill-templates.d.ts.map

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

@@ -12,8 +12,8 @@ export { getSyncSpecsSkillTemplate, getOpsxSyncCommandTemplate } from './workflo
 export { getArchiveChangeSkillTemplate, getOpsxArchiveCommandTemplate } from './workflows/archive-change.js';
 export { getBulkArchiveChangeSkillTemplate, getOpsxBulkArchiveCommandTemplate } from './workflows/bulk-archive-change.js';
 export { getVerifyChangeSkillTemplate, getOpsxVerifyCommandTemplate } from './workflows/verify-change.js';
+export { getCodeReviewSkillTemplate, getOpsxCodeReviewCommandTemplate } from './workflows/code-review.js';
 export { getOnboardSkillTemplate, getOpsxOnboardCommandTemplate } from './workflows/onboard.js';
 export { getOpsxProposeSkillTemplate, getOpsxProposeCommandTemplate } from './workflows/propose.js';
 export { getFeedbackSkillTemplate } from './workflows/feedback.js';
-export { getUpstreamSyncSkillTemplate, getOpsxUpstreamSyncCommandTemplate } from './workflows/upstream-sync.js';
 //# sourceMappingURL=skill-templates.js.map

package/dist/core/templates/workflows/code-review.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Skill Template Workflow Modules
+ *
+ * This file is generated by splitting the legacy monolithic
+ * templates file into workflow-focused modules.
+ */
+import type { SkillTemplate, CommandTemplate } from '../types.js';
+export declare function getCodeReviewSkillTemplate(): SkillTemplate;
+export declare function getOpsxCodeReviewCommandTemplate(): CommandTemplate;
+//# sourceMappingURL=code-review.d.ts.map

package/dist/core/templates/workflows/code-review.js

@@ -0,0 +1,21 @@
+import { CODE_REVIEW_TEMPLATE_MESSAGES } from '../../../messages/index.js';
+export function getCodeReviewSkillTemplate() {
+    return {
+        name: 'openspec-code-review',
+        description: CODE_REVIEW_TEMPLATE_MESSAGES.skillDescription,
+        instructions: CODE_REVIEW_TEMPLATE_MESSAGES.instructions,
+        license: 'MIT',
+        compatibility: CODE_REVIEW_TEMPLATE_MESSAGES.skillCompatibility,
+        metadata: { author: 'openspec', version: '1.0' },
+    };
+}
+export function getOpsxCodeReviewCommandTemplate() {
+    return {
+        name: 'OPSX: Code Review',
+        description: CODE_REVIEW_TEMPLATE_MESSAGES.opsxDescription,
+        category: 'Workflow',
+        tags: ['workflow', 'review', 'code-review', 'experimental'],
+        content: CODE_REVIEW_TEMPLATE_MESSAGES.instructions,
+    };
+}
+//# sourceMappingURL=code-review.js.map

package/dist/core/templates/workflows/sync-specs.js

@@ -75,7 +75,7 @@ Esta é uma operação **dirigida por agente** — você lerá os delta specs e
 ## ADDED Requirements
 
 ### Requirement: New Feature
-O sistema DEVERÁ fazer algo novo.
+The system SHALL do something new.
 
 #### Scenario: Basic case
 - **WHEN** user does X
@@ -213,7 +213,7 @@ Esta é uma operação **dirigida por agente** — você lerá os delta specs e
 ## ADDED Requirements
 
 ### Requirement: New Feature
-O sistema DEVERÁ fazer algo novo.
+The system SHALL do something new.
 
 #### Scenario: Basic case
 - **WHEN** user does X

package/dist/core/tools-manager.js

@@ -29,6 +29,7 @@ const WORKFLOW_TO_SKILL_DIR = {
     archive: 'openspec-archive-change',
     'bulk-archive': 'openspec-bulk-archive-change',
     verify: 'openspec-verify-change',
+    'code-review': 'openspec-code-review',
     onboard: 'openspec-onboard',
     propose: 'openspec-propose',
 };

package/dist/core/update.d.ts

@@ -38,6 +38,12 @@ export declare class UpdateCommand {
      * Displays a note about extra workflows installed that aren't in the current profile.
      */
     private displayExtraWorkflowsNote;
+    /**
+     * Sugere voltar ao perfil core quando um perfil personalizado ainda
+     * corresponde ao conjunto core antigo (anterior ao sync). Mantém os perfis
+     * personalizados sob controle do usuário; não os altera.
+     */
+    private displayOldCoreCustomProfileNote;
     /**
      * Removes skill directories for workflows when delivery changed to commands-only.
      * Returns the number of directories removed.