@ryuenn3123/agentic-senior-core 3.0.12 → 3.0.13

package/.agent-context/rules/architecture.md

@@ -20,9 +20,16 @@ The `.agent-context/rules/` directory is the default guidance source for impleme
 - Backend and frontend mindset checks are both required when a task spans API and UI boundaries.
 - Security and testing are non-negotiable baseline requirements.
 - Hard block before coding:
+  - `docs/project-brief.md` must exist.
   - `docs/architecture-decision-record.md` (alias: `docs/Architecture-Decision-Record.md`) must exist.
+  - `docs/flow-overview.md` must exist.
+  - If the project uses persistent data, `docs/database-schema.md` must exist.
+  - If the project exposes API or web application flows, `docs/api-contract.md` must exist.
   - For UI scope, `docs/DESIGN.md` and `docs/design-intent.json` must exist.
 - If required project context docs are missing, stop implementation and bootstrap docs before writing application code.
+- Bootstrap flow: analyze the real repo plus the latest user prompt before authoring those docs.
+- Bootstrap docs must be adaptive and project-specific. Do not create generic placeholder templates.
+- When context is incomplete, separate confirmed facts from assumptions, add an `Assumptions to Validate` section, and end with the next validation action.
 
 ## Rules as Guardian (Cross-Session Consistency)
 

package/.agent-context/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-21T07:20:28.027Z",
+  "generatedAt": "2026-04-21T11:40:14.071Z",
   "reportName": "memory-continuity-benchmark",
   "schemaVersion": "1.0.0",
   "passed": true,

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.12
+Generated by Agentic-Senior-Core CLI v3.0.13
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.12
+Generated by Agentic-Senior-Core CLI v3.0.13
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/lib/cli/commands/init.mjs

@@ -8,13 +8,13 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import {
+  PROJECT_SCOPE_CHOICES,
   CLI_VERSION,
   AGENT_CONTEXT_DIR,
   INIT_PRESETS,
   PROFILE_PRESETS,
   GOLDEN_STANDARD_PROFILE_NAME,
   BLUEPRINT_RECOMMENDATIONS,
-  PROJECT_SCOPE_CHOICES,
   FALLBACK_STACK_FILE_NAMES,
   FALLBACK_BLUEPRINT_FILE_NAMES,
   RUNTIME_ENVIRONMENT_CHOICES,
@@ -42,10 +42,13 @@ import {
 } from '../detector.mjs';
 import { compileDynamicContext, writeSelectedPolicy, writeOnboardingReport } from '../compiler.mjs';
 import {
+  filterStackFileNamesByCandidates,
   filterBlueprintFileNamesByCandidates,
   normalizeAdditionalStackSelection,
   normalizeAdditionalBlueprintSelection,
   deriveAdditionalBlueprintFileNamesFromStacks,
+  resolveScopeStackCandidates,
+  resolveScopeBlueprintCandidates,
 } from '../init-selection.mjs';
 import {
   buildExistingProjectMajorConstraints,
@@ -75,11 +78,7 @@ import {
   createMemoryContinuityState,
   writeMemoryContinuityState,
 } from '../memory-continuity.mjs';
-import {
-  readArchitectPreferenceState,
-  writeArchitectPreferenceState,
-} from '../architect.mjs';
-import { resolveArchitectureSelection } from '../init-architecture-flow.mjs';
+import { recommendArchitecture } from '../architect.mjs';
 
 export { REPO_ROOT } from '../constants.mjs';
 // Keep these architect option flags visible in the init command surface for validator coverage:
@@ -156,6 +155,82 @@ export function detectRuntimeEnvironment() {
   };
 }
 
+function resolveProjectScopeLabelFromKey(projectScopeKey) {
+  return PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.key === projectScopeKey)?.label
+    || PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.key === 'both')?.label
+    || 'Both (frontend + backend)';
+}
+
+function inferProjectScopeFromDiscoveryAnswers(discoveryAnswers) {
+  const normalizedDomain = String(discoveryAnswers?.primaryDomain || '').trim().toLowerCase();
+  const normalizedDescription = [
+    discoveryAnswers?.projectDescription,
+    ...(Array.isArray(discoveryAnswers?.features) ? discoveryAnswers.features : []),
+  ].join(' ').toLowerCase();
+
+  if (
+    normalizedDomain.includes('api service')
+    || normalizedDomain.includes('cli tool')
+    || normalizedDomain.includes('library')
+  ) {
+    return 'backend-only';
+  }
+
+  if (normalizedDomain.includes('mobile app')) {
+    return 'frontend-only';
+  }
+
+  if (normalizedDomain.includes('web application')) {
+    if (/(landing page|marketing site|showcase|portfolio|brochure|company profile)/.test(normalizedDescription)) {
+      return 'frontend-only';
+    }
+
+    return 'both';
+  }
+
+  return 'both';
+}
+
+function resolveSilentCiGuardrailsDefault({
+  initOptions,
+  selectedPreset,
+  selectedProfilePack,
+  selectedProfile,
+}) {
+  if (typeof initOptions.ci === 'boolean') {
+    return {
+      value: initOptions.ci,
+      shouldAsk: false,
+    };
+  }
+
+  if (typeof selectedPreset?.ci === 'boolean') {
+    return {
+      value: selectedPreset.ci,
+      shouldAsk: false,
+    };
+  }
+
+  if (typeof selectedProfilePack?.defaultCi === 'boolean') {
+    return {
+      value: selectedProfilePack.defaultCi,
+      shouldAsk: Boolean(!selectedProfilePack.lockCi),
+    };
+  }
+
+  if (selectedProfile.lockCi) {
+    return {
+      value: selectedProfile.defaultCi,
+      shouldAsk: false,
+    };
+  }
+
+  return {
+    value: selectedProfile.defaultCi,
+    shouldAsk: true,
+  };
+}
+
 async function askStackSelection(promptMessage, selectableStackFileNames, userInterface) {
   const stackDisplayChoices = selectableStackFileNames.map((stackFileName) => toTitleCase(stackFileName));
   const selectedDisplayChoice = await askChoice(promptMessage, stackDisplayChoices, userInterface);
@@ -242,8 +317,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
   const wasDirectoryEffectivelyEmpty = await isDirectoryEffectivelyEmpty(resolvedTargetDirectoryPath);
   const hadExistingProjectDocsBeforeInit = await hasExistingProjectDocs(resolvedTargetDirectoryPath);
 
-  await createBackup(resolvedTargetDirectoryPath);
-
   const userInterface = createInterface({ input: stdin, output: stdout });
 
   try {
@@ -442,20 +515,21 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     let selectedAdditionalBlueprintFileNames = [];
     let detectedSetupWasApplied = false;
     let selectedProjectScopeKey = 'both';
-    let selectedProjectScopeLabel = PROJECT_SCOPE_CHOICES.find(
-      (scopeChoice) => scopeChoice.key === 'both'
-    )?.label || 'Both (frontend + backend)';
-
+    let selectedProjectScopeLabel = resolveProjectScopeLabelFromKey('both');
     let architectureRecommendation = null;
-    let architectureProjectDescription = '';
-    let architectPreferenceState = await readArchitectPreferenceState();
-    let architectPreferenceUpdated = false;
-
-    const shouldRunArchitectureRecommendation = !selectedStackFileNameFromOption
-      && !selectedPreset?.stack
-      && !shouldAutoApplyDetectedStack
-      && !selectedProfilePack?.defaultStackFileName
-      && !selectedProfile.defaultStackFileName;
+    let architectureProjectDescription = String(initOptions.projectDescription || '').trim();
+    let discoveryAnswers = null;
+    const ciGuardrailsSelection = resolveSilentCiGuardrailsDefault({
+      initOptions,
+      selectedPreset,
+      selectedProfilePack,
+      selectedProfile,
+    });
+    const isFreshProjectTarget = !projectDetection.hasExistingProjectFiles
+      && wasDirectoryEffectivelyEmpty
+      && !hadExistingProjectDocsBeforeInit;
+    const shouldRunInteractiveScaffolding = isInteractiveSession
+      && (initOptions.scaffoldDocs === true || (initOptions.scaffoldDocs !== false && isFreshProjectTarget));
 
     const detectedSetupDecision = await resolveDetectedSetupDecision({
       shouldAutoApplyDetectedStack,
@@ -479,37 +553,76 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     selectedAdditionalStackFileNames = detectedSetupDecision.selectedAdditionalStackFileNames;
     detectedBlueprintFileName = detectedSetupDecision.detectedBlueprintFileName;
 
-    const architectureSelection = await resolveArchitectureSelection({
-      shouldRunArchitectureRecommendation,
-      initOptions: {
-        ...initOptions,
-        targetDirectoryPath: resolvedTargetDirectoryPath,
+    if (initOptions.projectConfig) {
+      discoveryAnswers = await loadProjectConfig(initOptions.projectConfig);
+      console.log(`\nLoaded project configuration from: ${initOptions.projectConfig}`);
+    } else if (shouldRunInteractiveScaffolding) {
+      discoveryAnswers = await runProjectDiscovery(userInterface, {
+        defaultProjectName: path.basename(resolvedTargetDirectoryPath),
+        defaultProjectDescription: architectureProjectDescription,
+        defaultIncludeCiGuardrails: ciGuardrailsSelection.value,
+        askForCiGuardrails: ciGuardrailsSelection.shouldAsk,
+      });
+    } else if (initOptions.scaffoldDocs === true && !isInteractiveSession) {
+      throw new Error('Non-interactive scaffolding requires --project-config when --scaffold-docs is enabled.');
+    }
+
+    if (discoveryAnswers?.projectDescription) {
+      architectureProjectDescription = discoveryAnswers.projectDescription;
+    }
+
+    if (discoveryAnswers) {
+      selectedProjectScopeKey = inferProjectScopeFromDiscoveryAnswers(discoveryAnswers);
+      selectedProjectScopeLabel = resolveProjectScopeLabelFromKey(selectedProjectScopeKey);
+    }
+
+    const shouldUseSilentArchitectureSelection = !selectedStackFileNameFromOption
+      && !selectedPreset?.stack
+      && !shouldAutoApplyDetectedStack
+      && !selectedProfilePack?.defaultStackFileName
+      && !selectedProfile.defaultStackFileName;
+
+    if (shouldUseSilentArchitectureSelection) {
+      const architectureScopeStackCandidates = filterStackFileNamesByCandidates(
+        stackFileNames,
+        resolveScopeStackCandidates(selectedProjectScopeKey)
+      );
+      const architectureScopeBlueprintCandidates = filterBlueprintFileNamesByCandidates(
+        blueprintFileNames,
+        resolveScopeBlueprintCandidates(selectedProjectScopeKey)
+      );
+
+      architectureRecommendation = recommendArchitecture({
+        projectDescription: architectureProjectDescription || `A software project named ${path.basename(resolvedTargetDirectoryPath)}.`,
+        projectDetection,
+        stackFileNames: architectureScopeStackCandidates,
+        blueprintFileNames: architectureScopeBlueprintCandidates,
+        tokenBudget: initOptions.architectTokenBudget,
+        timeoutMs: initOptions.architectTimeoutMs,
         researchMode: initOptions.architectResearchMode,
         enableRealtimeResearch: initOptions.enableRealtimeResearch,
-      },
-      projectDetection,
-      stackFileNames,
-      blueprintFileNames,
-      userInterface,
-      isInteractiveSession,
-      initialSelectedProjectScopeKey: selectedProjectScopeKey,
-      initialSelectedProjectScopeLabel: selectedProjectScopeLabel,
-      initialSelectedManualStackFileName: selectedManualStackFileName,
-      initialSelectedManualBlueprintFileName: selectedManualBlueprintFileName,
-      architectPreferenceState,
-      askStackSelection,
-      askBlueprintSelection,
-      detectionTransparency,
-    });
+        realtimeSignalFilePath: initOptions.architectRealtimeSignalFile,
+      });
 
-    selectedProjectScopeKey = architectureSelection.selectedProjectScopeKey;
-    selectedProjectScopeLabel = architectureSelection.selectedProjectScopeLabel;
-    selectedManualStackFileName = architectureSelection.selectedManualStackFileName;
-    selectedManualBlueprintFileName = architectureSelection.selectedManualBlueprintFileName;
-    architectureProjectDescription = architectureSelection.architectureProjectDescription;
-    architectureRecommendation = architectureSelection.architectureRecommendation;
-    architectPreferenceState = architectureSelection.architectPreferenceState;
-    architectPreferenceUpdated = architectureSelection.architectPreferenceUpdated;
+      architectureRecommendation.projectDomain = {
+        key: selectedProjectScopeKey,
+        label: selectedProjectScopeLabel,
+      };
+      architectureRecommendation.userVeto = {
+        applied: false,
+        selectedStackFileName: architectureRecommendation.recommendedStackFileName,
+        selectedBlueprintFileName: architectureRecommendation.recommendedBlueprintFileName,
+        source: projectDetection.hasExistingProjectFiles ? 'silent-existing-bootstrap' : 'silent-fresh-bootstrap',
+      };
+
+      selectedManualStackFileName = architectureRecommendation.recommendedStackFileName;
+      selectedManualBlueprintFileName = architectureRecommendation.recommendedBlueprintFileName;
+
+      if (!projectDetection.hasExistingProjectFiles) {
+        detectionTransparency.quickConfirmation.response = 'fresh-project-streamlined';
+        detectionTransparency.decision.mode = 'fresh-project-streamlined';
+      }
+    }
 
     const blueprintDisplayChoices = blueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName));
 
@@ -550,15 +663,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     if (architectureRecommendation) {
       architectureRecommendation.appliedStackFileName = selectedResolvedStackFileName;
       architectureRecommendation.appliedBlueprintFileName = selectedResolvedBlueprintFileName;
-
-      if (!architectureRecommendation.userVeto) {
-        architectureRecommendation.userVeto = {
-          applied: false,
-          selectedStackFileName: selectedResolvedStackFileName,
-          selectedBlueprintFileName: selectedResolvedBlueprintFileName,
-          source: 'recommendation',
-        };
-      }
     }
 
     const derivedAdditionalBlueprintFileNames = deriveAdditionalBlueprintFileNamesFromStacks(
@@ -580,23 +684,25 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     detectionTransparency.decision.selectedAdditionalBlueprintFileNames = selectedAdditionalBlueprintFileNames;
     detectionTransparency.decision.usedDetectedSetup = detectedSetupWasApplied;
 
-    const includeCiGuardrails = typeof initOptions.ci === 'boolean'
-      ? initOptions.ci
-      : typeof selectedPreset?.ci === 'boolean'
-        ? selectedPreset.ci
-      : selectedProfilePack?.lockCi
-        ? selectedProfilePack.defaultCi
-        : typeof selectedProfilePack?.defaultCi === 'boolean'
-          ? selectedProfilePack.defaultCi
-      : selectedProfile.lockCi
-        ? selectedProfile.defaultCi
-        : await askYesNo('Enable CI/CD quality checks (guardrails) and the LLM Judge policy?', userInterface, selectedProfile.defaultCi);
+    const includeCiGuardrails = typeof discoveryAnswers?.includeCiGuardrails === 'boolean'
+      ? discoveryAnswers.includeCiGuardrails
+      : ciGuardrailsSelection.shouldAsk
+        ? (!isInteractiveSession
+          ? ciGuardrailsSelection.value
+          : await askYesNo(
+            'Enable CI/CD quality checks (guardrails) and the LLM Judge policy?',
+            userInterface,
+            ciGuardrailsSelection.value
+          ))
+        : ciGuardrailsSelection.value;
 
     detectionTransparency.activeRulesSummary.ciGuardrailsEnabled = includeCiGuardrails;
 
     detectionTransparency.decision.selectedProjectScopeKey = selectedProjectScopeKey;
     detectionTransparency.decision.selectedProjectScopeLabel = selectedProjectScopeLabel;
 
+    await createBackup(resolvedTargetDirectoryPath);
+
     await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
       includeMcpTemplate: shouldIncludeMcpTemplate,
     });
@@ -629,83 +735,50 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     // --- Project Documentation Scaffolding ---
     let scaffoldingResult = null;
     const supplementalMaterializedDocFileNames = [];
-    const isFreshProjectTarget = wasDirectoryEffectivelyEmpty && !hadExistingProjectDocsBeforeInit;
-    const shouldOfferScaffolding = initOptions.scaffoldDocs === true
-      || Boolean(initOptions.projectConfig)
-      || (initOptions.scaffoldDocs !== false && isFreshProjectTarget);
-
-    if (shouldOfferScaffolding) {
-      if (initOptions.scaffoldDocs === true && !initOptions.projectConfig && !isInteractiveSession) {
-        throw new Error('Non-interactive scaffolding requires --project-config when --scaffold-docs is enabled.');
+    if (discoveryAnswers) {
+      const normalizedConfigDocsLanguage = normalizeDocsLanguage(discoveryAnswers.docsLang || '');
+      if (discoveryAnswers.docsLang && !normalizedConfigDocsLanguage) {
+        throw new Error(`Unsupported docs language in project config: ${discoveryAnswers.docsLang}. Supported values: en, id`);
       }
 
-      const userWantsScaffolding = initOptions.scaffoldDocs === true
-        || initOptions.projectConfig
-        || (!isInteractiveSession
-          ? false
-          : await askYesNo(
-            'This is a fresh project. Want me to scaffold project documentation (architecture, database, API contract, flow)?',
-            userInterface,
-            true
-          ));
+      // Keep generated docs in English by default to align with the writing scope.
+      // A different output language is only used when explicitly requested via --docs-lang.
+      const selectedDocsLanguage = initOptions.docsLang;
 
-      if (userWantsScaffolding) {
-        let discoveryAnswers;
+      if (!initOptions.docsLangProvided && normalizedConfigDocsLanguage && normalizedConfigDocsLanguage !== 'en') {
+        console.log('[INFO] Project config docsLang is set, but output defaults to English. Use --docs-lang to override.');
+      }
 
-        if (initOptions.projectConfig) {
-          discoveryAnswers = await loadProjectConfig(initOptions.projectConfig);
-          console.log(`\nLoaded project configuration from: ${initOptions.projectConfig}`);
-        } else {
-          discoveryAnswers = await runProjectDiscovery(userInterface, {
-            defaultProjectName: path.basename(resolvedTargetDirectoryPath),
-            defaultProjectDescription: architectureProjectDescription,
-          });
+      scaffoldingResult = await generateProjectDocumentation(
+        resolvedTargetDirectoryPath,
+        discoveryAnswers,
+        {
+          stackFileName: selectedResolvedStackFileName,
+          additionalStackFileNames: selectedAdditionalStackFileNames,
+          blueprintFileName: selectedResolvedBlueprintFileName,
+          additionalBlueprintFileNames: selectedAdditionalBlueprintFileNames,
+          runtimeEnvironmentKey: selectedRuntimeEnvironmentKey,
+          runtimeEnvironmentLabel: resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey),
+          architectureRecommendation,
+        },
+        {
+          docsLanguage: selectedDocsLanguage,
         }
+      );
 
-        const normalizedConfigDocsLanguage = normalizeDocsLanguage(discoveryAnswers.docsLang || '');
-        if (discoveryAnswers.docsLang && !normalizedConfigDocsLanguage) {
-          throw new Error(`Unsupported docs language in project config: ${discoveryAnswers.docsLang}. Supported values: en, id`);
+      if (scaffoldingResult.bootstrapMode === 'ai-synthesis') {
+        console.log(`\nAI synthesis bootstrap prompts generated in .agent-context/prompts/:`);
+        for (const generatedPromptFileName of scaffoldingResult.generatedPromptFileNames || []) {
+          console.log(`  - .agent-context/prompts/${generatedPromptFileName}`);
         }
-
-        // Keep generated docs in English by default to align with the writing scope.
-        // A different output language is only used when explicitly requested via --docs-lang.
-        const selectedDocsLanguage = initOptions.docsLang;
-
-        if (!initOptions.docsLangProvided && normalizedConfigDocsLanguage && normalizedConfigDocsLanguage !== 'en') {
-          console.log('[INFO] Project config docsLang is set, but output defaults to English. Use --docs-lang to override.');
+        for (const materializedFileName of scaffoldingResult.materializedFileNames || []) {
+          console.log(`  - docs/${materializedFileName}`);
         }
-
-        scaffoldingResult = await generateProjectDocumentation(
-          resolvedTargetDirectoryPath,
-          discoveryAnswers,
-          {
-            stackFileName: selectedResolvedStackFileName,
-            additionalStackFileNames: selectedAdditionalStackFileNames,
-            blueprintFileName: selectedResolvedBlueprintFileName,
-            additionalBlueprintFileNames: selectedAdditionalBlueprintFileNames,
-            runtimeEnvironmentKey: selectedRuntimeEnvironmentKey,
-            runtimeEnvironmentLabel: resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey),
-            architectureRecommendation,
-          },
-          {
-            docsLanguage: selectedDocsLanguage,
-          }
-        );
-
-        if (scaffoldingResult.bootstrapMode === 'ai-synthesis') {
-          console.log(`\nAI synthesis bootstrap prompts generated in .agent-context/prompts/:`);
-          for (const generatedPromptFileName of scaffoldingResult.generatedPromptFileNames || []) {
-            console.log(`  - .agent-context/prompts/${generatedPromptFileName}`);
-          }
-          for (const materializedFileName of scaffoldingResult.materializedFileNames || []) {
-            console.log(`  - docs/${materializedFileName}`);
-          }
-          console.log('Project docs will be authored dynamically by your IDE assistant from these prompts.');
-        } else {
-          console.log(`\nProject documentation generated in docs/:`);
-          for (const generatedFileName of scaffoldingResult.generatedFileNames) {
-            console.log(`  - docs/${generatedFileName}`);
-          }
+        console.log('Project docs will be authored dynamically by your IDE assistant from these prompts.');
+      } else {
+        console.log(`\nProject documentation generated in docs/:`);
+        for (const generatedFileName of scaffoldingResult.generatedFileNames) {
+          console.log(`  - docs/${generatedFileName}`);
         }
       }
     }
@@ -795,10 +868,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       uiScopeSignals: existingProjectUiScopeSignals,
     });
 
-    if (architectPreferenceUpdated && architectPreferenceState) {
-      await writeArchitectPreferenceState(architectPreferenceState);
-    }
-
     console.log('\nInitialization complete.');
     console.log(`- Target directory: ${resolvedTargetDirectoryPath}`);
     console.log(`- Profile: ${selectedProfile.displayName}`);
@@ -808,18 +877,8 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     if (selectedProfilePack) {
       console.log(`- Team profile pack: ${selectedProfilePack.displayName}`);
     }
-    if (architectureRecommendation) {
-      console.log(
-        `- Architect recommendation: ${toTitleCase(architectureRecommendation.recommendedStackFileName)} + ${toTitleCase(architectureRecommendation.recommendedBlueprintFileName)} (${architectureRecommendation.confidenceLabel})`
-      );
-      if (!projectDetection.hasExistingProjectFiles) {
-        console.log(`- Project domain: ${selectedProjectScopeLabel}`);
-      }
-      if (architectureRecommendation.userVeto?.applied) {
-        console.log(
-          `- User veto path: applied (${toTitleCase(architectureRecommendation.userVeto.selectedStackFileName)} + ${toTitleCase(architectureRecommendation.userVeto.selectedBlueprintFileName)})`
-        );
-      }
+    if (!projectDetection.hasExistingProjectFiles) {
+      console.log(`- Project domain: ${selectedProjectScopeLabel}`);
     }
     console.log(`- Stack: ${toTitleCase(selectedResolvedStackFileName)}`);
     if (selectedAdditionalStackFileNames.length > 0) {

package/lib/cli/compiler.mjs

@@ -396,9 +396,15 @@ export async function buildCompiledRulesContent({
         ...projectDocsEntries.map((docFileName, docIndex) => `${docIndex + 1}. docs/${docFileName}`),
         '',
         'Universal SOP hard block policy:',
+        '- Stop implementation if docs/project-brief.md is missing.',
         '- Stop implementation if docs/architecture-decision-record.md (alias: docs/Architecture-Decision-Record.md) is missing.',
+        '- Stop implementation if docs/flow-overview.md is missing.',
+        '- If the product uses persistent data, docs/database-schema.md must exist before coding continues.',
+        '- If the product exposes API or web application flows, docs/api-contract.md must exist before coding continues.',
         '- For UI scope, stop implementation if docs/DESIGN.md or docs/design-intent.json is missing.',
         '- Materialize missing docs first, then continue coding.',
+        '- Bootstrap missing docs from real repo evidence and the latest user request. Do not write generic placeholder templates.',
+        '- Separate confirmed facts from assumptions and end each major explanation with the next validation action.',
         '',
         'These docs were generated during project initialization and reflect the architecture,',
         'database design, API contracts, and application flows chosen for this project.',
@@ -428,10 +434,15 @@ export async function buildCompiledRulesContent({
         '',
         'Bootstrap policy:',
         '- Hard block: do not write application code until docs/project-brief.md and docs/architecture-decision-record.md exist.',
+        '- docs/flow-overview.md must also exist before coding continues.',
+        '- Add docs/database-schema.md when persistent data is involved.',
+        '- Add docs/api-contract.md when API or web application flows are involved.',
         '- If docs/project-brief.md is missing, execute bootstrap-project-context prompt immediately.',
         hasBootstrapDesignPrompt
           ? '- For UI scope: if docs/DESIGN.md or docs/design-intent.json is missing, execute bootstrap-design prompt before implementing UI surfaces.'
           : '- For UI scope: add a design bootstrap prompt before implementing UI surfaces.',
+        '- Bootstrap docs from repo evidence and the latest user request. Do not use generic placeholder templates.',
+        '- Separate confirmed facts from assumptions, include an Assumptions to Validate section when context is incomplete, and end with the next validation action.',
         '- 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.',

package/lib/cli/detector.mjs

@@ -100,6 +100,24 @@ const PROJECT_MARKER_FILE_NAMES = new Set([
   'tsconfig.json',
   ...DIRECT_UI_MARKER_NAMES,
 ]);
+const INTERNAL_GOVERNANCE_SURFACE_NAMES = new Set([
+  '.agent-context',
+  '.agent-instructions.md',
+  '.agent-override.md',
+  '.agentic-backup',
+  '.agents',
+  '.clauderc',
+  '.cursorrules',
+  '.cursor',
+  '.gemini',
+  '.github',
+  '.instructions.md',
+  '.vscode',
+  '.windsurfrules',
+  '.zed',
+  'AGENTS.md',
+  'mcp.json',
+]);
 
 function looksLikeWorkspaceSearchCandidate(directoryName) {
   const normalizedDirectoryName = String(directoryName || '').trim().toLowerCase();
@@ -148,6 +166,10 @@ export async function collectProjectMarkers(targetDirectoryPath) {
       continue;
     }
 
+    if (INTERNAL_GOVERNANCE_SURFACE_NAMES.has(directoryEntry.name)) {
+      continue;
+    }
+
     markerNames.add(directoryEntry.name);
   }
 

package/lib/cli/project-scaffolder.mjs

@@ -6,7 +6,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
-import { ensureDirectory, askChoice, toTitleCase, pathExists } from './utils.mjs';
+import { ensureDirectory, askChoice, askYesNo, toTitleCase, pathExists } from './utils.mjs';
 
 const SUPPORTED_DOC_LANGUAGES = new Set(['en', 'id']);
 const PROJECT_DOC_FILE_NAMES = [
@@ -137,14 +137,18 @@ export function normalizeDocsLanguage(rawDocsLanguage = 'en') {
  * Returns a structured object with all user responses.
  */
 export async function runProjectDiscovery(userInterface, options = {}) {
-  console.log('\n--- Project Discovery ---');
-  console.log('I will ask a few questions to generate project-specific documentation.');
+  console.log('\n--- Project Setup ---');
+  console.log('I will ask one focused set of questions to bootstrap project context and documentation.');
   console.log('This helps AI agents understand your project before writing code.\n');
   console.log('You can answer in your own language.');
   console.log('CLI prompts stay in English, but non-English answers are fully supported.\n');
 
   const defaultProjectName = (options.defaultProjectName || '').trim();
   const defaultProjectDescription = String(options.defaultProjectDescription || '').trim();
+  const defaultIncludeCiGuardrails = typeof options.defaultIncludeCiGuardrails === 'boolean'
+    ? options.defaultIncludeCiGuardrails
+    : true;
+  const shouldAskForCiGuardrails = options.askForCiGuardrails !== false;
   let projectName = '';
 
   const projectNamePrompt = defaultProjectName
@@ -171,6 +175,14 @@ export async function runProjectDiscovery(userInterface, options = {}) {
     projectDescription = defaultProjectDescription || `A ${projectName} project.`;
   }
 
+  const includeCiGuardrails = shouldAskForCiGuardrails
+    ? await askYesNo(
+      'Enable CI/CD quality checks (guardrails) and the LLM Judge policy?',
+      userInterface,
+      defaultIncludeCiGuardrails
+    )
+    : defaultIncludeCiGuardrails;
+
   const domainSelection = await askChoice(
     'Primary domain:',
     DOMAIN_CHOICES,
@@ -210,24 +222,18 @@ export async function runProjectDiscovery(userInterface, options = {}) {
     userInterface
   );
 
-  let features = await askFeatureList(userInterface);
-
-  if (features.length === 0) {
-    features.push('Core functionality (define during development)');
-  }
-
-  const additionalContext = (await userInterface.question('\nAdditional context (optional, press Enter to skip): ')).trim()
-    || 'No additional context provided.';
+  const features = await askFeatureList(userInterface);
 
   return {
     projectName,
     projectDescription,
+    includeCiGuardrails,
     primaryDomain,
     databaseChoice,
     authStrategy,
     dockerStrategy,
     features,
-    additionalContext,
+    additionalContext: 'No additional context provided.',
   };
 }
 
@@ -508,7 +514,14 @@ function buildDesignIntentContractObject({
     primaryDomain,
     features,
   });
-  const designSignals = architectureRecommendation?.designGuidance?.normalizedSignals || null;
+  const normalizedPrimaryDomain = String(primaryDomain || '').trim().toLowerCase();
+  const resolvedSpacingPattern = inferredKeywords.densityMode === 'dense'
+    ? 'compact-grid'
+    : normalizedPrimaryDomain.includes('mobile')
+      ? 'mobile-first-single-axis'
+      : inferredKeywords.densityMode === 'focused'
+        ? 'high-contrast-rhythm'
+        : 'balanced-grid';
 
   return {
     mode: 'dynamic',
@@ -531,14 +544,14 @@ function buildDesignIntentContractObject({
     mathSystems: {
       typographyScaleRatio: inferredKeywords.typographyScaleRatio,
       baseGridUnit: inferredKeywords.baseGridUnit,
-      spacingPattern: designSignals?.spacingPattern || 'balanced-grid',
+      spacingPattern: resolvedSpacingPattern,
       densityMode: inferredKeywords.densityMode,
     },
     colorTruth: {
       format: 'OKLCH',
       allowHexDerivatives: true,
       requirePerceptualLightnessCurve: true,
-      paletteRoles: designSignals?.paletteRoles || ['base', 'surface', 'accent'],
+      paletteRoles: ['base', 'surface', 'accent'],
       intent: inferredKeywords.colorIntent,
     },
     crossViewportAdaptation: {
@@ -603,7 +616,6 @@ function buildDesignIntentContractObject({
         '.agent-context/rules/microservices.md',
       ],
     },
-    architectSignals: designSignals,
     ...supplementalFields,
   };
 }
@@ -766,7 +778,7 @@ function buildProjectContextBootstrapPrompt({
 }) {
   const featuresList = Array.isArray(discoveryAnswers.features) && discoveryAnswers.features.length > 0
     ? discoveryAnswers.features.map((feature, featureIndex) => `${featureIndex + 1}. ${feature}`).join('\n')
-    : '1. Core functionality (define during implementation)';
+    : 'Derive the first concrete feature set from the project name, description, and domain. Do not invent arbitrary modules just to fill space.';
 
   const expectedDocsList = expectedDocFileNames
     .map((fileName, fileIndex) => `${fileIndex + 1}. docs/${fileName}`)
@@ -802,6 +814,11 @@ function buildProjectContextBootstrapPrompt({
     '3. Keep stack, database, and auth aligned with the project constraints below unless user explicitly requests migration.',
     '4. Output must be implementation-ready for engineers, not generic textbook explanation.',
     '5. For any research-backed claim, include citation metadata (source + fetchedAt timestamp) from the Architect Engine Snapshot.',
+    '6. Write for native English speakers at an 8th-grade reading level. Use clear, direct, plain language.',
+    '7. Avoid emoji, AI cliches, buzzwords, academic phrasing, padding, and generic filler.',
+    '8. Separate confirmed facts from assumptions explicitly. When context is incomplete, add an `Assumptions to Validate` section and a `Next Validation Action` line.',
+    '9. If user inputs conflict with repo evidence, call out the conflict and choose the safer interpretation instead of silently forcing a generic answer.',
+    '10. Do not invent modules or architecture layers only to make the docs look complete.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -829,8 +846,10 @@ function buildProjectContextBootstrapPrompt({
     '',
     '## Required Execution',
     '1. Create all required docs files listed above with complete Markdown content.',
-    '2. Keep content original, specific to this project, and actionable for implementation.',
-    '3. After writing docs, continue coding tasks using these docs as living project context.',
+    '2. Make the docs adaptive to the real repo and prompt context. These are living references, not frozen templates.',
+    '3. In docs/project-brief.md and docs/architecture-decision-record.md, include explicit sections for confirmed facts, assumptions to validate, and next validation actions whenever context is incomplete.',
+    '4. Keep content original, specific to this project, and actionable for implementation.',
+    '5. After writing docs, continue coding tasks using these docs as living project context.',
     '',
   ].join('\n');
 }
@@ -841,8 +860,6 @@ function buildDesignBootstrapPrompt({
   docsLanguage,
   architectureRecommendation,
 }) {
-  const designSignals = architectureRecommendation?.designGuidance?.normalizedSignals || null;
-  const designSignalsJson = JSON.stringify(designSignals, null, 2);
   const designIntentSeed = buildDesignIntentSeed({
     discoveryAnswers,
     initContext,
@@ -918,12 +935,6 @@ function buildDesignBootstrapPrompt({
     `- Stack: ${toTitleCase(initContext.stackFileName)}`,
     `- Blueprint: ${toTitleCase(initContext.blueprintFileName)}`,
     '',
-    '## Architect Design Signals (raw control vector)',
-    'Use this only as baseline fuel, then expand into full design direction with original reasoning:',
-    '```json',
-    designSignalsJson || 'null',
-    '```',
-    '',
     '## Seed Machine Contract',
     'Refine this seed instead of discarding it. Keep the final JSON aligned with the markdown design system.',
     '```json',
@@ -1133,6 +1144,7 @@ export async function loadProjectConfig(configFilePath) {
   return {
     projectName: configEntries.projectName || configEntries.name || '',
     projectDescription: configEntries.projectDescription || configEntries.description || '',
+    includeCiGuardrails: parseBooleanLikeValue(configEntries.includeCiGuardrails) ?? parseBooleanLikeValue(configEntries.ci) ?? true,
     primaryDomain: configEntries.primaryDomain || configEntries.domain || 'API service',
     databaseChoice: configEntries.databaseChoice || configEntries.database || 'None (stateless service)',
     authStrategy: configEntries.authStrategy || configEntries.auth || 'None (public service)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "3.0.12",
+  "version": "3.0.13",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {