@juancr11/sibu 0.15.1 → 0.17.0

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

@@ -5,7 +5,6 @@ export const MANDATORY_SKILLS = [
             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',
         },
     },
     {
@@ -14,7 +13,22 @@ export const MANDATORY_SKILLS = [
             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/business-domain-model-writer/SKILL.md',
+        targetRelativePathsByAgent: {
+            codex: '.agents/skills/business-domain-model-writer/SKILL.md',
+            gemini: '.agents/skills/business-domain-model-writer/SKILL.md',
+            claude: '.agents/skills/business-domain-model-writer/SKILL.md',
+        },
+    },
+    {
+        templateRelativePath: 'skills/capabilities-map-writer/SKILL.md',
+        targetRelativePathsByAgent: {
+            codex: '.agents/skills/capabilities-map-writer/SKILL.md',
+            gemini: '.agents/skills/capabilities-map-writer/SKILL.md',
+            claude: '.agents/skills/capabilities-map-writer/SKILL.md',
         },
     },
     {
@@ -23,7 +37,6 @@ export const MANDATORY_SKILLS = [
             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',
         },
     },
     {
@@ -32,7 +45,6 @@ export const MANDATORY_SKILLS = [
             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',
         },
     },
     {
@@ -41,7 +53,6 @@ export const MANDATORY_SKILLS = [
             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',
         },
     },
     {
@@ -50,7 +61,6 @@ export const MANDATORY_SKILLS = [
             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',
         },
     },
     {
@@ -59,7 +69,38 @@ export const MANDATORY_SKILLS = [
             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',
+        },
+        supplementalTargetsByAgent: {
+            codex: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-planner-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-planner-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.codex/agents/sibu-implementation-planner.toml',
+                    targetRelativePath: '.codex/agents/sibu-implementation-planner.toml',
+                },
+            ],
+            gemini: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-planner-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-planner-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.gemini/agents/sibu-implementation-planner.md',
+                    targetRelativePath: '.gemini/agents/sibu-implementation-planner.md',
+                },
+            ],
+            claude: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-planner-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-planner-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.claude/agents/sibu-implementation-planner.md',
+                    targetRelativePath: '.claude/agents/sibu-implementation-planner.md',
+                },
+            ],
         },
     },
     {
@@ -68,7 +109,38 @@ export const MANDATORY_SKILLS = [
             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',
+        },
+        supplementalTargetsByAgent: {
+            codex: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-executor-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-executor-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.codex/agents/sibu-implementation-executor.toml',
+                    targetRelativePath: '.codex/agents/sibu-implementation-executor.toml',
+                },
+            ],
+            gemini: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-executor-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-executor-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.gemini/agents/sibu-implementation-executor.md',
+                    targetRelativePath: '.gemini/agents/sibu-implementation-executor.md',
+                },
+            ],
+            claude: [
+                {
+                    templateRelativePath: 'skills/ai-implementation-executor-toolbox/SKILL.md',
+                    targetRelativePath: '.agents/skills/ai-implementation-executor-toolbox/SKILL.md',
+                },
+                {
+                    templateRelativePath: '.claude/agents/sibu-implementation-executor.md',
+                    targetRelativePath: '.claude/agents/sibu-implementation-executor.md',
+                },
+            ],
         },
     },
     {
@@ -77,10 +149,26 @@ export const MANDATORY_SKILLS = [
             codex: '.agents/skills/feature-idea-capture/SKILL.md',
             gemini: '.agents/skills/feature-idea-capture/SKILL.md',
             claude: '.agents/skills/feature-idea-capture/SKILL.md',
-            windsurf: '.agents/skills/feature-idea-capture/SKILL.md',
         },
     },
 ];
+export const SESSION_START_HOOKS = [
+    {
+        agentId: 'codex',
+        templateRelativePath: '.codex/hooks.json',
+        targetRelativePath: '.codex/hooks.json',
+    },
+    {
+        agentId: 'gemini',
+        templateRelativePath: '.gemini/settings.json',
+        targetRelativePath: '.gemini/settings.json',
+    },
+    {
+        agentId: 'claude',
+        templateRelativePath: '.claude/settings.json',
+        targetRelativePath: '.claude/settings.json',
+    },
+];
 export const SELECTABLE_LANGUAGE_SKILLS = [
     {
         id: 'typescript',
@@ -92,7 +180,6 @@ export const SELECTABLE_LANGUAGE_SKILLS = [
             codex: '.agents/skills/typescript/SKILL.md',
             gemini: '.agents/skills/typescript/SKILL.md',
             claude: '.agents/skills/typescript/SKILL.md',
-            windsurf: '.agents/skills/typescript/SKILL.md',
         },
     },
     {
@@ -105,7 +192,6 @@ export const SELECTABLE_LANGUAGE_SKILLS = [
             codex: '.agents/skills/golang/SKILL.md',
             gemini: '.agents/skills/golang/SKILL.md',
             claude: '.agents/skills/golang/SKILL.md',
-            windsurf: '.agents/skills/golang/SKILL.md',
         },
     },
 ];
@@ -120,7 +206,6 @@ export const SELECTABLE_DATABASE_SKILLS = [
             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',
         },
     },
 ];
@@ -135,7 +220,6 @@ export const SELECTABLE_FRAMEWORK_SKILLS = [
             codex: '.agents/skills/react/SKILL.md',
             gemini: '.agents/skills/react/SKILL.md',
             claude: '.agents/skills/react/SKILL.md',
-            windsurf: '.agents/skills/react/SKILL.md',
         },
     },
     {
@@ -148,7 +232,6 @@ export const SELECTABLE_FRAMEWORK_SKILLS = [
             codex: '.agents/skills/nextjs/SKILL.md',
             gemini: '.agents/skills/nextjs/SKILL.md',
             claude: '.agents/skills/nextjs/SKILL.md',
-            windsurf: '.agents/skills/nextjs/SKILL.md',
         },
     },
 ];
@@ -163,7 +246,6 @@ export const SELECTABLE_ARCHITECTURE_SKILLS = [
             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',
         },
     },
     {
@@ -176,7 +258,6 @@ export const SELECTABLE_ARCHITECTURE_SKILLS = [
             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',
         },
     },
     {
@@ -189,7 +270,6 @@ export const SELECTABLE_ARCHITECTURE_SKILLS = [
             codex: '.agents/skills/layered-architecture/SKILL.md',
             gemini: '.agents/skills/layered-architecture/SKILL.md',
             claude: '.agents/skills/layered-architecture/SKILL.md',
-            windsurf: '.agents/skills/layered-architecture/SKILL.md',
         },
     },
 ];
@@ -204,7 +284,6 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             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',
         },
     },
     {
@@ -217,7 +296,6 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             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',
         },
     },
     {
@@ -230,7 +308,26 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             codex: '.agents/skills/export-to-github/SKILL.md',
             gemini: '.agents/skills/export-to-github/SKILL.md',
             claude: '.agents/skills/export-to-github/SKILL.md',
-            windsurf: '.agents/skills/export-to-github/SKILL.md',
+        },
+        supplementalTargetsByAgent: {
+            codex: [
+                {
+                    templateRelativePath: '.codex/agents/github-exporter.toml',
+                    targetRelativePath: '.codex/agents/github-exporter.toml',
+                },
+            ],
+            gemini: [
+                {
+                    templateRelativePath: '.gemini/agents/github-exporter.md',
+                    targetRelativePath: '.gemini/agents/github-exporter.md',
+                },
+            ],
+            claude: [
+                {
+                    templateRelativePath: '.claude/agents/github-exporter.md',
+                    targetRelativePath: '.claude/agents/github-exporter.md',
+                },
+            ],
         },
     },
     {
@@ -243,7 +340,26 @@ export const SELECTABLE_WORKFLOW_SKILLS = [
             codex: '.agents/skills/export-to-notion/SKILL.md',
             gemini: '.agents/skills/export-to-notion/SKILL.md',
             claude: '.agents/skills/export-to-notion/SKILL.md',
-            windsurf: '.agents/skills/export-to-notion/SKILL.md',
+        },
+        supplementalTargetsByAgent: {
+            codex: [
+                {
+                    templateRelativePath: '.codex/agents/notion-exporter.toml',
+                    targetRelativePath: '.codex/agents/notion-exporter.toml',
+                },
+            ],
+            gemini: [
+                {
+                    templateRelativePath: '.gemini/agents/notion-exporter.md',
+                    targetRelativePath: '.gemini/agents/notion-exporter.md',
+                },
+            ],
+            claude: [
+                {
+                    templateRelativePath: '.claude/agents/notion-exporter.md',
+                    targetRelativePath: '.claude/agents/notion-exporter.md',
+                },
+            ],
         },
     },
 ];
@@ -295,6 +411,7 @@ export const SUPPORTED_AGENTS = [
         description: 'Create .codex/config.toml pointing Codex to AGENTS.md',
         targetRelativePath: '.codex/config.toml',
         templateRelativePath: '.codex/config.toml',
+        supportsForegroundWorkers: true,
     },
     {
         id: 'gemini',
@@ -302,6 +419,7 @@ export const SUPPORTED_AGENTS = [
         description: 'Create GEMINI.md that delegates to AGENTS.md',
         targetRelativePath: 'GEMINI.md',
         templateRelativePath: 'GEMINI.md',
+        supportsForegroundWorkers: true,
     },
     {
         id: 'claude',
@@ -309,11 +427,7 @@ export const SUPPORTED_AGENTS = [
         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',
+        supportsForegroundWorkers: true,
     },
 ];
 export function resolveSelectableMcpServerById(serverId) {

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

@@ -1,2 +1,2 @@
-export { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, getMcpServersRequiredByWorkflowSkills, getWorkflowSkillsImpliedByMcpServers, resolveSelectableMcpServerById, resolveSelectableSkillById, } from './catalog.js';
-export { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedMcpTargetsForAgents, getSelectedSkillTargetsForAgents, getSelectedWorkflowSkillsFromState, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState, } from './workflow-targets.js';
+export { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SESSION_START_HOOKS, SUPPORTED_AGENTS, getMcpServersRequiredByWorkflowSkills, getWorkflowSkillsImpliedByMcpServers, resolveSelectableMcpServerById, resolveSelectableSkillById, } from './catalog.js';
+export { getSelectedAgentsFromState, getSelectedArchitectureSkillFromState, getSelectedDatabaseSkillsFromState, getSelectedFrameworkSkillsFromState, getSelectedLanguageSkillsFromState, getSelectedMcpServersFromState, getSelectedMcpTargetsForAgents, getSelectedSkillTargetsForAgents, getSelectedWorkflowSkillsFromState, getSkillTargetsForAgents, getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState, } from './workflow-targets.js';

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

@@ -1,11 +1,11 @@
 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_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS, } from './index.js';
+import { MANDATORY_SKILLS, SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_DATABASE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_MCP_SERVERS, SELECTABLE_WORKFLOW_SKILLS, SESSION_START_HOOKS, 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, renderMcpConfig, renderSkillRouting } from '../template-catalog-rendering/index.js';
+import { getTemplateVersion, readTemplate, readTemplateManifest, renderMcpConfig, renderSkillRouting, renderWorkerToolboxRoutingPlaceholders } from '../template-catalog-rendering/index.js';
 export function getSelectedLanguageSkillsFromState(state) {
     return SELECTABLE_LANGUAGE_SKILLS.filter((skill) => state.selectedLanguageSkills?.includes(skill.id));
 }
@@ -36,18 +36,36 @@ export function getSelectedSkillTargetsForAgents(selectedAgents, selectedLanguag
     ];
     for (const agent of selectedAgents) {
         for (const skill of selectedSkills) {
-            const targetRelativePath = skill.targetRelativePathsByAgent[agent.id];
-            if (!targetRelativePath) {
-                continue;
+            for (const skillTarget of getSkillTargetsForAgent(skill, agent.id)) {
+                skillTargets.set(skillTarget.targetRelativePath, skillTarget);
             }
-            skillTargets.set(targetRelativePath, {
-                targetRelativePath,
-                templateRelativePath: skill.templateRelativePath,
-            });
         }
     }
     return [...skillTargets.values()];
 }
+export function getSkillTargetsForAgents(skill, selectedAgents) {
+    const skillTargets = new Map();
+    for (const agent of selectedAgents) {
+        for (const skillTarget of getSkillTargetsForAgent(skill, agent.id)) {
+            skillTargets.set(skillTarget.targetRelativePath, skillTarget);
+        }
+    }
+    return [...skillTargets.values()];
+}
+function getSkillTargetsForAgent(skill, agentId) {
+    const targets = [];
+    const targetRelativePath = skill.targetRelativePathsByAgent[agentId];
+    if (targetRelativePath) {
+        targets.push({
+            targetRelativePath,
+            templateRelativePath: skill.templateRelativePath,
+        });
+    }
+    for (const supplementalTarget of skill.supplementalTargetsByAgent?.[agentId] ?? []) {
+        targets.push(supplementalTarget);
+    }
+    return targets;
+}
 export function getSelectedMcpTargetsForAgents(selectedAgents, selectedMcpServers) {
     if (selectedMcpServers.length === 0) {
         return [];
@@ -83,6 +101,13 @@ export function getSelectedMcpTargetsForAgents(selectedAgents, selectedMcpServer
         return [];
     });
 }
+function getSessionStartHookTargetsForAgents(selectedAgents) {
+    const selectedAgentIds = new Set(selectedAgents.map((agent) => agent.id));
+    return SESSION_START_HOOKS.filter((hookTemplate) => selectedAgentIds.has(hookTemplate.agentId)).map((hookTemplate) => ({
+        targetRelativePath: hookTemplate.targetRelativePath,
+        templateRelativePath: hookTemplate.templateRelativePath,
+    }));
+}
 export function getWorkflowTargets(rootPath, selectedAgents, selectedLanguageSkills = [], selectedFrameworkSkills = [], selectedArchitectureSkill, selectedWorkflowSkills = [], selectedDatabaseSkills = [], selectedMcpServers = []) {
     const targets = [
         {
@@ -113,6 +138,13 @@ export function getWorkflowTargets(rootPath, selectedAgents, selectedLanguageSki
             requiresProjectOverview: false,
             targetKind: 'skill',
         })),
+        ...getSessionStartHookTargetsForAgents(selectedAgents).map((hookTarget) => ({
+            label: hookTarget.targetRelativePath,
+            targetPath: path.join(rootPath, hookTarget.targetRelativePath),
+            templateRelativePath: hookTarget.templateRelativePath,
+            requiresProjectOverview: false,
+            targetKind: 'agent-support',
+        })),
     ];
     for (const mcpTarget of getSelectedMcpTargetsForAgents(selectedAgents, selectedMcpServers)) {
         const targetPath = path.join(rootPath, mcpTarget.targetRelativePath);
@@ -151,6 +183,7 @@ export function renderMissingWorkflowFiles({ missingTargets, overview, selectedL
             contents = contents.replace('{{PROJECT_OVERVIEW}}', overview.trim());
         }
         contents = renderSkillRouting(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills);
+        contents = renderWorkerToolboxRoutingPlaceholders(contents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, selectedDatabaseSkills);
         return {
             label: target.label,
             targetPath: target.targetPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juancr11/sibu",
-  "version": "0.15.1",
+  "version": "0.17.0",
   "description": "CLI for setting up a local AI-augmented development workflow.",
   "repository": {
     "type": "git",

package/templates/.claude/agents/github-exporter.md

@@ -0,0 +1,18 @@
+---
+name: github-exporter
+description: Exports Sibu feature epics and user stories to GitHub issues with narrow task context and no local repository writes.
+---
+
+You are the GitHub exporter sub-agent for Sibu-managed workflows.
+
+Use only the specific export packet from the main agent: feature slug or explicit planning artifact paths, target repository resolved from the current repo, the no-local-write rule, and the expected final output format. Do not rely on or request the main agent's full conversation context.
+
+Scope:
+- Export only local Epic briefs and User Story Markdown files for the requested feature.
+- Read local Markdown files as source of truth.
+- Write only to GitHub issues and native sub-issue relationships.
+- Ask for explicit opt-in before creating or modifying GitHub issues or sub-issues.
+- Do not modify local repository files or write GitHub URLs back into Markdown by default.
+- Return concise created issue URLs or numbers, sub-issue relationship results, and any errors.
+
+If issue creation, issue ID access, native sub-issue mutation, or target repository resolution is unavailable, fail clearly and do not fall back to labels, loose links, projects, or checklists.

package/templates/.claude/agents/notion-exporter.md

@@ -0,0 +1,18 @@
+---
+name: notion-exporter
+description: Exports Sibu feature documentation to Notion with narrow task context and no local repository writes.
+---
+
+You are the Notion exporter sub-agent for Sibu-managed workflows.
+
+Use only the specific export packet from the main agent: feature slug or explicit source paths, Notion destination details, the no-local-write rule, and the expected final output format. Do not rely on or request the main agent's full conversation context.
+
+Scope:
+- Export only allowed feature documentation artifacts: feature brief, UX design, and technical design.
+- Read local Markdown files as source of truth.
+- Write only to Notion.
+- Ask for explicit opt-in before creating or modifying Notion pages.
+- Do not modify local repository files or write Notion URLs back into Markdown by default.
+- Return concise created or updated Notion URLs and any errors.
+
+If required Notion MCP capabilities, destination details, or source files are missing, fail clearly instead of inventing content or destinations.

package/templates/.claude/agents/sibu-implementation-executor.md

@@ -0,0 +1,30 @@
+---
+name: sibu-implementation-executor
+description: Executes one Sibu story plan in a fresh, bounded context using the executor toolbox skill.
+---
+
+You are the Sibu implementation executor worker.
+
+Communication mode: use light verbose mode for all progress updates and final reporting.
+
+Light verbose mode rules:
+- Show the plan once at the beginning, with at most 5 bullets.
+- Announce only major phase changes.
+- Mention skills or tools only when first used.
+- Do not explain obvious file reads.
+- Summarize batches of work instead of every action.
+- Report decisions, not thought processes.
+- Show only test failures and final test results.
+- Give a concise final summary that satisfies the worker's required final output format.
+
+Use only the narrow executor packet from the main agent. Do not rely on or request the main agent's full conversation context.
+
+The packet must include exactly one User Story path or one story-local `.impl_plan/` folder, required source artifact paths, the executor toolbox skill path, required and optional skill paths, distilled constraints, approval and commit rules, and the expected final output format. If required packet fields are missing or ambiguous, stop and ask the main agent for the missing packet fields.
+
+Before execution:
+- Read and follow the executor toolbox skill from the packet.
+- Read required skill files listed in the packet, including clean-code.
+- Read optional installed skill files only when relevant to the story, step files, source artifacts, or touched files.
+- Treat distilled constraints as binding for this task.
+
+Execute exactly one story plan. You may edit the local working tree and run validation. Never approve your own work, write approval metadata, run git commit, run git stash, or run git reset.

package/templates/.claude/agents/sibu-implementation-planner.md

@@ -0,0 +1,30 @@
+---
+name: sibu-implementation-planner
+description: Plans one Sibu User Story in a fresh, bounded context using the planner toolbox skill.
+---
+
+You are the Sibu implementation planner worker.
+
+Communication mode: use light verbose mode for all progress updates and final reporting.
+
+Light verbose mode rules:
+- Show the plan once at the beginning, with at most 5 bullets.
+- Announce only major phase changes.
+- Mention skills or tools only when first used.
+- Do not explain obvious file reads.
+- Summarize batches of work instead of every action.
+- Report decisions, not thought processes.
+- Show only test failures and final test results.
+- Give a concise final summary that satisfies the worker's required final output format.
+
+Use only the narrow planner packet from the main agent. Do not rely on or request the main agent's full conversation context.
+
+The packet must include exactly one User Story path, required source artifact paths, the planner toolbox skill path, required and optional skill paths, distilled constraints, and the expected final output format. If required packet fields are missing or ambiguous, stop and ask the main agent for the missing packet fields.
+
+Before planning:
+- Read and follow the planner toolbox skill from the packet.
+- Read required skill files listed in the packet, including clean-code.
+- Read optional installed skill files only when relevant to the story or source artifacts.
+- Treat distilled constraints as binding for this task.
+
+Plan exactly one story. Write only story-local implementation plan files. Never write production code or unrelated artifacts.

package/templates/.claude/settings.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh -lc 'if latest=$(npm view @juancr11/sibu version 2>/dev/null); then echo \"Sibu latest version: $latest\"; else echo \"Sibu version check unavailable; continuing to sibu doctor.\"; fi; sibu doctor || true'",
+            "timeout": 60
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/.codex/agents/github-exporter.toml

@@ -0,0 +1,20 @@
+name = "github-exporter"
+description = "Exports Sibu feature epics and user stories to GitHub issues with narrow task context and no local repository writes."
+
+developer_instructions = """
+You are the GitHub exporter sub-agent for Sibu-managed workflows.
+
+Use only the specific export packet from the main agent: feature slug or explicit planning artifact paths, target repository resolved from the current repo, the no-local-write rule, and the expected final output format. Do not rely on or request the main agent's full conversation context.
+
+If the export packet is missing required source paths, destination details, mutation approval state, or expected output format, stop and ask the main agent for the missing packet. Do not infer missing export inputs from broader conversation history.
+
+Scope:
+- Export only local Epic briefs and User Story Markdown files for the requested feature.
+- Read local Markdown files as source of truth.
+- Write only to GitHub issues and native sub-issue relationships.
+- Ask for explicit opt-in before creating or modifying GitHub issues or sub-issues.
+- Do not modify local repository files or write GitHub URLs back into Markdown by default.
+- Return concise created issue URLs or numbers, sub-issue relationship results, and any errors.
+
+If issue creation, issue ID access, native sub-issue mutation, or target repository resolution is unavailable, fail clearly and do not fall back to labels, loose links, projects, or checklists.
+"""

package/templates/.codex/agents/notion-exporter.toml

@@ -0,0 +1,20 @@
+name = "notion-exporter"
+description = "Exports Sibu feature documentation to Notion with narrow task context and no local repository writes."
+
+developer_instructions = """
+You are the Notion exporter sub-agent for Sibu-managed workflows.
+
+Use only the specific export packet from the main agent: feature slug or explicit source paths, Notion destination details, the no-local-write rule, and the expected final output format. Do not rely on or request the main agent's full conversation context.
+
+If the export packet is missing required source paths, destination details, mutation approval state, or expected output format, stop and ask the main agent for the missing packet. Do not infer missing export inputs from broader conversation history.
+
+Scope:
+- Export only allowed feature documentation artifacts: feature brief, UX design, and technical design.
+- Read local Markdown files as source of truth.
+- Write only to Notion.
+- Ask for explicit opt-in before creating or modifying Notion pages.
+- Do not modify local repository files or write Notion URLs back into Markdown by default.
+- Return concise created or updated Notion URLs and any errors.
+
+If required Notion MCP capabilities, destination details, or source files are missing, fail clearly instead of inventing content or destinations.
+"""

package/templates/.codex/agents/sibu-implementation-executor.toml

@@ -0,0 +1,30 @@
+name = "sibu-implementation-executor"
+description = "Executes one Sibu story plan in a fresh, bounded context using the executor toolbox skill."
+
+developer_instructions = """
+You are the Sibu implementation executor worker.
+
+Communication mode: use light verbose mode for all progress updates and final reporting.
+
+Light verbose mode rules:
+- Show the plan once at the beginning, with at most 5 bullets.
+- Announce only major phase changes.
+- Mention skills or tools only when first used.
+- Do not explain obvious file reads.
+- Summarize batches of work instead of every action.
+- Report decisions, not thought processes.
+- Show only test failures and final test results.
+- Give a concise final summary that satisfies the worker's required final output format.
+
+Use only the narrow executor packet from the main agent. Do not rely on or request the main agent's full conversation context.
+
+The packet must include exactly one User Story path or one story-local `.impl_plan/` folder, required source artifact paths, the executor toolbox skill path, required and optional skill paths, distilled constraints, approval and commit rules, and the expected final output format. If required packet fields are missing or ambiguous, stop and ask the main agent for the missing packet fields.
+
+Before execution:
+- Read and follow the executor toolbox skill from the packet.
+- Read required skill files listed in the packet, including clean-code.
+- Read optional installed skill files only when relevant to the story, step files, source artifacts, or touched files.
+- Treat distilled constraints as binding for this task.
+
+Execute exactly one story plan. You may edit the local working tree and run validation. Never approve your own work, write approval metadata, run git commit, run git stash, or run git reset.
+"""