agentblueprint 0.6.24 → 0.6.26

package/dist/fetch-blueprint.js

@@ -8,13 +8,14 @@
 import { renderSkillDirectory, slugify } from './renderers.js';
 export async function fetchAndRenderBlueprint(client, blueprintId, opts) {
     const orgId = opts.customerOrgId;
-    // Fetch all data in parallel
-    const [blueprint, businessCase, implementationPlan, useCase, businessProfile] = await Promise.all([
+    // Fetch all data in parallel (base skill included -- graceful degradation if unavailable)
+    const [blueprint, businessCase, implementationPlan, useCase, businessProfile, baseSkill] = await Promise.all([
         client.getBlueprint(blueprintId, orgId),
         client.getBusinessCase(blueprintId, orgId).catch(() => null),
         client.getImplementationPlan(blueprintId, orgId).catch(() => null),
         client.getUseCase(blueprintId, orgId).catch(() => null),
         client.getBusinessProfile(orgId).catch(() => null),
+        client.getBaseSkill().catch(() => null),
     ]);
     // Fetch reality data for return visits
     const [implementationState, progress] = await Promise.all([
@@ -37,6 +38,7 @@ export async function fetchAndRenderBlueprint(client, blueprintId, opts) {
                 platform: vendorSkillData.platform,
                 skillName: vendorSkillData.skillName,
                 content: vendorSkillData.content,
+                files: vendorSkillData.files,
             };
         }
         else {
@@ -57,6 +59,7 @@ export async function fetchAndRenderBlueprint(client, blueprintId, opts) {
         generalGuide: generalGuideData?.content,
         vendorGuide: vendorGuideInput,
         vendorSkill: vendorSkillInput,
+        baseSkill: baseSkill ?? undefined,
         implementationState,
         progress,
     };
@@ -68,6 +71,7 @@ export async function fetchAndRenderBlueprint(client, blueprintId, opts) {
         slug,
         title,
         hasImplementationState: !!implementationState,
+        hasBaseSkill: !!baseSkill,
         vendorSkillName: vendorSkillInput?.skillName,
     };
 }

package/dist/fetch-blueprint.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-blueprint.js","sourceRoot":"","sources":["../src/fetch-blueprint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch-blueprint.js","sourceRoot":"","sources":["../src/fetch-blueprint.ts"],"names":[],"mappings":"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"}

package/dist/renderers.d.ts

@@ -1,4 +1,8 @@
-import type { ImplementationStateResponse, ProgressResponse } from './client.js';
+import type { ImplementationStateResponse, ProgressResponse } from './types.js';
+export interface SkillFile {
+    path: string;
+    content: string;
+}
 export interface SkillRenderInput {
     blueprintTitle: string;
     blueprintId: string;
@@ -17,6 +21,10 @@ export interface SkillRenderInput {
         platform: string;
         skillName: string;
         content: string;
+        files?: SkillFile[];
+    };
+    baseSkill?: {
+        files: SkillFile[];
     };
     implementationState?: ImplementationStateResponse | null;
     progress?: ProgressResponse | null;

package/dist/renderers.js

@@ -166,6 +166,9 @@ function buildSkillBody(input) {
     lines.push(`- **Platform:** ${platform}`);
     lines.push(`- **Pattern:** ${pattern}`);
     lines.push(`- **Agents:** ${team.length}`, '');
+    if (input.baseSkill) {
+        lines.push('> A base implementation skill has been installed at `.claude/skills/agent-blueprint/`.', '> It contains deployment patterns and reference material for all platforms.', '');
+    }
     if (input.vendorSkill) {
         const platformLabel = input.vendorSkill.platform.charAt(0).toUpperCase() + input.vendorSkill.platform.slice(1);
         lines.push(`> A ${platformLabel} expert skill has been installed at \`.claude/skills/${input.vendorSkill.skillName}/\`.`, '> It will be auto-loaded for platform-specific tasks.', '');
@@ -1851,6 +1854,11 @@ function buildGettingStartedReturnVisit(input) {
         lines.push(`Agent${inProgressNames.length > 1 ? 's' : ''} in progress: ${inProgressNames.join(', ')}. Pick up where you left off.`);
         lines.push('');
     }
+    if (input.baseSkill) {
+        lines.push('The `.claude/skills/agent-blueprint/` skill contains deployment patterns and');
+        lines.push('reference material applicable to all platforms. Read it for general guidance.');
+        lines.push('');
+    }
     if (input.vendorSkill) {
         lines.push(`The \`.claude/skills/${input.vendorSkill.skillName}/\` skill contains platform-specific`);
         lines.push('deployment guidance. Follow it for all platform-specific work.');
@@ -1977,17 +1985,39 @@ function buildGettingStarted(input) {
     lines.push('Ask the user where they want to deploy this. Three scenarios:');
     lines.push('');
     lines.push('**A. User has a platform and instance ready** (e.g., ServiceNow, Salesforce):');
-    lines.push('1. Get the instance URL and credentials.');
-    lines.push('2. Confirm this is a development or sandbox instance, not production.');
-    lines.push('3. Verify you are connected to the correct instance before making any changes.');
     lines.push('');
+    lines.push('Ask for the instance URL and credentials. Adapt your approach based on what the');
+    lines.push('user provides. Do not present access tiers as a menu. Respond naturally:');
+    lines.push('');
+    lines.push('- **Full access (read + write credentials):** Confirm this is a development or');
+    lines.push('  sandbox instance, not production. Verify you are connected to the correct');
+    lines.push('  instance before making any changes. You will create records, write scripts,');
+    lines.push('  and configure integrations directly.');
+    lines.push('- **Read-only access:** The user provides credentials but tells you access is');
+    lines.push('  read-only, or you discover you cannot write. Connect to the instance to');
+    lines.push('  discover schemas, read existing configurations, and understand the environment.');
+    lines.push('  Generate all records and scripts as local files. Walk the user through creating');
+    lines.push('  them. After the user acts, verify the result by reading back from the instance.');
+    lines.push('- **No access:** The user cannot or will not provide credentials. Work entirely');
+    lines.push('  from the blueprint spec and skill knowledge. Generate all artifacts as local');
+    lines.push('  files. Provide step-by-step instructions for every action. You cannot verify');
+    lines.push('  results directly, so ask the user to share outcomes (screenshots, record IDs,');
+    lines.push('  error messages) after each step.');
+    lines.push('');
+    if (input.baseSkill) {
+        lines.push('A base implementation skill has been installed at `.claude/skills/agent-blueprint/`.');
+        lines.push('It contains deployment patterns and reference material applicable to all platforms.');
+        lines.push('Read it before starting any implementation work.');
+        lines.push('');
+    }
     if (input.vendorSkill) {
         const platformLabel = input.vendorSkill.platform.charAt(0).toUpperCase() + input.vendorSkill.platform.slice(1);
         lines.push(`A ${platformLabel} expert skill has been installed at \`.claude/skills/${input.vendorSkill.skillName}/\`.`);
         lines.push('It contains the connection verification steps, deployment sequence, platform');
         lines.push('patterns, and debugging guidance. Follow it for all platform-specific work.');
+        lines.push('The deployment sequence adapts to the access level the user provides.');
     }
-    else {
+    else if (!input.baseSkill) {
         lines.push('If `references/deployment-guide-*.md` files are present, read those for');
         lines.push('platform-specific tooling, deployment sequence, and gotchas.');
     }
@@ -2047,15 +2077,24 @@ function buildGettingStarted(input) {
     lines.push('### Your role through implementation');
     lines.push('');
     lines.push('Your job does not end when simulation scripts are deployed. Stay with the user');
-    lines.push('through the full implementation. Operate in three modes:');
+    lines.push('through the full implementation. How you operate depends on the access level');
+    lines.push('established in Step 2:');
+    lines.push('');
+    lines.push('**With full access:** Do the work directly. Create records, write scripts,');
+    lines.push('configure integrations, test. Act first, report after.');
+    lines.push('');
+    lines.push('**With read-only access:** Use the instance connection to discover schemas,');
+    lines.push('read existing config, and verify results. Generate all records and scripts as');
+    lines.push('local files. Walk the user through creating them on the platform. After each');
+    lines.push('step, read back from the instance to confirm it was done correctly.');
     lines.push('');
-    lines.push('1. **Do it directly.** When you have system access (MCP, API, credentials), do the');
-    lines.push('   work yourself. Create records, write scripts, configure integrations, test.');
-    lines.push('2. **Offer to do it with access.** When you know how but lack credentials or');
-    lines.push('   permissions, tell the user what you need.');
-    lines.push('3. **Walk the user through it.** When only the user can act (UI-only config,');
-    lines.push('   credential vaults, third-party admin consoles), give exact step-by-step');
-    lines.push('   instructions, then verify programmatically that it worked.');
+    lines.push('**With no access:** Generate everything as local files with step-by-step');
+    lines.push('instructions. Ask the user to share results after each action so you can');
+    lines.push('guide corrections. Be explicit about what you cannot verify.');
+    lines.push('');
+    lines.push('Within any access level, shift fluidly as needed. Even with full access, some');
+    lines.push('tasks require the user to act (UI-only config, credential vaults, approval');
+    lines.push('workflows). Give exact instructions and verify programmatically when possible.');
     lines.push('');
     // Step 4
     lines.push('## Step 4: Validate');
@@ -2554,9 +2593,22 @@ export function renderSkillDirectory(input) {
     if (input.vendorGuide && !input.vendorSkill) {
         files.set(`references/deployment-guide-${input.vendorGuide.platform}.md`, input.vendorGuide.content);
     }
-    // Vendor expert skill
+    // Base skill (always, when present)
+    if (input.baseSkill) {
+        for (const file of input.baseSkill.files) {
+            files.set(`.claude/skills/agent-blueprint/${file.path}`, file.content);
+        }
+    }
+    // Vendor expert skill (multi-file when available, single SKILL.md fallback)
     if (input.vendorSkill) {
-        files.set(`.claude/skills/${input.vendorSkill.skillName}/SKILL.md`, input.vendorSkill.content);
+        if (input.vendorSkill.files && input.vendorSkill.files.length > 0) {
+            for (const file of input.vendorSkill.files) {
+                files.set(`.claude/skills/${input.vendorSkill.skillName}/${file.path}`, file.content);
+            }
+        }
+        else {
+            files.set(`.claude/skills/${input.vendorSkill.skillName}/SKILL.md`, input.vendorSkill.content);
+        }
     }
     // Scripts
     files.set('scripts/validate-spec.sh', buildValidateScript());