@juancr11/sibu 0.6.0 → 0.8.0

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

@@ -0,0 +1,252 @@
+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_DATABASE_SKILLS = [
+    {
+        id: 'postgresql-expert',
+        name: 'PostgreSQL Expert',
+        description: 'Install practical guidance for PostgreSQL schema design, migrations, constraints, queries, indexing, and database tradeoffs',
+        routingInstruction: 'For PostgreSQL schema design, migrations, constraints, queries, indexing, or database tradeoffs, use `postgresql-expert`.',
+        templateRelativePath: 'skills/postgresql-expert/SKILL.md',
+        targetRelativePathsByAgent: {
+            codex: '.agents/skills/postgresql-expert/SKILL.md',
+            gemini: '.agents/skills/postgresql-expert/SKILL.md',
+            claude: '.agents/skills/postgresql-expert/SKILL.md',
+            windsurf: '.agents/skills/postgresql-expert/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 databaseSkill = SELECTABLE_DATABASE_SKILLS.find((skill) => skill.id === skillId);
+    if (databaseSkill) {
+        return { ok: true, resolved: { kind: 'database', skill: databaseSkill } };
+    }
+    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_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, resolveSelectableSkillById, } from './catalog.js';
+export { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedSkillTargetsForAgents, getSelectedWorkflowSkillsFromState, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState, } from './workflow-targets.js';

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

@@ -0,0 +1,130 @@
+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_DATABASE_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 getSelectedDatabaseSkillsFromState(state) {
+    return SELECTABLE_DATABASE_SKILLS.filter((skill) => state.selectedDatabaseSkills?.includes(skill.id));
+}
+export function getSelectedSkillTargetsForAgents(selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = []) {
+    const skillTargets = new Map();
+    const selectedSkills = [
+        ...MANDATORY_SKILLS,
+        ...selectedLanguageSkills,
+        ...selectedFrameworkSkills,
+        ...selectedDatabaseSkills,
+        ...(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 = [], selectedDatabaseSkills = []) {
+    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, selectedDatabaseSkills).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 = [], selectedDatabaseSkills = [], }) {
+    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, selectedDatabaseSkills);
+        return {
+            label: target.label,
+            targetPath: target.targetPath,
+            contents,
+        };
+    });
+}
+export function writeSibuState({ rootPath, statePath, selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = [], 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),
+        selectedDatabaseSkills: selectedDatabaseSkills.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,254 +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/product-context-map-writer/SKILL.md',
-        targetRelativePathsByAgent: {
-            codex: '.agents/skills/product-context-map-writer/SKILL.md',
-            gemini: '.agents/skills/product-context-map-writer/SKILL.md',
-            claude: '.agents/skills/product-context-map-writer/SKILL.md',
-            windsurf: '.agents/skills/product-context-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.` };
-}
-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');
-}