@juancr11/sibu 0.4.2 → 0.5.1

package/bin/features/init-project/handler.js

@@ -4,7 +4,7 @@ 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 { askForArchitectureSkill, askForFrameworkSkills, askForLanguageSkills, askForProjectOverview, askForSupportedAgents, renderIntro } from '../../shared/prompts.js';
+import { askForArchitectureSkill, askForFrameworkSkills, askForLanguageSkills, askForProjectOverview, askForSupportedAgents, askForWorkflowSkills, renderIntro } from '../../shared/prompts.js';
 import { readStateForDoctor } from '../../shared/state.js';
 import { getWorkflowTargets, renderMissingWorkflowFiles, writeSibuState } from '../../shared/workflow-targets.js';
 export async function handleInitProject(_command) {
@@ -31,7 +31,8 @@ export async function handleInitProject(_command) {
     const selectedLanguageSkills = await askForLanguageSkills();
     const selectedFrameworkSkills = await askForFrameworkSkills();
     const selectedArchitectureSkill = await askForArchitectureSkill();
-    const targets = getWorkflowTargets(rootPath, selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill);
+    const selectedWorkflowSkills = await askForWorkflowSkills();
+    const targets = getWorkflowTargets(rootPath, selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills);
     const missingTargets = targets.filter((target) => !fs.existsSync(target.targetPath));
     log.message('I will create this project’s initial AI workflow files.');
     for (const target of targets) {
@@ -51,13 +52,14 @@ export async function handleInitProject(_command) {
         selectedLanguageSkills,
         selectedFrameworkSkills,
         selectedArchitectureSkill,
+        selectedWorkflowSkills,
     });
     for (const file of files) {
         fs.mkdirSync(path.dirname(file.targetPath), { recursive: true });
         fs.writeFileSync(file.targetPath, file.contents, { encoding: 'utf8', flag: 'wx' });
         log.success(`Created ${file.label}`);
     }
-    writeSibuState({ rootPath, statePath, selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, targets });
+    writeSibuState({ rootPath, statePath, selectedAgents, selectedLanguageSkills, selectedFrameworkSkills, selectedArchitectureSkill, selectedWorkflowSkills, targets });
     log.success(`Created ${STATE_RELATIVE_PATH}`);
     outro(chalk.green('Setup complete.'));
 }

package/bin/shared/prompts.js

@@ -3,7 +3,7 @@ import { cancel, isCancel, multiselect, select, text } from '@clack/prompts';
 import gradient from 'gradient-string';
 import { Box, Text, render, useApp } from 'ink';
 import { useEffect } from 'react';
-import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SUPPORTED_AGENTS } from './catalog.js';
+import { SELECTABLE_ARCHITECTURE_SKILLS, SELECTABLE_FRAMEWORK_SKILLS, SELECTABLE_LANGUAGE_SKILLS, SELECTABLE_WORKFLOW_SKILLS, SUPPORTED_AGENTS } from './catalog.js';
 const NONE_OPTION_ID = 'none';
 export async function renderIntro() {
     console.log(gradient(['#39ff14', '#00e5ff', '#9b5de5']).multiline('⧖  S I B U  ⧖'));
@@ -99,6 +99,22 @@ export async function askForArchitectureSkill() {
     }
     return SELECTABLE_ARCHITECTURE_SKILLS.find((skill) => skill.id === selectedArchitectureSkillId);
 }
+export async function askForWorkflowSkills() {
+    const selectedWorkflowSkillIds = await multiselect({
+        message: 'Select optional workflow skills for this project.',
+        required: false,
+        options: SELECTABLE_WORKFLOW_SKILLS.map((skill) => ({
+            value: skill.id,
+            label: skill.name,
+            hint: skill.description,
+        })),
+    });
+    if (isCancel(selectedWorkflowSkillIds)) {
+        cancel('Initialization cancelled.');
+        process.exit(0);
+    }
+    return SELECTABLE_WORKFLOW_SKILLS.filter((skill) => selectedWorkflowSkillIds.includes(skill.id));
+}
 export function shouldAskForNewLanguageSkills(state) {
     return (state.selectedLanguageSkills?.length ?? 0) === 0;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juancr11/sibu",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "CLI for setting up a local AI-augmented development workflow.",
   "repository": {
     "type": "git",
@@ -36,7 +36,8 @@
     "validate:packed-runtime": "node ./scripts/validate-packed-cli-runtime.mjs",
     "validate:doctor-version-advisory": "pnpm build && node ./scripts/validate-doctor-version-advisory.mjs",
     "validate:post-update-doctor-drift": "pnpm build && node ./scripts/validate-post-update-doctor-drift.mjs",
-    "validate:release": "pnpm verify && npm pack && pnpm run validate:packed-runtime && pnpm run validate:doctor-version-advisory && pnpm run validate:post-update-doctor-drift",
+    "validate:release-publish": "pnpm verify && npm pack && pnpm run validate:packed-runtime",
+    "validate:release": "pnpm run validate:release-publish && pnpm run validate:doctor-version-advisory && pnpm run validate:post-update-doctor-drift",
     "admin:release": "node ./bin/admin/release.js"
   },
   "keywords": [
@@ -54,7 +55,7 @@
     "@types/react": "^19.2.14",
     "typescript": "^6.0.2"
   },
-  "packageManager": "pnpm@10.28.2",
+  "packageManager": "pnpm@10.33.2",
   "dependencies": {
     "@clack/prompts": "^1.2.0",
     "chalk": "^5.6.2",

package/templates/AGENTS.md

@@ -19,6 +19,14 @@
 - Ask again only if the scope changes materially, the approach becomes materially more complex or risky, or the user explicitly asks to review before continuing.
 - Use Conventional Commits 1.0.0 for commit messages.
 
+## Context budget discipline
+
+Treat context as a shared budget owned by the user. Prefer narrow, purposeful context before broad reads: search targeted paths, inspect snippets before full files, and avoid dependency, generated, build, cache, and lockfile content unless relevant.
+
+Do not dump full files, full diffs, broad recursive scans, or uncapped command output unless needed for quality or explicitly requested. Summarize large diffs, logs, command output, and generated artifacts by default, with focused excerpts when they support a decision.
+
+Keep responses concise by default, but spend the context needed for correctness, safety, validation, human control, or required context gathering. Warn or ask before optional expensive context operations.
+
 ## Communication style
 
 - Keep responses as short as practical while still being clear and useful.

package/templates/manifest.json

@@ -1,11 +1,11 @@
 {
-  "templateVersion": "49",
+  "templateVersion": "52",
   "templates": {
     "AGENTS.md": {
-      "version": "21",
+      "version": "22",
       "description": "Project-level agent instructions and Sibu maintenance guidance.",
       "changes": [
-        "Tightens Sibu maintenance outcome guidance while preserving startup health checks, safety, confirmation, routing, and workflow repair instructions."
+        "Adds concise context-budget discipline so agents prefer narrow reads, summarize large outputs, and preserve quality over token savings."
       ]
     },
     ".codex/config.toml": {
@@ -52,10 +52,10 @@
       ]
     },
     "skills/technical-design-writer/SKILL.md": {
-      "version": "10",
+      "version": "11",
       "description": "Mandatory technical design writer skill installed once at the shared .agents/skills workspace path.",
       "changes": [
-        "Compresses technical-design wording while preserving required grounding, UX binding, delegation boundaries, output location, and smallest-useful-design guidance."
+        "Tightens final responses so technical design updates report only the output path unless inline review is requested."
       ]
     },
     "skills/typescript/SKILL.md": {
@@ -115,10 +115,10 @@
       ]
     },
     "skills/ai-implementation-plan-executor/SKILL.md": {
-      "version": "8",
+      "version": "10",
       "description": "Mandatory AI implementation plan executor skill for implementing existing story implementation plans one reviewed step at a time.",
       "changes": [
-        "Adds context reuse guidance so story implementation plans load broad context once, then continue step-by-step using cached context unless scope, validation, or file changes require rereading."
+        "Clarifies step-completion reports so agents say the step finished and identify the next step before waiting for approval."
       ]
     },
     "skills/ai-prompt-engineer-master/SKILL.md": {
@@ -129,10 +129,10 @@
       ]
     },
     "skills/ux-expert/SKILL.md": {
-      "version": "2",
+      "version": "3",
       "description": "Selectable UX expert skill for UI-changing features, responsive design, flows, states, accessibility, and binding mockups.",
       "changes": [
-        "Compresses UX guidance while preserving product grounding, no-code boundary, phone-first design, output location, concrete mockup requirements, and binding downstream mockup authority."
+        "Tightens final responses so UX spec updates report only the output path unless inline review is requested."
       ]
     }
   }

package/templates/skills/ai-implementation-plan-executor/SKILL.md

@@ -161,10 +161,9 @@ Do not:
 
 After implementing one step, briefly report:
 
+- that the step finished
 - current step file path
-- summary of changes made
-- validation run and result
-- any risks, blockers, or follow-up questions
+- the next step file path, or that no next step remains
 - that you are waiting for user approval before marking the step approved, committing it, and continuing to the next step
 
 After approving and committing the final step in a story implementation plan, also briefly report the Epic continuation check result:

package/templates/skills/technical-design-writer/SKILL.md

@@ -110,3 +110,7 @@ Use this structure as a starting point. Delete sections that do not add value.
 ## Quality bar
 
 A good technical design is short, specific, and useful. It should not try to be the product brief, architecture skill, clean-code skill, implementation plan, or ticket backlog.
+
+## Final response behavior
+
+After writing the file, report only the path. Do not paste the full technical design unless the user asks to review it inline.

package/templates/skills/ux-expert/SKILL.md

@@ -89,3 +89,7 @@ Use only helpful sections from this shape:
 ```
 
 The Binding Mockups section is authoritative for downstream work unless this UX spec is revised.
+
+## Final response behavior
+
+After writing the file, report only the path. Do not paste the full UX spec unless the user asks to review it inline.