@ryuenn3123/agentic-senior-core 2.0.17 → 2.0.18

package/README.md

@@ -281,6 +281,18 @@ For CI pipelines that only need stdout JSON:
 node ./scripts/benchmark-writer-judge-matrix.mjs --stdout-only
 ```
 
+### Benchmark Quickstart Path (V2.5)
+
+For new users, run this minimal sequence first:
+
+```bash
+npm run benchmark:detection
+npm run benchmark:writer-judge
+npm run benchmark:bundle
+```
+
+This gives a fast baseline of accuracy, writer-judge comparison, and evidence packaging in one pass.
+
 ### Install and Setup Choices
 
 The CLI now supports a smaller decision surface for first-time setup:
@@ -357,7 +369,7 @@ Our documentation has shifted into dedicated tracks to keep this README light:
 
 - **Delivery Engine (CLI):** Interactive setup via GitHub source, bootstrap scripts, or `npx` after publish. Supported by a robust transactional installer with rollback protection.
 - **Verified Skill Marketplace:** Distribute and validate plugins securely with automated 4-dimension Trust Scoring and Evidence Bundles constraint validation.
-- **Dynamic Context Compiler:** Merges universal rules + selected stack + selected blueprint + optional CI guardrails into one dense, indexed rule file.
+- **Dynamic Context Compiler:** Builds a compact modular bootstrap index that points to all required governance layers before execution.
 - **Codebase Intelligence:** `.agent-context/state/` gives architecture/dependency boundaries so the agent understands high-risk areas.
 - **Override System:** `.agent-override.md` allows controlled enterprise exceptions without forking core rules.
 - **Automated Guardrails:** CI blueprints include LLM-as-a-Judge flow using `pr-checklist.md`.

package/lib/cli/compiler.mjs

@@ -18,7 +18,6 @@ import {
 
 import {
   inferSkillDomainNamesFromSelection,
-  buildSkillPackSection,
 } from './skill-selector.mjs';
 
 import {
@@ -102,51 +101,91 @@ 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 selectedStateDirectoryPath = path.join(resolvedTargetDirectoryPath, '.agent-context', 'state');
-  const selectedReviewDirectoryPath = path.join(resolvedTargetDirectoryPath, '.agent-context', 'review-checklists');
   const skillPlatformIndex = JSON.parse(await fs.readFile(SKILL_PLATFORM_INDEX_PATH, 'utf8'));
   const selectedSkillDomainNames = inferSkillDomainNamesFromSelection(selectedStackFileName, selectedBlueprintFileName);
 
   const universalRuleFileNames = await collectFileNames(selectedRulesDirectoryPath);
   const contextBlocks = [];
 
-  for (const universalRuleFileName of universalRuleFileNames) {
-    const universalRuleFilePath = path.join(selectedRulesDirectoryPath, universalRuleFileName);
-    const universalRuleContent = await fs.readFile(universalRuleFilePath, 'utf8');
+  function resolveSkillPackFileName(skillDomainEntry, selectedTierName) {
+    return skillDomainEntry.tierToPackFileNames?.[selectedTierName]
+      || skillDomainEntry.tierToPackFileNames?.[skillDomainEntry.defaultTier]
+      || skillDomainEntry.defaultPackFileName;
+  }
 
-    contextBlocks.push(
-      `## UNIVERSAL RULE: ${universalRuleFileName}\nSource: .agent-context/rules/${universalRuleFileName}\n\n${universalRuleContent.trim()}`
-    );
+  function firstMarkdownHeading(content, fallbackLabel) {
+    const headingLine = content
+      .split(/\r?\n/)
+      .find((line) => line.trim().startsWith('#'));
+
+    if (!headingLine) {
+      return fallbackLabel;
+    }
+
+    return headingLine.replace(/^#+\s*/, '').trim();
   }
 
+  contextBlocks.push(
+    [
+      '## BOOTSTRAP CHAIN (MANDATORY)',
+      'Load every layer before responding. Do not skip steps:',
+      '1. .agent-context/rules/',
+      '2. .agent-context/stacks/',
+      '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}`,
+      '',
+      'Primary entrypoint: .cursorrules',
+      'Mirror entrypoint: .windsurfrules',
+      'Canonical baseline: .instructions.md',
+    ].join('\n')
+  );
+
+  contextBlocks.push(
+    [
+      '## LAYER 1: UNIVERSAL RULES (MANDATORY)',
+      'Read every file under .agent-context/rules/ before implementation:',
+      ...universalRuleFileNames.map((universalRuleFileName, index) => `${index + 1}. .agent-context/rules/${universalRuleFileName}`),
+      '',
+      'Conflict resolution: prioritize data safety and API contract integrity first, then writing polish.',
+    ].join('\n')
+  );
+
   const stackFilePath = path.join(selectedStacksDirectoryPath, selectedStackFileName);
   const stackContent = await fs.readFile(stackFilePath, 'utf8');
+  const stackSummary = firstMarkdownHeading(stackContent, selectedStackFileName);
   contextBlocks.push(
-    `## STACK PROFILE: ${selectedStackFileName}\nSource: .agent-context/stacks/${selectedStackFileName}\n\n${stackContent.trim()}`
+    [
+      `## LAYER 2: STACK PROFILE (${selectedStackFileName})`,
+      `Source: .agent-context/stacks/${selectedStackFileName}`,
+      `Summary: ${stackSummary}`,
+      'Load this stack profile to enforce language-specific conventions.',
+    ].join('\n')
   );
 
   const blueprintFilePath = path.join(selectedBlueprintsDirectoryPath, selectedBlueprintFileName);
   const blueprintContent = await fs.readFile(blueprintFilePath, 'utf8');
+  const blueprintSummary = firstMarkdownHeading(blueprintContent, selectedBlueprintFileName);
   contextBlocks.push(
-    `## BLUEPRINT PROFILE: ${selectedBlueprintFileName}\nSource: .agent-context/blueprints/${selectedBlueprintFileName}\n\n${blueprintContent.trim()}`
+    [
+      `## LAYER 3: BLUEPRINT PROFILE (${selectedBlueprintFileName})`,
+      `Source: .agent-context/blueprints/${selectedBlueprintFileName}`,
+      `Summary: ${blueprintSummary}`,
+      'Load this blueprint when scaffolding or changing architecture boundaries.',
+    ].join('\n')
   );
 
   if (includeCiGuardrails) {
-    const githubCiBlueprintContent = await fs.readFile(path.join(selectedBlueprintsDirectoryPath, 'ci-github-actions.md'), 'utf8');
-    const gitlabCiBlueprintContent = await fs.readFile(path.join(selectedBlueprintsDirectoryPath, 'ci-gitlab.md'), 'utf8');
-
-    contextBlocks.push(
-      `## CI/CD GUARDRAILS: ci-github-actions.md\nSource: .agent-context/blueprints/ci-github-actions.md\n\n${githubCiBlueprintContent.trim()}`
-    );
-    contextBlocks.push(
-      `## CI/CD GUARDRAILS: ci-gitlab.md\nSource: .agent-context/blueprints/ci-gitlab.md\n\n${gitlabCiBlueprintContent.trim()}`
-    );
-  }
-
-  const tokenOptimizationState = await readTokenOptimizationState(resolvedTargetDirectoryPath);
-  if (tokenOptimizationState?.enabled) {
     contextBlocks.push(
-      `## TOKEN OPTIMIZATION PROFILE\nSource: .agent-context/state/token-optimization.json\n\n${buildTokenOptimizationGuidanceBlock(tokenOptimizationState).trim()}`
+      [
+        '## 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',
+      ].join('\n')
     );
   }
 
@@ -156,21 +195,45 @@ export async function buildCompiledRulesContent({
       continue;
     }
 
-    contextBlocks.push(await buildSkillPackSection(skillDomainEntry, skillPlatformIndex.defaultTier || 'advance'));
-  }
+    const selectedTierName = skillPlatformIndex.defaultTier || 'advance';
+    const resolvedPackFileName = resolveSkillPackFileName(skillDomainEntry, selectedTierName);
 
-  const architectureMapContent = await fs.readFile(path.join(selectedStateDirectoryPath, 'architecture-map.md'), 'utf8');
-  const dependencyMapContent = await fs.readFile(path.join(selectedStateDirectoryPath, 'dependency-map.md'), 'utf8');
-  const prChecklistContent = await fs.readFile(path.join(selectedReviewDirectoryPath, 'pr-checklist.md'), 'utf8');
+    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.',
+      ].join('\n')
+    );
+  }
 
+  const tokenOptimizationState = await readTokenOptimizationState(resolvedTargetDirectoryPath);
+  if (tokenOptimizationState?.enabled) {
+    contextBlocks.push(
+      `## TOKEN OPTIMIZATION PROFILE\nSource: .agent-context/state/token-optimization.json\n\n${buildTokenOptimizationGuidanceBlock(tokenOptimizationState).trim()}`
+    );
+  }
   contextBlocks.push(
-    `## STATE MAP: architecture-map.md\nSource: .agent-context/state/architecture-map.md\n\n${architectureMapContent.trim()}`
-  );
-  contextBlocks.push(
-    `## STATE MAP: dependency-map.md\nSource: .agent-context/state/dependency-map.md\n\n${dependencyMapContent.trim()}`
+    [
+      '## LAYER 7: STATE AWARENESS (MANDATORY)',
+      'Load these files before touching critical paths:',
+      '1. .agent-context/state/architecture-map.md',
+      '2. .agent-context/state/dependency-map.md',
+      'Use these maps to prevent unsafe cross-module changes.',
+    ].join('\n')
   );
   contextBlocks.push(
-    `## REVIEW CHECKLIST: pr-checklist.md\nSource: .agent-context/review-checklists/pr-checklist.md\n\n${prChecklistContent.trim()}`
+    [
+      '## 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)',
+      'Do not claim done before checklist pass.',
+    ].join('\n')
   );
 
   return [

package/package.json

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

package/scripts/validate.mjs

@@ -58,6 +58,7 @@ const REQUIRED_HUMAN_WRITING_SNIPPETS = [
     snippets: [
       '## Human Writing Standard (Mandatory)',
       'This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations.',
+      'Style baseline findings are advisory by default and must not block endpoint-change commits that already include accurate docs/spec updates.',
       'No emoji in formal artifacts.',
     ],
   },
@@ -65,6 +66,7 @@ const REQUIRED_HUMAN_WRITING_SNIPPETS = [
     path: '.agent-context/review-checklists/pr-checklist.md',
     snippets: [
       'Scope applied: This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations',
+      'Style scope review is advisory and does not block merge when API docs are synced in the same commit and contract details are correct',
       'No emoji in formal documentation or review summaries',
       'Documentation uses plain English and avoids AI cliches',
     ],