@ryuenn3123/agentic-senior-core 2.5.21 → 2.5.22

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-18T04:35:55.199Z",
+  "generatedAt": "2026-04-18T05:17:09.876Z",
   "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 v2.5.21
+Generated by Agentic-Senior-Core CLI v2.5.22
 Timestamp: 2026-04-18T03: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 v2.5.21
+Generated by Agentic-Senior-Core CLI v2.5.22
 Timestamp: 2026-04-18T03:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -54,6 +54,13 @@ Optional trusted realtime enrichment (explicitly gated):
 npx @ryuenn3123/agentic-senior-core init --project-description "Modern conversion-focused product website" --architect-research-mode realtime --enable-realtime-research --architect-realtime-signal-file ./realtime-signals.json
 ```
 
+AI-first project context bootstrap (no static docs template rendering):
+
+- Init now generates bootstrap prompts under `.agent-context/prompts/`.
+- On first IDE chat, execute `bootstrap-project-context.md` when `docs/project-brief.md` is missing.
+- For UI-first projects, execute `bootstrap-design.md` when `docs/DESIGN.md` is missing.
+- The assistant should synthesize docs from scratch into `docs/` and treat them as living context.
+
 ---
 
 ## Before / After

package/lib/cli/commands/init.mjs

@@ -1171,15 +1171,24 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
             additionalBlueprintFileNames: selectedAdditionalBlueprintFileNames,
             runtimeEnvironmentKey: selectedRuntimeEnvironmentKey,
             runtimeEnvironmentLabel: resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey),
+            architectureRecommendation,
           },
           {
             docsLanguage: selectedDocsLanguage,
           }
         );
 
-        console.log(`\nProject documentation generated in docs/:`);
-        for (const generatedFileName of scaffoldingResult.generatedFileNames) {
-          console.log(`  - docs/${generatedFileName}`);
+        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}`);
+          }
+          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}`);
+          }
         }
       }
     }
@@ -1272,7 +1281,11 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log(`- Blocking severities: ${formatBlockingSeverities(selectedProfile.blockingSeverities)}`);
     console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
     console.log('- Generated files: .cursorrules, .windsurfrules, and .agent-context/state/onboarding-report.json');
-    if (scaffoldingResult) {
+    if (scaffoldingResult?.bootstrapMode === 'ai-synthesis') {
+      console.log(`- Bootstrap prompts: ${(scaffoldingResult.generatedPromptFileNames || []).length} files generated in .agent-context/prompts/`);
+      console.log(`- Bootstrap docs language: ${scaffoldingResult.docsLanguage}`);
+      console.log(`- Expected project docs after synthesis: ${scaffoldingResult.generatedFileNames.length} files in docs/`);
+    } else if (scaffoldingResult) {
       console.log(`- Project docs: ${scaffoldingResult.generatedFileNames.length} files generated in docs/`);
       console.log(`- Project docs language: ${scaffoldingResult.docsLanguage}`);
     }
@@ -1296,7 +1309,18 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     if (selectedAdditionalBlueprintFileNames.length > 0) {
       console.log(`I also included additional blueprint context for ${selectedAdditionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ')}.`);
     }
-    if (scaffoldingResult) {
+    if (scaffoldingResult?.bootstrapMode === 'ai-synthesis') {
+      console.log(`I prepared dynamic synthesis bootstrap prompts (${scaffoldingResult.docsLanguage}) so your IDE assistant can author project docs from scratch on first chat.`);
+
+      const promptProjectName = scaffoldingResult.discoveryAnswers?.projectName || 'this project';
+      console.log('\nPrompt starter examples (copy and adapt in your IDE):');
+      console.log('- If docs/project-brief.md is missing, execute .agent-context/prompts/bootstrap-project-context.md now and create all required docs files.');
+      if ((scaffoldingResult.generatedPromptFileNames || []).includes('bootstrap-design.md')) {
+        console.log('- If docs/DESIGN.md is missing, execute .agent-context/prompts/bootstrap-design.md now before building UI components.');
+      }
+      console.log(`- Build an MVP for ${promptProjectName} using the newly synthesized docs as strict project context.`);
+      console.log('- When scope changes, update docs/* in the same change so future prompts stay aligned.');
+    } else if (scaffoldingResult) {
       console.log(`I also generated project documentation (${scaffoldingResult.docsLanguage}) based on your project description. AI agents will use docs/ as project context.`);
 
       const promptProjectName = scaffoldingResult.discoveryAnswers?.projectName || 'this project';

package/lib/cli/compiler.mjs

@@ -332,6 +332,21 @@ export async function buildCompiledRulesContent({
   );
 
   const projectBriefPath = path.join(resolvedTargetDirectoryPath, 'docs', 'project-brief.md');
+  const bootstrapProjectContextPromptPath = path.join(
+    resolvedTargetDirectoryPath,
+    '.agent-context',
+    'prompts',
+    'bootstrap-project-context.md'
+  );
+  const bootstrapDesignPromptPath = path.join(
+    resolvedTargetDirectoryPath,
+    '.agent-context',
+    'prompts',
+    'bootstrap-design.md'
+  );
+  const hasBootstrapProjectContextPrompt = await pathExists(bootstrapProjectContextPromptPath);
+  const hasBootstrapDesignPrompt = await pathExists(bootstrapDesignPromptPath);
+
   if (await pathExists(projectBriefPath)) {
     const projectDocsEntries = ['project-brief.md'];
     const candidateDocFileNames = [
@@ -365,6 +380,32 @@ export async function buildCompiledRulesContent({
         'Update them as the project evolves. They are living references, not frozen specs.',
       ].join('\n')
     );
+  } else if (hasBootstrapProjectContextPrompt) {
+    const bootstrapPromptEntries = [
+      '.agent-context/prompts/bootstrap-project-context.md',
+    ];
+
+    if (hasBootstrapDesignPrompt) {
+      bootstrapPromptEntries.push('.agent-context/prompts/bootstrap-design.md');
+    }
+
+    contextBlocks.push(
+      [
+        '## LAYER 9: PROJECT CONTEXT (MANDATORY)',
+        'Project docs are not materialized yet. Bootstrap them before writing application code.',
+        'Execute these prompts in your IDE assistant first:',
+        ...bootstrapPromptEntries.map((promptFilePath, promptIndex) => `${promptIndex + 1}. ${promptFilePath}`),
+        '',
+        'Bootstrap policy:',
+        '- 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.',
+        '- 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.',
+      ].join('\n')
+    );
   }
 
   return [

package/lib/cli/project-scaffolder.mjs

@@ -23,6 +23,7 @@ const PROJECT_DOC_FILE_NAMES = [
 ];
 
 export const PROJECT_DOC_TEMPLATE_VERSION = '1.2.0';
+export const PROJECT_DOC_SYNTHESIS_PROMPT_VERSION = '2.0.0';
 
 const DOMAIN_CHOICES = [
   'API service',
@@ -597,8 +598,173 @@ export function renderTemplate(templateContent, templateContext) {
   return renderedContent;
 }
 
+function shouldBootstrapDesignDocument(discoveryAnswers, initContext) {
+  const normalizedDomain = String(discoveryAnswers.primaryDomain || '').trim().toLowerCase();
+  const normalizedBlueprint = String(initContext.blueprintFileName || '').trim().toLowerCase();
+
+  const isUiDomain = normalizedDomain.includes('web')
+    || normalizedDomain.includes('mobile')
+    || normalizedDomain.includes('frontend')
+    || normalizedDomain.includes('ui');
+
+  const isBackendOnlyDomain = normalizedDomain.includes('api service')
+    || normalizedDomain.includes('cli tool')
+    || normalizedDomain.includes('library');
+
+  const blueprintLooksUi = normalizedBlueprint.includes('frontend')
+    || normalizedBlueprint.includes('landing')
+    || normalizedBlueprint.includes('ui');
+
+  if (isUiDomain) {
+    return true;
+  }
+
+  if (!isBackendOnlyDomain && blueprintLooksUi) {
+    return true;
+  }
+
+  return false;
+}
+
+function buildProjectContextBootstrapPrompt({
+  discoveryAnswers,
+  initContext,
+  expectedDocFileNames,
+  docsLanguage,
+  architectureRecommendation,
+}) {
+  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)';
+
+  const expectedDocsList = expectedDocFileNames
+    .map((fileName, fileIndex) => `${fileIndex + 1}. docs/${fileName}`)
+    .join('\n');
+
+  const architectureSnapshot = architectureRecommendation
+    ? JSON.stringify({
+      stack: architectureRecommendation.recommendedStackFileName,
+      blueprint: architectureRecommendation.recommendedBlueprintFileName,
+      confidenceLabel: architectureRecommendation.confidenceLabel,
+      confidenceScore: architectureRecommendation.confidenceScore,
+      research: architectureRecommendation.research,
+      evidenceCitations: architectureRecommendation.evidenceCitations,
+      designGuidance: architectureRecommendation.designGuidance,
+    }, null, 2)
+    : 'null';
+
+  return [
+    '# Bootstrap Prompt: Dynamic Project Context Synthesis',
+    '',
+    `Protocol version: ${PROJECT_DOC_SYNTHESIS_PROMPT_VERSION}`,
+    '',
+    'You are a Lead Solution Architect and Principal Engineer.',
+    'Write project context docs from scratch (no template rendering, no placeholder boilerplate).',
+    '',
+    '## Mission',
+    `Create or update these files in ${docsLanguage.toUpperCase()} language:`,
+    expectedDocsList,
+    '',
+    '## Hard Rules',
+    '1. No copy-paste from external prose.',
+    '2. Every major section must explain rationale and tradeoffs.',
+    '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.',
+    '',
+    '## Project Inputs',
+    `- Project name: ${discoveryAnswers.projectName}`,
+    `- Project description: ${discoveryAnswers.projectDescription}`,
+    `- Primary domain: ${discoveryAnswers.primaryDomain}`,
+    `- Database strategy: ${discoveryAnswers.databaseChoice}`,
+    `- Auth strategy: ${discoveryAnswers.authStrategy}`,
+    `- Docker strategy: ${discoveryAnswers.dockerStrategy}`,
+    `- Runtime environment: ${initContext.runtimeEnvironmentLabel || initContext.runtimeEnvironmentKey || 'Linux'}`,
+    `- Selected stack: ${toTitleCase(initContext.stackFileName)}`,
+    `- Selected blueprint: ${toTitleCase(initContext.blueprintFileName)}`,
+    `- Additional stacks: ${Array.isArray(initContext.additionalStackFileNames) && initContext.additionalStackFileNames.length > 0 ? initContext.additionalStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ') : 'none'}`,
+    `- Additional blueprints: ${Array.isArray(initContext.additionalBlueprintFileNames) && initContext.additionalBlueprintFileNames.length > 0 ? initContext.additionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ') : 'none'}`,
+    '',
+    '## Key Features',
+    featuresList,
+    '',
+    '## Additional Context',
+    discoveryAnswers.additionalContext || 'No additional context provided.',
+    '',
+    '## Architect Engine Snapshot (for grounding)',
+    '```json',
+    architectureSnapshot,
+    '```',
+    '',
+    '## 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.',
+    '',
+  ].join('\n');
+}
+
+function buildDesignBootstrapPrompt({
+  discoveryAnswers,
+  initContext,
+  docsLanguage,
+  architectureRecommendation,
+}) {
+  const designSignals = architectureRecommendation?.designGuidance?.normalizedSignals || null;
+  const designSignalsJson = JSON.stringify(designSignals, null, 2);
+
+  return [
+    '# Bootstrap Prompt: Dynamic DESIGN.md Synthesis',
+    '',
+    `Protocol version: ${PROJECT_DOC_SYNTHESIS_PROMPT_VERSION}`,
+    '',
+    'You are the Lead UI/UX Art Director for this project.',
+    'Write docs/DESIGN.md from zero. Do not use generic template prose.',
+    '',
+    '## Mission',
+    `Author docs/DESIGN.md in ${docsLanguage.toUpperCase()} language with strong art direction and engineering-ready guidance.`,
+    '',
+    '## Required Sections',
+    '1. Design Vision and Product Personality',
+    '2. Theme and Atmosphere Direction',
+    '3. Color System (tokens, semantic roles, accessibility rationale)',
+    '4. Typography System (pairing, scale, usage rules)',
+    '5. Spacing and Layout Rhythm',
+    '6. Motion and Interaction Principles',
+    '7. Component Language (cards, forms, nav, states)',
+    '8. Do and Don\'t Rules',
+    '9. Accessibility Non-Negotiables',
+    '10. Redesign Protocol (how to evolve without breaking design identity)',
+    '',
+    '## Hard Rules',
+    '1. No copy-paste from external style guides.',
+    '2. Every major decision must include psychological/product rationale.',
+    '3. Keep implementation feasible for the selected stack and blueprint.',
+    '4. Keep tone decisive like an art director, not generic AI boilerplate.',
+    '',
+    '## Project Inputs',
+    `- Project name: ${discoveryAnswers.projectName}`,
+    `- Product context: ${discoveryAnswers.projectDescription}`,
+    `- Domain: ${discoveryAnswers.primaryDomain}`,
+    `- 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',
+    '```',
+    '',
+    '## Required Execution',
+    '1. Create docs/DESIGN.md with complete content.',
+    '2. Ensure rules are practical for implementation and review.',
+    '3. After DESIGN.md exists, use it as first-class source for future UI tasks.',
+    '',
+  ].join('\n');
+}
+
 /**
- * Generate project documentation files from templates.
+ * Generate AI-first bootstrap prompts for dynamic project documentation synthesis.
+ * Legacy template rendering utilities are retained for backward compatibility checks.
  */
 export async function generateProjectDocumentation(
   targetDirectoryPath,
@@ -612,34 +778,52 @@ export async function generateProjectDocumentation(
   }
 
   const docsDirectoryPath = path.join(targetDirectoryPath, 'docs');
-  await ensureDirectory(docsDirectoryPath);
+  const promptsDirectoryPath = path.join(targetDirectoryPath, '.agent-context', 'prompts');
+  await ensureDirectory(promptsDirectoryPath);
 
   const templateContext = buildTemplateContext(discoveryAnswers, initContext);
   const { documentManifest } = resolveDocumentManifest(discoveryAnswers);
-  const generatedFileNames = [];
+  const expectedDocFileNames = documentManifest.map((documentEntry) => documentEntry.outputFileName);
+  const generatedPromptFileNames = [];
 
-  for (const documentEntry of documentManifest) {
-    const templateFilePath = await resolveTemplateFilePath(
-      documentEntry.templateFileName,
-      normalizedDocsLanguage
-    );
+  const projectContextPromptFileName = 'bootstrap-project-context.md';
+  const architectureRecommendation = initContext.architectureRecommendation || null;
+  const projectContextPromptContent = buildProjectContextBootstrapPrompt({
+    discoveryAnswers,
+    initContext: templateContext,
+    expectedDocFileNames,
+    docsLanguage: normalizedDocsLanguage,
+    architectureRecommendation,
+  });
+  await fs.writeFile(
+    path.join(promptsDirectoryPath, projectContextPromptFileName),
+    projectContextPromptContent,
+    'utf8'
+  );
+  generatedPromptFileNames.push(projectContextPromptFileName);
+
+  if (shouldBootstrapDesignDocument(discoveryAnswers, initContext)) {
+    const designPromptFileName = 'bootstrap-design.md';
+    const designPromptContent = buildDesignBootstrapPrompt({
+      discoveryAnswers,
+      initContext: templateContext,
+      docsLanguage: normalizedDocsLanguage,
+      architectureRecommendation,
+    });
+    await fs.writeFile(path.join(promptsDirectoryPath, designPromptFileName), designPromptContent, 'utf8');
+    generatedPromptFileNames.push(designPromptFileName);
 
-    if (!templateFilePath) {
-      console.log(`[WARN] Template not found: ${documentEntry.templateFileName}, skipping.`);
-      continue;
+    if (!expectedDocFileNames.includes('DESIGN.md')) {
+      expectedDocFileNames.push('DESIGN.md');
     }
-
-    const templateContent = await fs.readFile(templateFilePath, 'utf8');
-    const renderedContent = renderTemplate(templateContent, templateContext);
-    const outputFilePath = path.join(docsDirectoryPath, documentEntry.outputFileName);
-
-    await fs.writeFile(outputFilePath, renderedContent, 'utf8');
-    generatedFileNames.push(documentEntry.outputFileName);
   }
 
   return {
     docsDirectoryPath,
-    generatedFileNames,
+    generatedFileNames: expectedDocFileNames,
+    generatedPromptFileNames,
+    bootstrapMode: 'ai-synthesis',
+    synthesisPromptVersion: PROJECT_DOC_SYNTHESIS_PROMPT_VERSION,
     templateVersion: PROJECT_DOC_TEMPLATE_VERSION,
     docsLanguage: normalizedDocsLanguage,
     discoveryAnswers,

package/lib/cli/utils.mjs

@@ -63,7 +63,7 @@ export function printUsage() {
   console.log('  --no-mcp-template Disable automatic MCP configuration across your IDEs');
   console.log('  --scaffold-docs  Force project documentation scaffolding (architecture, database, API, flow)');
   console.log('  --no-scaffold-docs  Skip project documentation scaffolding');
-  console.log('  --docs-lang      Optional override for generated project docs language (default: en)');
+  console.log('  --docs-lang      Optional override for bootstrap docs synthesis language (default: en)');
   console.log('  --project-config Path to a project config file for non-interactive doc scaffolding');
   console.log('  --runtime-env   Override runtime environment hint (auto, linux-wsl, linux, windows, macos)');
   console.log('  --dry-run    Preview upgrade without writing files');

package/package.json

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