@juancr11/sibu 0.5.3 → 0.7.0

package/bin/modules/workflow-target-planning/workflow-targets.js

@@ -0,0 +1,125 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { SIBU_VERSION } from '../version-advisory/index.js';
+import { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, } from './index.js';
+import { sha256 } from '../../shared/hash.js';
+import { removeUndefinedFields } from '../../shared/object.js';
+import { readExistingState } from '../workflow-state-registry/index.js';
+import { getTemplateVersion, readTemplate, readTemplateManifest, renderSkillRouting } from '../template-catalog-rendering/index.js';
+export function getSelectedLanguageSkillsFromState(state) {
+    return SELECTABLE_LANGUAGE_SKILLS.filter((skill) => state.selectedLanguageSkills?.includes(skill.id));
+}
+export function getSelectedFrameworkSkillsFromState(state) {
+    return SELECTABLE_FRAMEWORK_SKILLS.filter((skill) => state.selectedFrameworkSkills?.includes(skill.id));
+}
+export function getSelectedArchitectureSkillFromState(state) {
+    return SELECTABLE_ARCHITECTURE_SKILLS.find((skill) => skill.id === state.selectedArchitectureSkill);
+}
+export function getSelectedWorkflowSkillsFromState(state) {
+    return SELECTABLE_WORKFLOW_SKILLS.filter((skill) => state.selectedWorkflowSkills?.includes(skill.id));
+}
+export function getSelectedSkillTargetsForAgents(selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = []) {
+    const skillTargets = new Map();
+    const selectedSkills = [
+        ...MANDATORY_SKILLS,
+        ...selectedLanguageSkills,
+        ...selectedFrameworkSkills,
+        ...(selectedArchitectureSkill ? [selectedArchitectureSkill] : []),
+        ...selectedWorkflowSkills,
+    ];
+    for (const agent of selectedAgents) {
+        for (const skill of selectedSkills) {
+            const targetRelativePath = skill.targetRelativePathsByAgent[agent.id];
+            if (!targetRelativePath) {
+                continue;
+            }
+            skillTargets.set(targetRelativePath, {
+                targetRelativePath,
+                templateRelativePath: skill.templateRelativePath,
+            });
+        }
+    }
+    return [...skillTargets.values()];
+}
+export function getWorkflowTargets(rootPath, selectedAgents, selectedLanguageSkills = [], selectedFrameworkSkills = [], selectedArchitectureSkill, selectedWorkflowSkills = []) {
+    return [
+        {
+            label: 'AGENTS.md',
+            targetPath: path.join(rootPath, 'AGENTS.md'),
+            templateRelativePath: 'AGENTS.md',
+            requiresProjectOverview: true,
+        },
+        ...selectedAgents.flatMap((agent) => {
+            if (!agent.targetRelativePath || !agent.templateRelativePath) {
+                return [];
+            }
+            return [
+                {
+                    label: agent.targetRelativePath,
+                    targetPath: path.join(rootPath, agent.targetRelativePath),
+                    templateRelativePath: agent.templateRelativePath,
+                    requiresProjectOverview: false,
+                },
+            ];
+        }),
+        ...getSelectedSkillTargetsForAgents(selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills).map((skillTarget) => ({
+            label: skillTarget.targetRelativePath,
+            targetPath: path.join(rootPath, skillTarget.targetRelativePath),
+            templateRelativePath: skillTarget.templateRelativePath,
+            requiresProjectOverview: false,
+        })),
+    ];
+}
+export function renderMissingWorkflowFiles({ missingTargets, overview, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], }) {
+    return missingTargets.map((target) => {
+        let contents = readTemplate(target.templateRelativePath);
+        if (target.requiresProjectOverview) {
+            if (!overview?.trim()) {
+                throw new Error('Project overview is required to create AGENTS.md.');
+            }
+            contents = contents.replace('{{PROJECT_OVERVIEW}}', overview.trim());
+        }
+        contents = renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills);
+        return {
+            label: target.label,
+            targetPath: target.targetPath,
+            contents,
+        };
+    });
+}
+export function writeSibuState({ rootPath, statePath, selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], targets, }) {
+    const previousState = readExistingState(statePath);
+    const now = new Date().toISOString();
+    const manifest = readTemplateManifest();
+    const state = {
+        sibuVersion: SIBU_VERSION,
+        templateVersion: manifest.templateVersion,
+        generatedAt: previousState?.generatedAt ?? now,
+        updatedAt: now,
+        selectedAgents: selectedAgents.map((agent) => agent.id),
+        selectedLanguageSkills: selectedLanguageSkills.map((skill) => skill.id),
+        selectedFrameworkSkills: selectedFrameworkSkills.map((skill) => skill.id),
+        selectedArchitectureSkill: selectedArchitectureSkill?.id,
+        selectedWorkflowSkills: selectedWorkflowSkills.map((skill) => skill.id),
+        managedFiles: Object.fromEntries(targets
+            .filter((target) => fs.existsSync(target.targetPath))
+            .map((target) => {
+            const relativePath = path.relative(rootPath, target.targetPath);
+            const previousManagedFile = previousState?.managedFiles[relativePath];
+            const nextManagedFile = {
+                template: target.templateRelativePath,
+                templateVersion: getTemplateVersion(manifest, target.templateRelativePath),
+                sha256: sha256(fs.readFileSync(target.targetPath, 'utf8')),
+                status: previousManagedFile?.status ?? 'managed',
+                lastReviewedTemplateVersion: previousManagedFile?.lastReviewedTemplateVersion,
+                reason: previousManagedFile?.reason,
+            };
+            return [relativePath, removeUndefinedFields(nextManagedFile)];
+        })),
+    };
+    fs.mkdirSync(path.dirname(statePath), { recursive: true });
+    fs.writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
+}
+export function getSelectedAgentsFromState(state) {
+    return SUPPORTED_AGENTS.filter((agent) => state.selectedAgents.includes(agent.id));
+}

package/bin/shared/catalog.js

@@ -1,245 +1 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-export const SIBU_PACKAGE_NAME = '@juancr11/sibu';
-export const SIBU_VERSION = readPackageVersion();
 export const STATE_RELATIVE_PATH = '.sibu/state.json';
-export const NPM_VERSION_LOOKUP_MODE_ENV = 'SIBU_NPM_LOOKUP_MODE';
-export const NPM_VERSION_OVERRIDE_ENV = 'SIBU_NPM_LATEST_VERSION';
-export const SIBU_CACHE_HOME_ENV = 'SIBU_CACHE_HOME';
-export const SUPPORTED_NPM_LOOKUP_MODES = ['live', 'offline'];
-export const MANDATORY_SKILLS = [
-    {
-        templateRelativePath: 'skills/clean-code/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/clean-code/SKILL.md',
-            gemini: '.agents/skills/clean-code/SKILL.md',
-            claude: '.agents/skills/clean-code/SKILL.md',
-            windsurf: '.agents/skills/clean-code/SKILL.md',
-        },
-    },
-    {
-        templateRelativePath: 'skills/product-vision-writer/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/product-vision-writer/SKILL.md',
-            gemini: '.agents/skills/product-vision-writer/SKILL.md',
-            claude: '.agents/skills/product-vision-writer/SKILL.md',
-            windsurf: '.agents/skills/product-vision-writer/SKILL.md',
-        },
-    },
-    {
-        templateRelativePath: 'skills/feature-brief-writer/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/feature-brief-writer/SKILL.md',
-            gemini: '.agents/skills/feature-brief-writer/SKILL.md',
-            claude: '.agents/skills/feature-brief-writer/SKILL.md',
-            windsurf: '.agents/skills/feature-brief-writer/SKILL.md',
-        },
-    },
-    {
-        templateRelativePath: 'skills/technical-design-writer/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/technical-design-writer/SKILL.md',
-            gemini: '.agents/skills/technical-design-writer/SKILL.md',
-            claude: '.agents/skills/technical-design-writer/SKILL.md',
-            windsurf: '.agents/skills/technical-design-writer/SKILL.md',
-        },
-    },
-    {
-        templateRelativePath: 'skills/scrum-master-planner/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/scrum-master-planner/SKILL.md',
-            gemini: '.agents/skills/scrum-master-planner/SKILL.md',
-            claude: '.agents/skills/scrum-master-planner/SKILL.md',
-            windsurf: '.agents/skills/scrum-master-planner/SKILL.md',
-        },
-    },
-    {
-        templateRelativePath: 'skills/ai-implementation-planner/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/ai-implementation-planner/SKILL.md',
-            gemini: '.agents/skills/ai-implementation-planner/SKILL.md',
-            claude: '.agents/skills/ai-implementation-planner/SKILL.md',
-            windsurf: '.agents/skills/ai-implementation-planner/SKILL.md',
-        },
-    },
-    {
-        templateRelativePath: 'skills/ai-implementation-plan-executor/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
-            gemini: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
-            claude: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
-            windsurf: '.agents/skills/ai-implementation-plan-executor/SKILL.md',
-        },
-    },
-];
-export const SELECTABLE_LANGUAGE_SKILLS = [
-    {
-        id: 'typescript',
-        name: 'TypeScript',
-        description: 'Install practical guidance for writing and modifying .ts and .tsx files',
-        routingInstruction: 'For any task that changes `.ts` or `.tsx` files, also use `typescript`.',
-        templateRelativePath: 'skills/typescript/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/typescript/SKILL.md',
-            gemini: '.agents/skills/typescript/SKILL.md',
-            claude: '.agents/skills/typescript/SKILL.md',
-            windsurf: '.agents/skills/typescript/SKILL.md',
-        },
-    },
-    {
-        id: 'golang',
-        name: 'Go',
-        description: 'Install practical guidance for writing and modifying .go files',
-        routingInstruction: 'For any task that changes `.go` files, also use `golang`.',
-        templateRelativePath: 'skills/golang/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/golang/SKILL.md',
-            gemini: '.agents/skills/golang/SKILL.md',
-            claude: '.agents/skills/golang/SKILL.md',
-            windsurf: '.agents/skills/golang/SKILL.md',
-        },
-    },
-];
-export const SELECTABLE_FRAMEWORK_SKILLS = [
-    {
-        id: 'react',
-        name: 'React',
-        description: 'Install guidance for React components, props, state ownership, and component boundaries',
-        routingInstruction: 'For React component changes involving responsibility, props, state ownership, or presentational/data-owning boundaries, use `react`.',
-        templateRelativePath: 'skills/react/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/react/SKILL.md',
-            gemini: '.agents/skills/react/SKILL.md',
-            claude: '.agents/skills/react/SKILL.md',
-            windsurf: '.agents/skills/react/SKILL.md',
-        },
-    },
-    {
-        id: 'nextjs',
-        name: 'Next.js',
-        description: 'Install guidance for Next.js App Router and framework-specific files',
-        routingInstruction: 'For Next.js App Router or framework-specific changes—`src/app/**`, pages, layouts, route handlers, loading/error/not-found files, metadata, or Server/Client boundaries—use `nextjs`.',
-        templateRelativePath: 'skills/nextjs/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/nextjs/SKILL.md',
-            gemini: '.agents/skills/nextjs/SKILL.md',
-            claude: '.agents/skills/nextjs/SKILL.md',
-            windsurf: '.agents/skills/nextjs/SKILL.md',
-        },
-    },
-];
-export const SELECTABLE_ARCHITECTURE_SKILLS = [
-    {
-        id: 'ddd-hexagonal',
-        name: 'DDD + Hexagonal Architecture',
-        description: 'Install back-end architecture guidance for DDD, ports/adapters, and inward dependencies',
-        routingInstruction: 'For backend features, refactors, bug fixes, persistence, external integrations, application/service boundaries, domain modeling, or architectural tradeoffs, use `ddd-hexagonal`.',
-        templateRelativePath: 'skills/architecture/ddd-hexagonal/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/ddd-hexagonal/SKILL.md',
-            gemini: '.agents/skills/ddd-hexagonal/SKILL.md',
-            claude: '.agents/skills/ddd-hexagonal/SKILL.md',
-            windsurf: '.agents/skills/ddd-hexagonal/SKILL.md',
-        },
-    },
-    {
-        id: 'command-pattern',
-        name: 'Command Pattern',
-        description: 'Install architecture guidance for structuring executable operations as commands and handlers',
-        routingInstruction: 'For work that structures actions, workflows, command handlers, operation dispatch, request processing, or executable tasks, use `command-pattern`.',
-        templateRelativePath: 'skills/architecture/command-pattern/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/command-pattern/SKILL.md',
-            gemini: '.agents/skills/command-pattern/SKILL.md',
-            claude: '.agents/skills/command-pattern/SKILL.md',
-            windsurf: '.agents/skills/command-pattern/SKILL.md',
-        },
-    },
-];
-export const SELECTABLE_WORKFLOW_SKILLS = [
-    {
-        id: 'ai-prompt-engineer-master',
-        name: 'AI Prompt Engineer Master',
-        description: 'Install guidance for creating, rewriting, optimizing, compressing, and evaluating AI prompts',
-        routingInstruction: 'For prompt creation, rewriting, optimization, compression, evaluation, or reusable templates for AI models, agents, tools, coding assistants, or product workflows, use `ai-prompt-engineer-master`.',
-        templateRelativePath: 'skills/ai-prompt-engineer-master/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
-            gemini: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
-            claude: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
-            windsurf: '.agents/skills/ai-prompt-engineer-master/SKILL.md',
-        },
-    },
-    {
-        id: 'ux-expert',
-        name: 'UX Expert',
-        description: 'Install senior UX/UI guidance for UI-changing features, responsive layouts, flows, states, accessibility, and binding mockups',
-        routingInstruction: 'For UX/UI design after product definition for UI-changing features, use `ux-expert`; downstream design, planning, and implementation must treat `docs/features/<feature-slug>/ux.md` mockups as binding UI goals, not redesign targets.',
-        templateRelativePath: 'skills/ux-expert/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/ux-expert/SKILL.md',
-            gemini: '.agents/skills/ux-expert/SKILL.md',
-            claude: '.agents/skills/ux-expert/SKILL.md',
-            windsurf: '.agents/skills/ux-expert/SKILL.md',
-        },
-    },
-];
-export const SUPPORTED_AGENTS = [
-    {
-        id: 'codex',
-        name: 'Codex',
-        description: 'Create .codex/config.toml pointing Codex to AGENTS.md',
-        targetRelativePath: '.codex/config.toml',
-        templateRelativePath: '.codex/config.toml',
-    },
-    {
-        id: 'gemini',
-        name: 'Gemini',
-        description: 'Create GEMINI.md that delegates to AGENTS.md',
-        targetRelativePath: 'GEMINI.md',
-        templateRelativePath: 'GEMINI.md',
-    },
-    {
-        id: 'claude',
-        name: 'Claude',
-        description: 'Create CLAUDE.md that delegates to AGENTS.md',
-        targetRelativePath: 'CLAUDE.md',
-        templateRelativePath: 'CLAUDE.md',
-    },
-    {
-        id: 'windsurf',
-        name: 'Windsurf',
-        description: 'Use root AGENTS.md and shared .agents/skills/ discovery',
-    },
-];
-export function resolveSelectableSkillById(skillId) {
-    const languageSkill = SELECTABLE_LANGUAGE_SKILLS.find((skill) => skill.id === skillId);
-    if (languageSkill) {
-        return { ok: true, resolved: { kind: 'language', skill: languageSkill } };
-    }
-    const frameworkSkill = SELECTABLE_FRAMEWORK_SKILLS.find((skill) => skill.id === skillId);
-    if (frameworkSkill) {
-        return { ok: true, resolved: { kind: 'framework', skill: frameworkSkill } };
-    }
-    const architectureSkill = SELECTABLE_ARCHITECTURE_SKILLS.find((skill) => skill.id === skillId);
-    if (architectureSkill) {
-        return { ok: true, resolved: { kind: 'architecture', skill: architectureSkill } };
-    }
-    const workflowSkill = SELECTABLE_WORKFLOW_SKILLS.find((skill) => skill.id === skillId);
-    if (workflowSkill) {
-        return { ok: true, resolved: { kind: 'workflow', skill: workflowSkill } };
-    }
-    return { ok: false, message: `Unknown skill \`${skillId}\`. Run \`sibu skills list\` to see available skills.` };
-}
-function readPackageVersion() {
-    const packageJsonPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
-    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-    if (!isPackageJsonWithVersion(packageJson)) {
-        throw new Error(`Could not read Sibu version from ${packageJsonPath}.`);
-    }
-    return packageJson.version;
-}
-function isPackageJsonWithVersion(value) {
-    return Boolean(value && typeof value === 'object' && typeof value.version === 'string');
-}

package/bin/shared/paths.js

@@ -1,7 +1,6 @@
-import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { SIBU_CACHE_HOME_ENV, STATE_RELATIVE_PATH } from './catalog.js';
+import { STATE_RELATIVE_PATH } from './catalog.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export function getProjectContext() {
@@ -29,13 +28,3 @@ export function getSideTemplatePath(rootPath, relativePath, templateVersion) {
     const safeName = relativePath.replace(/[\\/]/g, '__');
     return path.join(rootPath, '.sibu', 'sync', `${safeName}.template-v${templateVersion}`);
 }
-export function getSibuCacheRoot() {
-    const override = process.env[SIBU_CACHE_HOME_ENV]?.trim();
-    if (override) {
-        return path.resolve(override);
-    }
-    return path.join(os.homedir(), '.sibu');
-}
-export function getNpmVersionCachePath() {
-    return path.join(getSibuCacheRoot(), 'cache', 'npm-version.json');
-}

package/bin/shared/workflow-targets.js

@@ -1,10 +1,11 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { SIBU_VERSION, MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, } from './catalog.js';
+import { SIBU_VERSION } from './catalog.js';
+import { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, } from '../modules/workflow-target-planning/index.js';
 import { sha256 } from './hash.js';
 import { removeUndefinedFields } from './object.js';
 import { readExistingState } from './state.js';
-import { getTemplateVersion, readTemplate, readTemplateManifest, renderSkillRouting } from './templates.js';
+import { getTemplateVersion, readTemplate, readTemplateManifest, renderSkillRouting } from '../modules/template-catalog-rendering/index.js';
 export function getSelectedLanguageSkillsFromState(state) {
     return SELECTABLE_LANGUAGE_SKILLS.filter((skill) => state.selectedLanguageSkills?.includes(skill.id));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juancr11/sibu",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "CLI for setting up a local AI-augmented development workflow.",
   "repository": {
     "type": "git",
@@ -16,8 +16,10 @@
   "files": [
     "bin/sibu.js",
     "bin/entrypoints/",
-    "bin/features/",
+    "bin/admin/",
+    "bin/modules/",
     "bin/shared/",
+    "!bin/shared/state.js",
     "!bin/**/*.test.js",
     "!bin/echo.js",
     "templates/",
@@ -32,7 +34,7 @@
     "dev:unlink": "pnpm unlink --global sibu",
     "prepack": "pnpm run build",
     "smoke:init": "node ./bin/sibu.js init",
-    "test": "pnpm build && node --test bin/shared/catalog.test.js bin/shared/npm-version.test.js bin/shared/prompts.test.js bin/shared/workflow-targets.test.js bin/shared/workflow-mutation-readiness.test.js bin/admin/generate-changelog/handler.test.js bin/admin/release.test.js bin/admin/release-workflow/handler.test.js bin/admin/release-workflow/package-json.test.js bin/features/doctor-project/handler.test.js bin/features/use-skill/handler.test.js bin/features/stop-managing-file/handler.test.js",
+    "test": "pnpm build && node ./scripts/run-tests.mjs",
     "validate:packed-runtime": "node ./scripts/validate-packed-cli-runtime.mjs",
     "validate:doctor-version-advisory": "pnpm build && node ./scripts/validate-doctor-version-advisory.mjs",
     "validate:post-update-doctor-drift": "pnpm build && node ./scripts/validate-post-update-doctor-drift.mjs",

package/templates/AGENTS.md

@@ -36,9 +36,12 @@ Keep responses concise by default, but spend the context needed for correctness,
 
 ## Skill routing
 
+For planned product/feature work, use this pipeline: product vision -> deep module map -> feature brief -> technical design -> optional UX -> epics/stories -> AI implementation plan -> AI executor. Narrow code fixes and small local changes do not require the full pipeline unless product scope, module ownership, or architecture direction is unclear.
+
 - For any code-writing task, use `clean-code`.
 - For requests to create, revise, or clarify a product vision, product strategy narrative, product north star, positioning, product principles, product voice, target user definition, product boundaries, or success signals, use `product-vision-writer`.
-- For requests to create, revise, or clarify a business-level feature brief, feature definition, feature scope, MVP feature boundaries, business acceptance criteria, or product-level feature rationale, use `feature-brief-writer`.
+- For requests to create, revise, or clarify a Deep Module Map, deep, complexity-hiding implementation modules, module boundaries, suggested implementation modules, or `docs/deep-module-map.md`, use `deep-module-map-writer`.
+- For requests to create, revise, or clarify a business-level feature brief after Deep Module Map work, feature definition, feature scope, MVP feature boundaries, business acceptance criteria, or product-level feature rationale, use `feature-brief-writer`.
 - For requests to create, revise, or clarify a technical design, implementation-oriented design doc, architecture approach, technical tradeoffs, technical risks, or implementation plan for an approved feature, use `technical-design-writer`.
 - For requests to create Epics, User Stories, Scrum planning artifacts, backlog slices, or delivery plans from an approved feature brief and technical design, use `scrum-master-planner`.
 - For requests to turn a specific User Story into an implementation checklist, coding plan, step-by-step execution plan, or baby-step plan, use `ai-implementation-planner`.

package/templates/manifest.json

@@ -1,11 +1,11 @@
 {
-  "templateVersion": "55",
+  "templateVersion": "69",
   "templates": {
     "AGENTS.md": {
-      "version": "22",
+      "version": "25",
       "description": "Project-level agent instructions and Sibu maintenance guidance.",
       "changes": [
-        "Adds concise context-budget discipline so agents prefer narrow reads, summarize large outputs, and preserve quality over token savings."
+        "Clarifies Deep Module routing as complexity-hiding implementation module planning."
       ]
     },
     ".codex/config.toml": {
@@ -38,24 +38,32 @@
       ]
     },
     "skills/product-vision-writer/SKILL.md": {
-      "version": "5",
+      "version": "7",
       "description": "Mandatory product vision writer skill installed once at the shared .agents/skills workspace path.",
       "changes": [
-        "Strengthens final response rules so saved product visions report only the path unless inline review is explicitly requested."
+        "Updates downstream artifact wording to use Deep Module Map."
+      ]
+    },
+    "skills/deep-module-map-writer/SKILL.md": {
+      "version": "2",
+      "description": "Mandatory Deep Module Map writer skill installed once at the shared .agents/skills workspace path.",
+      "changes": [
+        "Clarifies that Deep Modules are primarily technical design boundaries that hide substantial implementation complexity behind simple interfaces.",
+        "Strengthens the interview flow so agents ask focused one-at-a-time questions until module interfaces, hidden complexity, and boundaries are defensible."
       ]
     },
     "skills/feature-brief-writer/SKILL.md": {
-      "version": "4",
+      "version": "8",
       "description": "Mandatory feature brief writer skill installed once at the shared .agents/skills workspace path.",
       "changes": [
-        "Strengthens final response rules so saved feature briefs report only the path unless inline review is explicitly requested."
+        "Updates feature brief guidance to require Deep Modules from docs/deep-module-map.md."
       ]
     },
     "skills/technical-design-writer/SKILL.md": {
-      "version": "12",
+      "version": "15",
       "description": "Mandatory technical design writer skill installed once at the shared .agents/skills workspace path.",
       "changes": [
-        "Strengthens final response rules so saved technical designs report only the path and never include excerpts unless inline review is explicitly requested."
+        "Updates technical design guidance to translate selected Deep Modules into implementation boundaries."
       ]
     },
     "skills/typescript/SKILL.md": {
@@ -73,17 +81,17 @@
       ]
     },
     "skills/architecture/ddd-hexagonal/SKILL.md": {
-      "version": "1",
+      "version": "4",
       "description": "Selectable back-end architecture skill for DDD and Hexagonal Architecture.",
       "changes": [
-        "Adds an optional DDD + Hexagonal Architecture skill for projects that want opinionated back-end architecture guidance."
+        "Clarifies that Deep Modules hide implementation complexity behind small interfaces and are not product categories by themselves."
       ]
     },
     "skills/architecture/command-pattern/SKILL.md": {
-      "version": "2",
+      "version": "5",
       "description": "Selectable architecture skill for command-oriented vertical slices using Command Pattern, Hexagonal Architecture, and DDD principles.",
       "changes": [
-        "Reframes Command Pattern guidance around command-oriented vertical slices, feature-local ports, thin entrypoints, and infrastructure adapters."
+        "Clarifies that Deep Modules hide implementation complexity behind small interfaces and are not product categories by themselves."
       ]
     },
     "skills/nextjs/SKILL.md": {
@@ -101,24 +109,27 @@
       ]
     },
     "skills/scrum-master-planner/SKILL.md": {
-      "version": "5",
+      "version": "7",
       "description": "Mandatory Scrum planner skill for creating pragmatic Epics and User Stories from approved feature and technical design docs.",
       "changes": [
-        "Strengthens final response rules so generated Epics and Stories are summarized by paths and counts, not pasted inline unless explicitly requested."
+        "Updates Scrum planning guidance to preserve Deep Module implementation boundaries from technical designs."
       ]
     },
     "skills/ai-implementation-planner/SKILL.md": {
-      "version": "7",
+      "version": "11",
       "description": "Mandatory AI implementation planner skill for turning one approved User Story into small, story-local implementation step files.",
       "changes": [
-        "Strengthens final response rules so generated implementation step files are listed by path, not pasted inline unless explicitly requested."
+        "Adds a plan review gate so newly created implementation plans wait for user approval before execution.",
+        "Clarifies that next-story planning handoffs from the executor must stop after planning and wait for approval."
       ]
     },
     "skills/ai-implementation-plan-executor/SKILL.md": {
-      "version": "12",
-      "description": "Mandatory AI implementation plan executor skill for implementing existing story implementation plans one reviewed step at a time.",
+      "version": "16",
+      "description": "Mandatory AI implementation plan executor skill for implementing full story plans before story-level review and commit.",
       "changes": [
-        "Clarifies focused approved-step commits and validation-only step reporting."
+        "Changes execution from per-step approval to full-story execution followed by one story-level review gate.",
+        "Marks all completed steps approved and commits once after the completed story is approved.",
+        "Continues Epics automatically by implementing the next planned story or planning the next unplanned story and waiting for plan approval."
       ]
     },
     "skills/ai-prompt-engineer-master/SKILL.md": {
@@ -129,10 +140,10 @@
       ]
     },
     "skills/ux-expert/SKILL.md": {
-      "version": "4",
+      "version": "6",
       "description": "Selectable UX expert skill for UI-changing features, responsive design, flows, states, accessibility, and binding mockups.",
       "changes": [
-        "Strengthens final response rules so saved UX specs report only the path and never include mockups or excerpts unless inline review is explicitly requested."
+        "Updates boundary wording to use Deep Module Maps."
       ]
     }
   }