@juancr11/sibu 0.5.3 → 0.7.0

package/bin/{features → modules/skill-selection-management}/stop-managing-file/handler.js

@@ -2,14 +2,15 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { cancel, intro, isCancel, log, outro, select } from '@clack/prompts';
 import chalk from 'chalk';
-import { STATE_RELATIVE_PATH, resolveSelectableSkillById } from '../../shared/catalog.js';
-import { readFileHashIfPresent, sha256 } from '../../shared/hash.js';
-import { getProjectContext } from '../../shared/paths.js';
-import { renderIntro } from '../../shared/prompts.js';
-import { cloneState, readStateForDoctor, writeStateFile } from '../../shared/state.js';
-import { getTemplateVersion, readTemplateManifest, renderTemplateForSync } from '../../shared/templates.js';
-import { removeUndefinedFields } from '../../shared/object.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, } from '../../shared/workflow-targets.js';
+import { STATE_RELATIVE_PATH } from '../../../shared/catalog.js';
+import { resolveSelectableSkillById } from '../../workflow-target-planning/index.js';
+import { readFileHashIfPresent, sha256 } from '../../../shared/hash.js';
+import { getProjectContext } from '../../../shared/paths.js';
+import { renderIntro } from '../../interactive-guidance/index.js';
+import { cloneState, readStateForDoctor, writeStateFile } from '../../workflow-state-registry/index.js';
+import { getTemplateVersion, readTemplateManifest, renderTemplateForSync } from '../../template-catalog-rendering/index.js';
+import { removeUndefinedFields } from '../../../shared/object.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, } from '../../workflow-target-planning/index.js';
 export async function handleStopManagingFile({ skillName }) {
     await renderIntro();
     intro(chalk.cyan('Updating skill management'));

package/bin/modules/skill-selection-management/use-skill/command.js

@@ -0,0 +1 @@
+export {};

package/bin/{features → modules/skill-selection-management}/use-skill/handler.js

@@ -1,12 +1,13 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { log } from '@clack/prompts';
-import { STATE_RELATIVE_PATH, resolveSelectableSkillById } from '../../shared/catalog.js';
-import { sha256 } from '../../shared/hash.js';
-import { getProjectContext } from '../../shared/paths.js';
-import { renderTemplateForSync } from '../../shared/templates.js';
-import { getWorkflowMutationReadiness } from '../../shared/workflow-mutation-readiness.js';
-import { getSelectedAgentsFromState, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState } from '../../shared/workflow-targets.js';
+import { STATE_RELATIVE_PATH } from '../../../shared/catalog.js';
+import { resolveSelectableSkillById } from '../../workflow-target-planning/index.js';
+import { sha256 } from '../../../shared/hash.js';
+import { getProjectContext } from '../../../shared/paths.js';
+import { renderTemplateForSync } from '../../template-catalog-rendering/index.js';
+import { getWorkflowMutationReadiness } from '../../workflow-mutation-readiness/index.js';
+import { getSelectedAgentsFromState, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState } from '../../workflow-target-planning/index.js';
 export async function handleUseSkill(command) {
     const { rootPath, statePath } = getProjectContext();
     const readiness = getWorkflowMutationReadiness({ rootPath, statePath });

package/bin/{features/sync-project → modules/sync-review}/apply-action.js

@@ -3,9 +3,9 @@ import path from 'node:path';
 import { log } from '@clack/prompts';
 import { sha256 } from '../../shared/hash.js';
 import { getSideTemplatePath } from '../../shared/paths.js';
-import { cloneState } from '../../shared/state.js';
-import { getTemplateVersion, renderTemplateForSync } from '../../shared/templates.js';
-import { getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, } from '../../shared/workflow-targets.js';
+import { cloneState } from '../workflow-state-registry/index.js';
+import { getTemplateVersion, renderTemplateForSync } from '../template-catalog-rendering/index.js';
+import { getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, } from '../workflow-target-planning/index.js';
 export function applySyncAction({ rootPath, state, manifest, preview, action, }) {
     const nextState = cloneState(state);
     const managedFile = nextState.managedFiles[preview.relativePath] ?? preview.managedFile;

package/bin/modules/sync-review/command.js

@@ -0,0 +1 @@
+export {};

package/bin/{features/sync-project → modules/sync-review}/handler.js

@@ -2,13 +2,13 @@ import { intro, log, outro } from '@clack/prompts';
 import chalk from 'chalk';
 import { STATE_RELATIVE_PATH } from '../../shared/catalog.js';
 import { getProjectContext } from '../../shared/paths.js';
-import { askForMissingFrameworkSkills, askForNewArchitectureSkill, askForNewLanguageSkills, renderIntro } from '../../shared/prompts.js';
-import { readStateForDoctor, writeStateFile } from '../../shared/state.js';
-import { readTemplateManifest } from '../../shared/templates.js';
+import { askForMissingFrameworkSkills, askForNewArchitectureSkill, askForNewLanguageSkills, renderIntro } from '../interactive-guidance/index.js';
+import { readStateForDoctor, writeStateFile } from '../workflow-state-registry/index.js';
+import { readTemplateManifest } from '../template-catalog-rendering/index.js';
 import { askForSyncAction } from './action-prompt.js';
 import { applySyncAction } from './apply-action.js';
 import { logSyncPreview } from './log-preview.js';
-import { getSyncPreviews, isActionableSyncPreview, shouldAskForSyncAction } from './preview.js';
+import { getSyncPreviews, isActionableSyncPreview, shouldAskForSyncAction } from './sync-preview.js';
 export async function handleSyncProject(_command) {
     await renderIntro();
     intro(chalk.cyan('Reviewing workflow updates'));

package/bin/modules/sync-review/index.js

@@ -0,0 +1,5 @@
+export { askForSyncAction } from './action-prompt.js';
+export { applySyncAction } from './apply-action.js';
+export { handleSyncProject } from './handler.js';
+export { logSyncPreview } from './log-preview.js';
+export { getSyncPreviews, isActionableSyncPreview, shouldAskForSyncAction } from './sync-preview.js';

package/bin/{shared → modules/sync-review}/sync-preview.js

@@ -1,9 +1,9 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { sha256 } from './hash.js';
-import { hasReviewedTemplateVersion } from './state.js';
-import { renderTemplateForSync } from './templates.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, getWorkflowTargets, } from './workflow-targets.js';
+import { sha256 } from '../../shared/hash.js';
+import { hasReviewedTemplateVersion } from '../workflow-state-registry/index.js';
+import { renderTemplateForSync } from '../template-catalog-rendering/index.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedWorkflowSkillsFromState, getWorkflowTargets, } from '../workflow-target-planning/index.js';
 const ACTIONABLE_SYNC_PREVIEW_STATUSES = new Set([
     'new-template',
     'missing',

package/bin/modules/template-catalog-rendering/index.js

@@ -0,0 +1 @@
+export { extractProjectOverview, getTemplateVersion, readTemplate, readTemplateManifest, renderSkillRouting, renderTemplateForSync, } from './templates.js';

package/bin/modules/template-catalog-rendering/templates.js

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getTemplatesPath } from '../../shared/paths.js';
+export function readTemplate(relativePath) {
+    return fs.readFileSync(path.join(getTemplatesPath(), relativePath), 'utf8');
+}
+export function readTemplateManifest() {
+    const manifest = JSON.parse(fs.readFileSync(path.join(getTemplatesPath(), 'manifest.json'), 'utf8'));
+    if (!isTemplateManifest(manifest)) {
+        throw new Error('templates/manifest.json is not a valid template manifest.');
+    }
+    return manifest;
+}
+export function getTemplateVersion(manifest, templateRelativePath) {
+    const template = manifest.templates[templateRelativePath];
+    if (!template) {
+        throw new Error(`Template ${templateRelativePath} is missing from templates/manifest.json.`);
+    }
+    return template.version;
+}
+export function renderTemplateForSync({ templateRelativePath, currentPath, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], }) {
+    let contents = readTemplate(templateRelativePath);
+    if (contents.includes('{{PROJECT_OVERVIEW}}')) {
+        contents = contents.replace('{{PROJECT_OVERVIEW}}', extractProjectOverview(currentPath) ?? 'Describe this project.');
+    }
+    return renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills);
+}
+export function renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = []) {
+    if (!contents.includes('{{OPTIONAL_SKILL_ROUTING}}')) {
+        return contents;
+    }
+    const optionalRouting = [...selectedLanguageSkills, ...selectedFrameworkSkills, ...(selectedArchitectureSkill ? [selectedArchitectureSkill] : []), ...selectedWorkflowSkills]
+        .map((skill) => `- ${skill.routingInstruction}`)
+        .join('\n');
+    return contents.replace('{{OPTIONAL_SKILL_ROUTING}}', optionalRouting);
+}
+export function extractProjectOverview(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return undefined;
+    }
+    const contents = fs.readFileSync(filePath, 'utf8');
+    const match = contents.match(/## Project overview\s+([\s\S]*?)(?=\n## |$)/);
+    const overview = match?.[1]?.trim();
+    return overview || undefined;
+}
+function isTemplateManifest(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const manifest = value;
+    return (typeof manifest.templateVersion === 'string' &&
+        !!manifest.templates &&
+        typeof manifest.templates === 'object' &&
+        Object.values(manifest.templates).every((template) => !!template &&
+            typeof template === 'object' &&
+            typeof template.version === 'string' &&
+            typeof template.description === 'string' &&
+            Array.isArray(template.changes) &&
+            template.changes.every((change) => typeof change === 'string')));
+}

package/bin/modules/version-advisory/index.js

@@ -0,0 +1 @@
+export { checkForLatestSibuVersion, SIBU_CACHE_HOME_ENV, SIBU_PACKAGE_NAME, SIBU_VERSION } from './npm-version.js';

package/bin/{shared → modules/version-advisory}/npm-version.js

@@ -1,7 +1,13 @@
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
-import { NPM_VERSION_LOOKUP_MODE_ENV, NPM_VERSION_OVERRIDE_ENV, SIBU_PACKAGE_NAME, SIBU_VERSION, SUPPORTED_NPM_LOOKUP_MODES } from './catalog.js';
-import { getNpmVersionCachePath } from './paths.js';
+import { fileURLToPath } from 'node:url';
+export const SIBU_PACKAGE_NAME = '@juancr11/sibu';
+export const SIBU_VERSION = readPackageVersion();
+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'];
 const NPM_VERSION_CACHE_TTL_MS = 6 * 60 * 60 * 1000;
 const NPM_REGISTRY_URL = 'https://registry.npmjs.org';
 export async function checkForLatestSibuVersion(options = {}) {
@@ -176,3 +182,24 @@ function isNpmVersionCacheRecord(value) {
         typeof record.packageName === 'string' &&
         typeof record.source === 'string');
 }
+function getNpmVersionCachePath() {
+    return path.join(getSibuCacheRoot(), 'cache', 'npm-version.json');
+}
+function getSibuCacheRoot() {
+    const override = process.env[SIBU_CACHE_HOME_ENV]?.trim();
+    if (override) {
+        return path.resolve(override);
+    }
+    return path.join(os.homedir(), '.sibu');
+}
+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/modules/workflow-health-diagnosis/command.js

@@ -0,0 +1 @@
+export {};

package/bin/{features/doctor-project → modules/workflow-health-diagnosis}/handler.js

@@ -2,14 +2,15 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { intro, log, outro } from '@clack/prompts';
 import chalk from 'chalk';
-import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, STATE_RELATIVE_PATH, SUPPORTED_AGENTS } from '../../shared/catalog.js';
+import { STATE_RELATIVE_PATH } from '../../shared/catalog.js';
+import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SUPPORTED_AGENTS } from '../workflow-target-planning/index.js';
 import { sha256 } from '../../shared/hash.js';
-import { checkForLatestSibuVersion } from '../../shared/npm-version.js';
+import { checkForLatestSibuVersion } from '../version-advisory/index.js';
 import { getProjectContext } from '../../shared/paths.js';
-import { renderIntro } from '../../shared/prompts.js';
-import { hasReviewedTemplateVersion, readStateForDoctor } from '../../shared/state.js';
-import { getTemplateVersion, readTemplateManifest } from '../../shared/templates.js';
-import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getWorkflowTargets, } from '../../shared/workflow-targets.js';
+import { renderIntro } from '../interactive-guidance/index.js';
+import { hasReviewedTemplateVersion, readStateForDoctor } from '../workflow-state-registry/index.js';
+import { getTemplateVersion, readTemplateManifest } from '../template-catalog-rendering/index.js';
+import { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getWorkflowTargets, } from '../workflow-target-planning/index.js';
 export async function handleDoctorProject(_command) {
     await renderIntro();
     intro(chalk.cyan('Checking workflow state'));
@@ -77,7 +78,7 @@ function logSyncNextStep() {
         log.info(line);
     }
 }
-function diagnoseState({ rootPath, state }) {
+export function diagnoseState({ rootPath, state }) {
     const issues = [];
     const manifest = readTemplateManifest();
     if (state.templateVersion !== manifest.templateVersion) {

package/bin/modules/workflow-health-diagnosis/index.js

@@ -0,0 +1 @@
+export { diagnoseState, getDoctorSyncNextStepLines, getNpmVersionAdvisoryLines, handleDoctorProject } from './handler.js';

package/bin/modules/workflow-mutation-readiness/index.js

@@ -0,0 +1 @@
+export { getWorkflowMutationReadiness } from './workflow-mutation-readiness.js';

package/bin/{shared → modules/workflow-mutation-readiness}/workflow-mutation-readiness.js

@@ -1,6 +1,6 @@
-import { readStateForDoctor } from './state.js';
-import { getSyncPreviews, isActionableSyncPreview } from './sync-preview.js';
-import { readTemplateManifest } from './templates.js';
+import { readStateForDoctor } from '../workflow-state-registry/index.js';
+import { getSyncPreviews, isActionableSyncPreview } from '../sync-review/index.js';
+import { readTemplateManifest } from '../template-catalog-rendering/index.js';
 export function getWorkflowMutationReadiness({ rootPath, statePath }) {
     const stateResult = readStateForDoctor(statePath);
     if (!stateResult.ok) {

package/bin/modules/workflow-state-registry/index.js

@@ -0,0 +1 @@
+export { cloneState, hasReviewedTemplateVersion, readExistingState, readStateForDoctor, writeStateFile } from './state.js';

package/bin/{shared → modules/workflow-state-registry}/state.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { STATE_RELATIVE_PATH } from './catalog.js';
+import { STATE_RELATIVE_PATH } from '../../shared/catalog.js';
 export function readStateForDoctor(statePath) {
     if (!fs.existsSync(statePath)) {
         return { ok: false, message: `${STATE_RELATIVE_PATH} is missing.` };

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

@@ -0,0 +1,233 @@
+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/deep-module-map-writer/SKILL.md',
+        targetRelativePathsByAgent: {
+            codex: '.agents/skills/deep-module-map-writer/SKILL.md',
+            gemini: '.agents/skills/deep-module-map-writer/SKILL.md',
+            claude: '.agents/skills/deep-module-map-writer/SKILL.md',
+            windsurf: '.agents/skills/deep-module-map-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.` };
+}

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

@@ -0,0 +1,2 @@
+export { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, resolveSelectableSkillById, } from './catalog.js';
+export { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedSkillTargetsForAgents, getSelectedWorkflowSkillsFromState, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState, } from './workflow-targets.js';