@ryuenn3123/agentic-senior-core 2.5.22 → 3.0.2

package/lib/cli/commands/launch.mjs

@@ -1,6 +1,6 @@
 /**
  * Launch Command — Numbered interactive launcher.
- * Depends on: constants, utils, init command, skill-selector
+ * Depends on: constants, utils, init command
  */
 import { createInterface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
@@ -8,7 +8,6 @@ import { stdin, stdout } from 'node:process';
 import { CLI_VERSION, INIT_PRESETS } from '../constants.mjs';
 import { askChoice, normalizeChoiceInput } from '../utils.mjs';
 import { runInitCommand } from './init.mjs';
-import { runSkillCommand } from '../skill-selector.mjs';
 import { runOptimizeCommand } from './optimize.mjs';
 
 export async function runLaunchCommand() {
@@ -21,24 +20,15 @@ export async function runLaunchCommand() {
     const launchChoice = await askChoice(
       'How do you want to start?',
       [
-        'GitHub template (zero install)',
         'npm / npx path',
-        'Bootstrap scripts',
         'Preset starter',
         'Interactive init wizard',
         'Enable token optimization',
-        'Skill selector',
         'Exit',
       ],
       userInterface
     );
 
-    if (launchChoice === 'GitHub template (zero install)') {
-      console.log('\nOpen the GitHub template here:');
-      console.log('https://github.com/fatidaprilian/Agentic-Senior-Core/generate');
-      return;
-    }
-
     if (launchChoice === 'npm / npx path') {
       console.log('\nChoose one of these package paths:');
       console.log('npm exec --yes @ryuenn3123/agentic-senior-core init');
@@ -47,13 +37,6 @@ export async function runLaunchCommand() {
       return;
     }
 
-    if (launchChoice === 'Bootstrap scripts') {
-      console.log('\nUse the repository bootstrap scripts:');
-      console.log('Windows: powershell -ExecutionPolicy Bypass -File .\\scripts\\init-project.ps1 -TargetDirectory .');
-      console.log('Linux/macOS: bash ./scripts/init-project.sh .');
-      return;
-    }
-
     if (launchChoice === 'Preset starter') {
       const presetNames = Object.keys(INIT_PRESETS);
       const selectedPresetName = await askChoice(
@@ -86,11 +69,6 @@ export async function runLaunchCommand() {
       return;
     }
 
-    if (launchChoice === 'Skill selector') {
-      await runSkillCommand([]);
-      return;
-    }
-
     console.log('Exit selected.');
   } finally {
     userInterface.close();

package/lib/cli/commands/rollback.mjs

@@ -25,7 +25,7 @@ export async function runRollbackCommand(commandArguments) {
   
   try {
       await ensureDirectory(resolvedTargetDirectoryPath);
-  } catch (err) {
+    } catch {
       console.error(`[FATAL] Cannot access target directory: ${resolvedTargetDirectoryPath}`);
       process.exit(1);
   }

package/lib/cli/commands/upgrade.mjs

@@ -21,6 +21,7 @@ import {
   collectFileNames,
   formatDuration,
   pathExists,
+  analyzeManagedGovernanceSurface,
   copyGovernanceAssetsToTarget,
 } from '../utils.mjs';
 
@@ -39,8 +40,6 @@ import {
 import { runPreflightChecks } from '../preflight.mjs';
 import { createBackup } from '../backup.mjs';
 import { performRollback } from '../rollback.mjs';
-import { inferSkillDomainNamesFromSelection } from '../skill-selector.mjs';
-import { evaluateSkillDomainCompatibility } from '../compatibility.mjs';
 import { detectProjectDocTemplateStaleness } from '../project-scaffolder.mjs';
 
 export function parseUpgradeArguments(commandArguments) {
@@ -48,7 +47,8 @@ export function parseUpgradeArguments(commandArguments) {
     targetDirectory: '.',
     dryRun: false,
     skipConfirmation: false,
-    includeMcpTemplate: false,
+    includeMcpTemplate: true,
+    pruneManagedSurface: true,
   };
 
   for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
@@ -74,6 +74,21 @@ export function parseUpgradeArguments(commandArguments) {
       continue;
     }
 
+    if (currentArgument === '--no-mcp-template') {
+      parsedUpgradeOptions.includeMcpTemplate = false;
+      continue;
+    }
+
+    if (currentArgument === '--prune') {
+      parsedUpgradeOptions.pruneManagedSurface = true;
+      continue;
+    }
+
+    if (currentArgument === '--no-prune') {
+      parsedUpgradeOptions.pruneManagedSurface = false;
+      continue;
+    }
+
     throw new Error(`Unknown option: ${currentArgument}`);
   }
 
@@ -114,9 +129,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
     console.log('Running rules operations upgrade assistant (Federated Governance baseline) for an existing repository.');
 
-    await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
-      includeMcpTemplate: upgradeOptions.includeMcpTemplate === true,
-    });
+    const managedSurfacePlan = await analyzeManagedGovernanceSurface(resolvedTargetDirectoryPath);
 
     const stackFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'stacks'));
     const blueprintFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'blueprints'));
@@ -205,26 +218,8 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       console.log(`  - ${majorConstraint}`);
     }
 
-    const selectedSkillDomainNames = inferSkillDomainNamesFromSelection(
-      selectedStackFileName,
-      selectedBlueprintFileName,
-      selectedAdditionalStackFileNames,
-      selectedAdditionalBlueprintFileNames
-    );
-    const compatibilityWarnings = await evaluateSkillDomainCompatibility(
-      resolvedTargetDirectoryPath,
-      selectedSkillDomainNames
-    );
     const projectDocStalenessReport = await detectProjectDocTemplateStaleness(resolvedTargetDirectoryPath);
 
-    if (compatibilityWarnings.length > 0) {
-      console.log('\n[WARN] Compatibility checks reported potential issues for this environment:');
-      for (const compatibilityWarning of compatibilityWarnings) {
-        console.log(`- ${compatibilityWarning}`);
-      }
-      console.log('Upgrade will continue, but review these warnings before production use.');
-    }
-
     const currentRulesPath = path.join(resolvedTargetDirectoryPath, '.cursorrules');
     const currentRulesContent = await pathExists(currentRulesPath)
       ? await fs.readFile(currentRulesPath, 'utf8')
@@ -259,12 +254,30 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     console.log(`- Existing rules lines: ${currentRuleLineCount}`);
     console.log(`- Planned rules lines: ${plannedRuleLineCount}`);
     console.log(`- Rules changed: ${isRulesContentChanged ? 'yes' : 'no'}`);
+    console.log(`- Managed surface stale files: ${managedSurfacePlan.staleFiles.length}`);
+    console.log(`- Managed surface stale directories: ${managedSurfacePlan.staleDirectories.length}`);
+    console.log(`- Managed surface prune mode: ${upgradeOptions.pruneManagedSurface === true ? 'enabled (default)' : 'disabled (--no-prune)'}`);
+    console.log(`- MCP config write mode: ${upgradeOptions.includeMcpTemplate === true ? 'enabled (default)' : 'disabled (--no-mcp-template)'}`);
     if (projectDocStalenessReport.hasProjectDocs) {
       console.log(`- Project docs detected: ${projectDocStalenessReport.checkedFileNames.length}`);
       console.log(`- Project docs expected template version: ${projectDocStalenessReport.expectedTemplateVersion}`);
       console.log(`- Project docs stale files: ${projectDocStalenessReport.staleFiles.length}`);
     }
 
+    if (managedSurfacePlan.staleFiles.length > 0 || managedSurfacePlan.staleDirectories.length > 0) {
+      console.log('\nManaged surface stale paths preview (up to 5):');
+      const previewPaths = [
+        ...managedSurfacePlan.staleFiles,
+        ...managedSurfacePlan.staleDirectories,
+      ].slice(0, 5);
+      for (const previewPath of previewPaths) {
+        console.log(`- ${previewPath}`);
+      }
+      if (managedSurfacePlan.staleFiles.length + managedSurfacePlan.staleDirectories.length > previewPaths.length) {
+        console.log('- ...');
+      }
+    }
+
     if (projectDocStalenessReport.staleFiles.length > 0) {
       console.log('\n[WARN] Some project docs were generated from older template versions:');
       for (const staleDoc of projectDocStalenessReport.staleFiles) {
@@ -281,16 +294,22 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
     const shouldApplyUpgrade = upgradeOptions.skipConfirmation
       ? true
-      : await askYesNo('Apply upgrade and write migrated files?', userInterface, true);
+      : await askYesNo('Apply upgrade and synchronize managed files?', userInterface, true);
 
     if (!shouldApplyUpgrade) {
       console.log('Upgrade cancelled by user.');
       return;
     }
 
-    const backup = await createBackup(resolvedTargetDirectoryPath);
+    await createBackup(resolvedTargetDirectoryPath);
 
     try {
+      const governanceSyncResult = await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
+        includeMcpTemplate: upgradeOptions.includeMcpTemplate === true,
+        pruneManagedSurface: upgradeOptions.pruneManagedSurface === true,
+        managedSurfacePlan,
+      });
+
       await fs.writeFile(currentRulesPath, plannedRulesContent, 'utf8');
       await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.windsurfrules'), plannedRulesContent, 'utf8');
       await writeSelectedPolicy(resolvedTargetDirectoryPath, selectedProfileName);
@@ -307,8 +326,6 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         includeCiGuardrails,
         setupDurationMs,
         projectDetection,
-        selectedSkillDomains: selectedSkillDomainNames,
-        compatibilityWarnings,
         runtimeEnvironment: existingOnboardingReport?.runtimeEnvironment || null,
         operationMode: 'upgrade',
         detectionTransparency,
@@ -316,6 +333,8 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
       console.log('\nUpgrade complete.');
       console.log(`- Rules rewritten: ${isRulesContentChanged ? 'yes' : 'no (metadata refreshed)'}`);
+      console.log(`- Managed stale files removed: ${governanceSyncResult.deletedManagedFiles.length}`);
+      console.log(`- Managed stale directories removed: ${governanceSyncResult.deletedManagedDirectories.length}`);
       console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
       console.log('- Updated files: .cursorrules, .windsurfrules, .agent-context/state/onboarding-report.json');
     } catch (error) {

package/lib/cli/compiler.mjs

@@ -1,6 +1,6 @@
 /**
  * Context Compiler — Rulebook compilation and state persistence.
- * Depends on: constants.mjs, utils.mjs, skill-selector.mjs
+ * Depends on: constants.mjs, utils.mjs
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
@@ -8,7 +8,6 @@ import path from 'node:path';
 import {
   CLI_VERSION,
   POLICY_FILE_NAME,
-  SKILL_PLATFORM_INDEX_PATH,
   BLUEPRINT_RECOMMENDATIONS,
 } from './constants.mjs';
 
@@ -17,10 +16,6 @@ import {
   collectFileNames,
 } from './utils.mjs';
 
-import {
-  inferSkillDomainNamesFromSelection,
-} from './skill-selector.mjs';
-
 import {
   readTokenOptimizationState,
   buildTokenOptimizationGuidanceBlock,
@@ -49,8 +44,6 @@ export async function writeOnboardingReport({
   includeCiGuardrails,
   setupDurationMs,
   projectDetection,
-  selectedSkillDomains = [],
-  compatibilityWarnings = [],
   runtimeEnvironment = null,
   operationMode = 'init',
   tokenOptimization = undefined,
@@ -90,8 +83,6 @@ export async function writeOnboardingReport({
     },
     ciGuardrailsEnabled: includeCiGuardrails,
     setupDurationMs,
-    selectedSkillDomains,
-    compatibilityWarnings,
     runtimeEnvironment,
     tokenOptimization: resolvedTokenOptimization,
     memoryContinuity: resolvedMemoryContinuity,
@@ -141,7 +132,6 @@ export async function buildCompiledRulesContent({
   const selectedRulesDirectoryPath = path.join(resolvedTargetDirectoryPath, '.agent-context', 'rules');
   const selectedStacksDirectoryPath = path.join(resolvedTargetDirectoryPath, '.agent-context', 'stacks');
   const selectedBlueprintsDirectoryPath = path.join(resolvedTargetDirectoryPath, '.agent-context', 'blueprints');
-  const skillPlatformIndex = JSON.parse(await fs.readFile(SKILL_PLATFORM_INDEX_PATH, 'utf8'));
   const normalizedAdditionalStackFileNames = Array.isArray(selectedAdditionalStackFileNames)
     ? Array.from(new Set(selectedAdditionalStackFileNames.filter((stackFileName) => stackFileName && stackFileName !== selectedStackFileName)))
     : [];
@@ -150,22 +140,12 @@ export async function buildCompiledRulesContent({
       (blueprintFileName) => blueprintFileName && blueprintFileName !== selectedBlueprintFileName
     )))
     : [];
-  const selectedSkillDomainNames = inferSkillDomainNamesFromSelection(
-    selectedStackFileName,
-    selectedBlueprintFileName,
-    normalizedAdditionalStackFileNames,
-    normalizedAdditionalBlueprintFileNames
-  );
 
   const universalRuleFileNames = await collectFileNames(selectedRulesDirectoryPath);
+  const availableStackProfileFileNames = new Set(await collectFileNames(selectedStacksDirectoryPath));
+  const availableBlueprintProfileFileNames = new Set(await collectFileNames(selectedBlueprintsDirectoryPath));
   const contextBlocks = [];
 
-  function resolveSkillPackFileName(skillDomainEntry, selectedTierName) {
-    return skillDomainEntry.tierToPackFileNames?.[selectedTierName]
-      || skillDomainEntry.tierToPackFileNames?.[skillDomainEntry.defaultTier]
-      || skillDomainEntry.defaultPackFileName;
-  }
-
   function firstMarkdownHeading(content, fallbackLabel) {
     const headingLine = content
       .split(/\r?\n/)
@@ -178,21 +158,27 @@ export async function buildCompiledRulesContent({
     return headingLine.replace(/^#+\s*/, '').trim();
   }
 
+  function humanizeProfileName(fileName) {
+    return String(fileName || '')
+      .replace(/\.md$/i, '')
+      .replace(/[-_]/g, ' ')
+      .trim();
+  }
+
   contextBlocks.push(
     [
       '## BOOTSTRAP CHAIN (MANDATORY)',
       'Load every layer before responding. Do not skip steps:',
       '1. .agent-context/rules/',
-      '2. .agent-context/stacks/ (lazy by task scope)',
-      '3. .agent-context/blueprints/',
-      '4. .agent-context/skills/',
-      '5. .agent-context/prompts/',
-      '6. .agent-context/profiles/',
-      '7. .agent-context/state/',
-      `8. .agent-context/policies/${POLICY_FILE_NAME}`,
+      '2. Resolve architecture and stack signals from project context and live evidence.',
+      '3. .agent-context/prompts/',
+      '4. Dynamic architecture and stack signals (from project context + research evidence)',
+      '5. .agent-context/state/',
+      `6. .agent-context/policies/${POLICY_FILE_NAME}`,
+      '7. docs/ project context (or bootstrap prompts when docs are not materialized)',
       '',
-      'Primary entrypoint: .cursorrules',
-      'Mirror entrypoint: .windsurfrules',
+      'Primary entrypoint: .agent-instructions.md',
+      'Adapter entrypoints: .cursorrules, .windsurfrules, .clauderc, .gemini/instructions.md, .github/copilot-instructions.md',
       'Canonical baseline: .instructions.md',
     ].join('\n')
   );
@@ -208,12 +194,16 @@ export async function buildCompiledRulesContent({
   );
 
   const stackFilePath = path.join(selectedStacksDirectoryPath, selectedStackFileName);
-  const stackContent = await fs.readFile(stackFilePath, 'utf8');
-  const stackSummary = firstMarkdownHeading(stackContent, selectedStackFileName);
+  const hasStackProfileFile = availableStackProfileFileNames.has(selectedStackFileName);
+  const stackSummary = hasStackProfileFile
+    ? firstMarkdownHeading(await fs.readFile(stackFilePath, 'utf8'), selectedStackFileName)
+    : `Dynamic stack strategy signal for ${humanizeProfileName(selectedStackFileName)}.`;
   contextBlocks.push(
     [
       `## LAYER 2: STACK PROFILE (${selectedStackFileName})`,
-      `Source: .agent-context/stacks/${selectedStackFileName}`,
+      hasStackProfileFile
+        ? `Source: stack-profile:${selectedStackFileName}`
+        : 'Source: dynamic-research-signal (static stack profile file not required)',
       `Summary: ${stackSummary}`,
       'Load this stack profile to enforce language-specific conventions.',
     ].join('\n')
@@ -224,7 +214,13 @@ export async function buildCompiledRulesContent({
       [
         '## LAYER 2B: ADDITIONAL STACK PROFILES',
         'This project uses multiple stacks. Load all additional stack profiles below:',
-        ...normalizedAdditionalStackFileNames.map((stackFileName, stackIndex) => `${stackIndex + 1}. .agent-context/stacks/${stackFileName}`),
+        ...normalizedAdditionalStackFileNames.map((stackFileName, stackIndex) => {
+          if (availableStackProfileFileNames.has(stackFileName)) {
+            return `${stackIndex + 1}. stack-profile:${stackFileName}`;
+          }
+
+          return `${stackIndex + 1}. ${stackFileName} (dynamic stack signal)`;
+        }),
       ].join('\n')
     );
   }
@@ -232,9 +228,17 @@ export async function buildCompiledRulesContent({
   contextBlocks.push(
     [
       '## LAYER 2 POLICY: LAZY RULE LOADING',
-      `Primary stack profile is always loaded for this project: .agent-context/stacks/${selectedStackFileName}`,
+      hasStackProfileFile
+        ? `Primary stack profile is always loaded for this project: stack-profile:${selectedStackFileName}`
+        : `Primary stack strategy is always loaded for this project: ${selectedStackFileName} (dynamic mode)`,
       normalizedAdditionalStackFileNames.length > 0
-        ? `Additional stack profiles load on demand: ${normalizedAdditionalStackFileNames.map((stackFileName) => `.agent-context/stacks/${stackFileName}`).join(', ')}`
+        ? `Additional stack profiles load on demand: ${normalizedAdditionalStackFileNames.map((stackFileName) => {
+          if (availableStackProfileFileNames.has(stackFileName)) {
+            return `stack-profile:${stackFileName}`;
+          }
+
+          return `${stackFileName} (dynamic signal)`;
+        }).join(', ')}`
         : 'Additional stack profiles load only when explicitly selected or detected.',
       'Load stack guidance only when task scope touches that stack.',
       'Avoid eager loading unrelated stack profiles to prevent instruction conflicts.',
@@ -242,12 +246,16 @@ export async function buildCompiledRulesContent({
   );
 
   const blueprintFilePath = path.join(selectedBlueprintsDirectoryPath, selectedBlueprintFileName);
-  const blueprintContent = await fs.readFile(blueprintFilePath, 'utf8');
-  const blueprintSummary = firstMarkdownHeading(blueprintContent, selectedBlueprintFileName);
+  const hasBlueprintProfileFile = availableBlueprintProfileFileNames.has(selectedBlueprintFileName);
+  const blueprintSummary = hasBlueprintProfileFile
+    ? firstMarkdownHeading(await fs.readFile(blueprintFilePath, 'utf8'), selectedBlueprintFileName)
+    : `Dynamic architecture strategy signal for ${humanizeProfileName(selectedBlueprintFileName)}.`;
   contextBlocks.push(
     [
       `## LAYER 3: BLUEPRINT PROFILE (${selectedBlueprintFileName})`,
-      `Source: .agent-context/blueprints/${selectedBlueprintFileName}`,
+      hasBlueprintProfileFile
+        ? `Source: architecture-profile:${selectedBlueprintFileName}`
+        : 'Source: dynamic-research-signal (static blueprint profile file not required)',
       `Summary: ${blueprintSummary}`,
       'Load this blueprint when scaffolding or changing architecture boundaries.',
     ].join('\n')
@@ -258,42 +266,31 @@ export async function buildCompiledRulesContent({
       [
         '## LAYER 3A: ADDITIONAL BLUEPRINT PROFILES',
         'This project uses multiple architecture blueprints. Load all additional blueprint profiles below:',
-        ...normalizedAdditionalBlueprintFileNames.map(
-          (blueprintFileName, blueprintIndex) => `${blueprintIndex + 1}. .agent-context/blueprints/${blueprintFileName}`
-        ),
-      ].join('\n')
-    );
-  }
+        ...normalizedAdditionalBlueprintFileNames.map((blueprintFileName, blueprintIndex) => {
+          if (availableBlueprintProfileFileNames.has(blueprintFileName)) {
+            return `${blueprintIndex + 1}. architecture-profile:${blueprintFileName}`;
+          }
 
-  if (includeCiGuardrails) {
-    contextBlocks.push(
-      [
-        '## LAYER 3B: CI/CD GUARDRAILS',
-        'Load these CI blueprints when pipeline or release logic is touched:',
-        '1. .agent-context/blueprints/ci-github-actions.md',
-        '2. .agent-context/blueprints/ci-gitlab.md',
+          return `${blueprintIndex + 1}. ${blueprintFileName} (dynamic architecture signal)`;
+        }),
       ].join('\n')
     );
   }
 
-  for (const selectedSkillDomainName of selectedSkillDomainNames) {
-    const skillDomainEntry = skillPlatformIndex.domains?.[selectedSkillDomainName];
-    if (!skillDomainEntry) {
-      continue;
-    }
+  if (includeCiGuardrails) {
+    const ciBlueprintEntries = ['ci-github-actions.md', 'ci-gitlab.md'].map((ciBlueprintFileName, ciBlueprintIndex) => {
+      if (availableBlueprintProfileFileNames.has(ciBlueprintFileName)) {
+        return `${ciBlueprintIndex + 1}. architecture-profile:${ciBlueprintFileName}`;
+      }
 
-    const selectedTierName = skillPlatformIndex.defaultTier || 'advance';
-    const resolvedPackFileName = resolveSkillPackFileName(skillDomainEntry, selectedTierName);
+      return `${ciBlueprintIndex + 1}. ${ciBlueprintFileName} (dynamic CI policy signal)`;
+    });
 
     contextBlocks.push(
       [
-        `## SKILL PACK: ${skillDomainEntry.displayName}`,
-        `Source: .agent-context/skills/${resolvedPackFileName}`,
-        `Default tier: ${skillDomainEntry.defaultTier}`,
-        `Selected tier: ${selectedTierName}`,
-        `Evidence: ${skillDomainEntry.evidence}`,
-        `Purpose: ${skillDomainEntry.description}`,
-        'Load this skill pack and apply every Must-Have Check.',
+        '## LAYER 3B: CI/CD GUARDRAILS',
+        'Load these CI blueprints when pipeline or release logic is touched:',
+        ...ciBlueprintEntries,
       ].join('\n')
     );
   }
@@ -325,8 +322,8 @@ export async function buildCompiledRulesContent({
     [
       '## REVIEW CHECKLISTS (MANDATORY)',
       '1. .agent-context/review-checklists/pr-checklist.md',
-      '2. .agent-context/review-checklists/security-audit.md (when security-sensitive)',
-      '3. .agent-context/review-checklists/performance-audit.md (when perf-critical)',
+      '2. .agent-context/review-checklists/architecture-review.md',
+      'Security and performance checks are consolidated inside these two checklist files.',
       'Do not claim done before checklist pass.',
     ].join('\n')
   );
@@ -370,6 +367,11 @@ export async function buildCompiledRulesContent({
         'Read them before writing any application code:',
         ...projectDocsEntries.map((docFileName, docIndex) => `${docIndex + 1}. docs/${docFileName}`),
         '',
+        'Universal SOP hard block policy:',
+        '- Stop implementation if docs/architecture-decision-record.md (alias: docs/Architecture-Decision-Record.md) is missing.',
+        '- For UI scope, stop implementation if docs/DESIGN.md is missing.',
+        '- Materialize missing docs first, then continue coding.',
+        '',
         'These docs were generated during project initialization and reflect the architecture,',
         'database design, API contracts, and application flows chosen for this project.',
         'Latest user prompt defines current feature scope and product direction.',
@@ -397,10 +399,11 @@ export async function buildCompiledRulesContent({
         ...bootstrapPromptEntries.map((promptFilePath, promptIndex) => `${promptIndex + 1}. ${promptFilePath}`),
         '',
         'Bootstrap policy:',
+        '- Hard block: do not write application code until docs/project-brief.md and docs/architecture-decision-record.md exist.',
         '- If docs/project-brief.md is missing, execute bootstrap-project-context prompt immediately.',
         hasBootstrapDesignPrompt
-          ? '- If docs/DESIGN.md is missing, execute bootstrap-design prompt before implementing UI surfaces.'
-          : '- If UI scope is later introduced, add a design bootstrap prompt before implementing UI surfaces.',
+          ? '- For UI scope: if docs/DESIGN.md is missing, execute bootstrap-design prompt before implementing UI surfaces.'
+          : '- For UI scope: add a design bootstrap prompt before implementing UI surfaces.',
         '- Save generated docs under docs/ and keep them updated when feature scope changes.',
         'Latest user prompt defines current feature scope and product direction.',
         'Treat synthesized docs as living references, then continue implementation with those docs as source of truth.',
@@ -452,8 +455,10 @@ export async function compileDynamicContext({
     includeCiGuardrails,
   });
 
+  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.agent-instructions.md'), compiledRules, 'utf8');
   await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.cursorrules'), compiledRules, 'utf8');
   await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.windsurfrules'), compiledRules, 'utf8');
+  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.clauderc'), compiledRules, 'utf8');
   
   // Gemini (Antigravity Editor) instructions
   const geminiDir = path.join(resolvedTargetDirectoryPath, '.gemini');

package/lib/cli/constants.mjs

@@ -13,8 +13,6 @@ export const REPO_ROOT = resolve(currentDirectoryPath, '..', '..');
 export const PACKAGE_JSON_PATH = join(REPO_ROOT, 'package.json');
 export const CLI_VERSION = JSON.parse(readFileSync(PACKAGE_JSON_PATH, 'utf8')).version;
 export const AGENT_CONTEXT_DIR = join(REPO_ROOT, '.agent-context');
-export const SKILL_PLATFORM_DIRECTORY = join(AGENT_CONTEXT_DIR, 'skills');
-export const SKILL_PLATFORM_INDEX_PATH = join(SKILL_PLATFORM_DIRECTORY, 'index.json');
 export const POLICY_FILE_NAME = 'llm-judge-threshold.json';
 export const PROFILE_PACKS_DIRECTORY_NAME = 'profiles';
 
@@ -43,6 +41,81 @@ export const BLUEPRINT_RECOMMENDATIONS = {
   'flutter.md': 'mobile-app.md',
 };
 
+export const FALLBACK_STACK_FILE_NAMES = [
+  'typescript.md',
+  'python.md',
+  'go.md',
+  'java.md',
+  'php.md',
+  'csharp.md',
+  'rust.md',
+  'ruby.md',
+  'react-native.md',
+  'flutter.md',
+];
+
+export const FALLBACK_BLUEPRINT_FILE_NAMES = [
+  'api-nextjs.md',
+  'nestjs-logic.md',
+  'fastapi-service.md',
+  'spring-boot-api.md',
+  'go-service.md',
+  'aspnet-api.md',
+  'laravel-api.md',
+  'graphql-grpc-api.md',
+  'ci-github-actions.md',
+  'ci-gitlab.md',
+  'kubernetes-manifests.md',
+  'infrastructure-as-code.md',
+  'observability.md',
+  'mobile-app.md',
+];
+
+export const FALLBACK_PROFILE_PACK_DEFINITIONS = [
+  {
+    fileName: 'startup.md',
+    slug: 'startup',
+    displayName: 'Startup Team',
+    description: 'Fast iteration with balanced guardrails and quick onboarding defaults.',
+    defaultProfileName: 'balanced',
+    defaultStackFileName: 'typescript.md',
+    defaultBlueprintFileName: 'api-nextjs.md',
+    defaultCi: true,
+    lockCi: false,
+    blockingSeverities: ['critical', 'high'],
+    owner: 'product-engineering',
+    lastUpdated: '2026-03-19',
+  },
+  {
+    fileName: 'regulated.md',
+    slug: 'regulated',
+    displayName: 'Regulated Team',
+    description: 'Compliance-first defaults with strict policy and locked CI guardrails.',
+    defaultProfileName: 'strict',
+    defaultStackFileName: 'typescript.md',
+    defaultBlueprintFileName: 'api-nextjs.md',
+    defaultCi: true,
+    lockCi: true,
+    blockingSeverities: ['critical', 'high', 'medium'],
+    owner: 'governance-office',
+    lastUpdated: '2026-03-19',
+  },
+  {
+    fileName: 'platform.md',
+    slug: 'platform',
+    displayName: 'Platform Team',
+    description: 'Reliability-oriented defaults for shared platform modules across teams.',
+    defaultProfileName: 'balanced',
+    defaultStackFileName: 'go.md',
+    defaultBlueprintFileName: 'go-service.md',
+    defaultCi: true,
+    lockCi: false,
+    blockingSeverities: ['critical', 'high'],
+    owner: 'platform-foundation',
+    lastUpdated: '2026-03-19',
+  },
+];
+
 export const INIT_PRESETS = {
   'frontend-web': {
     profile: 'balanced',
@@ -164,38 +237,23 @@ export const GOLDEN_STANDARD_PROFILE_NAME = 'balanced';
 
 export const PROJECT_SCOPE_CHOICES = [
   {
-    key: 'api-service',
-    label: 'API service',
-  },
-  {
-    key: 'web-application',
-    label: 'Web application',
-  },
-  {
-    key: 'mobile-app',
-    label: 'Mobile app',
-  },
-  {
-    key: 'cli-tool',
-    label: 'CLI tool',
+    key: 'frontend-only',
+    label: 'Frontend only',
   },
   {
-    key: 'library-sdk',
-    label: 'Library / SDK',
+    key: 'backend-only',
+    label: 'Backend only',
   },
   {
-    key: 'other',
-    label: 'Other',
+    key: 'both',
+    label: 'Both (frontend + backend)',
   },
 ];
 
 export const PROJECT_SCOPE_STACK_FILTERS = {
-  'api-service': ['typescript.md', 'python.md', 'go.md', 'java.md', 'php.md', 'csharp.md', 'ruby.md', 'rust.md'],
-  'web-application': ['typescript.md', 'python.md', 'go.md', 'java.md', 'php.md', 'csharp.md', 'ruby.md', 'rust.md'],
-  'mobile-app': ['react-native.md', 'flutter.md'],
-  'cli-tool': ['typescript.md', 'python.md', 'go.md', 'rust.md', 'ruby.md', 'java.md', 'csharp.md'],
-  'library-sdk': ['typescript.md', 'python.md', 'go.md', 'rust.md', 'java.md', 'csharp.md', 'php.md', 'ruby.md'],
-  other: null,
+  'frontend-only': ['typescript.md'],
+  'backend-only': ['typescript.md', 'python.md', 'go.md', 'java.md', 'php.md', 'csharp.md', 'ruby.md', 'rust.md'],
+  both: ['typescript.md', 'python.md', 'go.md', 'java.md', 'php.md', 'csharp.md', 'ruby.md', 'rust.md'],
 };
 
 export const WEB_FRONTEND_STACK_CANDIDATES = ['typescript.md'];