@ryuenn3123/agentic-senior-core 3.0.46 → 3.0.48

package/scripts/single-source-lazy-loading-audit.mjs

@@ -11,7 +11,6 @@
 
 import { existsSync, readFileSync } from 'node:fs';
 import { execFileSync } from 'node:child_process';
-import { createHash } from 'node:crypto';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -19,28 +18,16 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const REPOSITORY_ROOT = resolve(__dirname, '..');
 
-const CANONICAL_SOURCE_PATH = '.instructions.md';
+const CANONICAL_SOURCE_PATH = 'AGENTS.md';
 const ADAPTER_PATHS = [
-  'AGENTS.md',
   'CLAUDE.md',
   'GEMINI.md',
-  '.github/copilot-instructions.md',
-  '.github/instructions/agentic-senior-core.instructions.md',
-  '.gemini/instructions.md',
-  '.cursor/rules/agentic-senior-core.mdc',
-  '.windsurf/rules/agentic-senior-core.md',
 ];
 const COMPILER_PATH = 'lib/cli/compiler.mjs';
 const ONBOARDING_REPORT_PATH = '.agent-context/state/onboarding-report.json';
 const ARCHITECTURE_RULE_PATH = '.agent-context/rules/architecture.md';
 const PR_CHECKLIST_PATH = '.agent-context/review-checklists/pr-checklist.md';
 const REVIEW_PROMPT_PATH = '.agent-context/prompts/review-code.md';
-const COMPILED_RULE_PATHS = ['.cursorrules', '.windsurfrules'];
-const REQUIRED_LEGACY_ROOT_ADAPTER_SNIPPETS = [
-  'Adapter Mode: legacy-thin',
-  'Adapter Source: .agent-instructions.md',
-  'Canonical baseline: .instructions.md',
-];
 
 const DEFAULT_WORKFLOW = 'standard';
 const SUPPORTED_WORKFLOWS = new Set([
@@ -69,7 +56,7 @@ const MAX_EAGER_STACK_MENTIONS = 4;
 
 const REQUIRED_ARCHITECTURE_RULE_SNIPPETS = [
   '## Single Source of Truth and Lazy Rule Loading',
-  'Canonical rule source is .instructions.md.',
+  'Canonical rule source is AGENTS.md.',
   'Load global domain rules lazily based on touched scope.',
   'Do not create or load stack-specific governance adapters as the baseline.',
 ];
@@ -273,11 +260,8 @@ function runAudit() {
     pushResult(results, true, 'canonical-source-exists', `${CANONICAL_SOURCE_PATH} is present`);
   }
 
-  const canonicalHash = canonicalSourceExists
-    ? createHash('sha256').update(normalizeLineEndings(canonicalSourceContent)).digest('hex')
-    : '';
-
-  let adapterHashPassCount = 0;
+  const canonicalHash = canonicalSourceExists ? 'native-import-bridges' : '';
+  let adapterImportPassCount = 0;
   const adapterChecks = [];
 
   for (const adapterPath of ADAPTER_PATHS) {
@@ -289,51 +273,27 @@ function runAudit() {
       adapterChecks.push({
         path: adapterPath,
         exists: false,
-        thinAdapterMode: false,
-        sourcePointerValid: false,
-        hashMatchesCanonical: false,
+        importsCanonical: false,
       });
       continue;
     }
 
     pushResult(results, true, 'adapter-file-exists', `${adapterPath} is present`);
 
-    const thinAdapterMode = adapterContent.includes('Adapter Mode: thin');
-    const sourcePointerValid = adapterContent.includes('Adapter Source: .instructions.md');
-    const hashMatch = adapterContent.match(/Canonical Snapshot SHA256:\s*([a-f0-9]{64})/);
-    const hashMatchesCanonical = Boolean(hashMatch && canonicalHash && hashMatch[1] === canonicalHash);
-
-    if (!thinAdapterMode) {
-      failures.push(`${adapterPath} must stay in thin adapter mode`);
-      pushResult(results, false, 'adapter-thin-mode', `${adapterPath} is missing Adapter Mode: thin metadata`);
-    } else {
-      pushResult(results, true, 'adapter-thin-mode', `${adapterPath} declares thin adapter mode`);
-    }
-
-    if (!sourcePointerValid) {
-      failures.push(`${adapterPath} must point to canonical source .instructions.md`);
-      pushResult(results, false, 'adapter-canonical-source-pointer', `${adapterPath} is missing canonical source pointer`);
-    } else {
-      pushResult(results, true, 'adapter-canonical-source-pointer', `${adapterPath} points to canonical source`);
-    }
+    const importsCanonical = normalizeLineEndings(adapterContent).trim() === '@AGENTS.md';
 
-    if (!hashMatch) {
-      failures.push(`${adapterPath} must declare Canonical Snapshot SHA256`);
-      pushResult(results, false, 'adapter-canonical-hash', `${adapterPath} is missing Canonical Snapshot SHA256 metadata`);
-    } else if (!hashMatchesCanonical) {
-      failures.push(`${adapterPath} canonical hash drift detected`);
-      pushResult(results, false, 'adapter-canonical-hash', `${adapterPath} hash does not match ${CANONICAL_SOURCE_PATH}`);
+    if (!importsCanonical) {
+      failures.push(`${adapterPath} must import canonical AGENTS.md`);
+      pushResult(results, false, 'adapter-canonical-import', `${adapterPath} is not @AGENTS.md`);
     } else {
-      adapterHashPassCount += 1;
-      pushResult(results, true, 'adapter-canonical-hash', `${adapterPath} hash matches canonical source`);
+      adapterImportPassCount += 1;
+      pushResult(results, true, 'adapter-canonical-import', `${adapterPath} imports AGENTS.md`);
     }
 
     adapterChecks.push({
       path: adapterPath,
       exists: true,
-      thinAdapterMode,
-      sourcePointerValid,
-      hashMatchesCanonical,
+      importsCanonical,
     });
   }
 
@@ -409,84 +369,11 @@ function runAudit() {
     }
   }
 
-  let compiledRulesCanonicalPassCount = 0;
   let eagerLoadingDetected = false;
   const compiledRuleChecks = [];
 
-  for (const compiledRulePath of COMPILED_RULE_PATHS) {
-    const compiledRuleContent = readText(compiledRulePath);
-
-    if (!compiledRuleContent) {
-      failures.push(`Missing compiled rules file: ${compiledRulePath}`);
-      pushResult(results, false, 'compiled-rules-file-exists', `Missing ${compiledRulePath}`);
-      compiledRuleChecks.push({
-        path: compiledRulePath,
-        exists: false,
-        canonicalBaselineDeclared: false,
-        stackMentionCount: 0,
-        eagerLoadingDetected: false,
-      });
-      continue;
-    }
-
-    pushResult(results, true, 'compiled-rules-file-exists', `${compiledRulePath} is present`);
-
-    const canonicalBaselineDeclared = compiledRuleContent.includes('Canonical baseline: .instructions.md');
-    if (canonicalBaselineDeclared) {
-      compiledRulesCanonicalPassCount += 1;
-      pushResult(results, true, 'compiled-rules-canonical-baseline', `${compiledRulePath} declares canonical baseline`);
-    } else {
-      failures.push(`${compiledRulePath} must declare canonical baseline ${CANONICAL_SOURCE_PATH}`);
-      pushResult(results, false, 'compiled-rules-canonical-baseline', `${compiledRulePath} is missing canonical baseline declaration`);
-    }
-
-    const stackMentionCount = countStackMentions(compiledRuleContent);
-    const isEagerLoading = stackMentionCount > MAX_EAGER_STACK_MENTIONS;
-    const missingLegacyAdapterSnippets = REQUIRED_LEGACY_ROOT_ADAPTER_SNIPPETS
-      .filter((requiredSnippet) => !compiledRuleContent.includes(requiredSnippet));
-
-    if (missingLegacyAdapterSnippets.length > 0) {
-      failures.push(`${compiledRulePath} must stay a legacy thin adapter`);
-      pushResult(
-        results,
-        false,
-        'legacy-root-adapter-thin-mode',
-        `${compiledRulePath} is missing: ${missingLegacyAdapterSnippets.join(', ')}`
-      );
-    } else {
-      pushResult(results, true, 'legacy-root-adapter-thin-mode', `${compiledRulePath} stays legacy-thin`);
-    }
-
-    if (isEagerLoading) {
-      eagerLoadingDetected = true;
-      failures.push(`${compiledRulePath} appears to preload too many stack profiles (${stackMentionCount})`);
-      pushResult(
-        results,
-        false,
-        'compiled-rules-lazy-loading-density',
-        `${compiledRulePath} has ${stackMentionCount} stack profile mentions; expected <= ${MAX_EAGER_STACK_MENTIONS}`
-      );
-    } else {
-      pushResult(
-        results,
-        true,
-        'compiled-rules-lazy-loading-density',
-        `${compiledRulePath} has ${stackMentionCount} stack profile mentions (lazy-loading threshold satisfied)`
-      );
-    }
-
-    compiledRuleChecks.push({
-      path: compiledRulePath,
-      exists: true,
-      canonicalBaselineDeclared,
-      stackMentionCount,
-      eagerLoadingDetected: isEagerLoading,
-    });
-  }
-
   const canonicalSourceEnforced = canonicalSourceExists
-    && adapterHashPassCount === ADAPTER_PATHS.length
-    && compiledRulesCanonicalPassCount === COMPILED_RULE_PATHS.length
+    && adapterImportPassCount === ADAPTER_PATHS.length
     && architectureCoverageComplete
     && checklistCoverageComplete
     && reviewPromptCoverageComplete;

package/scripts/sync-thin-adapters.mjs

@@ -3,154 +3,47 @@
 /**
  * sync-thin-adapters.mjs
  *
- * Regenerates thin instruction adapters from the canonical policy source
- * and keeps canonical hash metadata synchronized.
+ * Regenerates minimal native-tool import bridges from canonical AGENTS.md.
  *
  * Usage:
  * - node scripts/sync-thin-adapters.mjs
  * - node scripts/sync-thin-adapters.mjs --check
  */
 
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { createHash } from 'node:crypto';
-import { dirname, join, posix, resolve } from 'node:path';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
 const ROOT_DIR = resolve(dirname(SCRIPT_FILE_PATH), '..');
-const CANONICAL_SOURCE_PATH = '.instructions.md';
-const CANONICAL_SOURCE_ABSOLUTE_PATH = join(ROOT_DIR, CANONICAL_SOURCE_PATH);
 const IS_CHECK_MODE = process.argv.includes('--check');
 
-function normalizeLineEndings(content) {
-  return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-}
-
-function buildAdapterLink(adapterRelativePath, targetRelativePath) {
-  const adapterDirectoryPath = posix.dirname(adapterRelativePath);
-  const relativePath = posix.relative(adapterDirectoryPath === '.' ? '' : adapterDirectoryPath, targetRelativePath);
-  return relativePath.startsWith('.') ? relativePath : `./${relativePath}`;
-}
-
-function buildThinAdapter({
-  relativePath,
-  title,
-  canonicalHash,
-  frontmatter = '',
-}) {
-  const canonicalLink = buildAdapterLink(relativePath, '.instructions.md');
-  const rulesLink = buildAdapterLink(relativePath, '.agent-context/rules');
-  const promptsLink = buildAdapterLink(relativePath, '.agent-context/prompts');
-  const designPromptLink = buildAdapterLink(relativePath, '.agent-context/prompts/bootstrap-design.md');
-  const frontendRuleLink = buildAdapterLink(relativePath, '.agent-context/rules/frontend-architecture.md');
-  const checklistLink = buildAdapterLink(relativePath, '.agent-context/review-checklists/pr-checklist.md');
-  const stateLink = buildAdapterLink(relativePath, '.agent-context/state');
-  const policiesLink = buildAdapterLink(relativePath, '.agent-context/policies');
-  const adapterHeader = frontmatter.trim() ? [frontmatter.trim(), ''] : [];
-
-  return [
-    ...adapterHeader,
-    `# ${title}`,
-    '',
-    'Adapter Mode: thin',
-    'Adapter Source: .instructions.md',
-    `Canonical Snapshot SHA256: ${canonicalHash}`,
-    '',
-    'This repository is governed by a strict instruction contract.',
-    `Use [${CANONICAL_SOURCE_PATH}](${canonicalLink}) as the canonical policy source.`,
-    'Use .agent-context/ for technical rules, prompts, checklists, policies, and state.',
-    'Treat README.md as public and developer overview, setup, usage, and user-facing context only when governance files conflict.',
-    '',
-    '## Critical Bootstrap Floor',
-    '',
-    '- If your host stops at this file, continue the chain manually before coding.',
-    '- Read `.agent-instructions.md` next when it exists.',
-    '- Memory continuity does not replace bootstrap loading.',
-    `- For UI, UX, layout, screen, tailwind, frontend, or redesign requests, load [bootstrap-design.md](${designPromptLink}) and [frontend-architecture.md](${frontendRuleLink}) before code edits.`,
-    '- For UI scope, include a one-line Motion/Palette Decision in the Bootstrap Receipt; product categories are heuristics, not style presets.',
-    '- For UI scope, create or refine `docs/DESIGN.md` and `docs/design-intent.json` before UI implementation.',
-    '- For documentation-first requests, create or refine required project docs in English by default and do not write application, firmware, or UI code until the user asks or approves.',
-    '- Create or refine root README.md as the public and developer entrypoint before implementation.',
-    `- For backend, API, data, auth, error, event, queue, worker, or distributed-system requests, load only relevant global rules from .agent-context/rules/ ([link](${rulesLink})).`,
-    '- For ecosystem, framework, dependency, or Docker claims, perform live web research.',
-    '- Resolve runtime choices from project evidence and live official documentation; resolve structural planning from constraints and architecture boundaries.',
-    '',
-    '## Mandatory Bootstrap Chain',
-    '',
-    `1. Load [${CANONICAL_SOURCE_PATH}](${canonicalLink}).`,
-    '2. Load `.agent-instructions.md` when present.',
-    `3. Load only relevant files from .agent-context/rules/ ([link](${rulesLink})).`,
-    `4. Apply matching prompts from .agent-context/prompts/ ([link](${promptsLink})).`,
-    `5. Enforce .agent-context/review-checklists/ ([link](${checklistLink})).`,
-    `6. Use .agent-context/state/ ([link](${stateLink})) and .agent-context/policies/ ([link](${policiesLink})) only when relevant.`,
-    '7. Use project docs and live evidence for runtime, dependency, and architecture claims.',
-    '',
-    '## Bootstrap Receipt',
-    '',
-    'For non-trivial coding, review, planning, or governance work, produce a short Bootstrap Receipt before implementation output: `loaded_files`, `selected_rules`, `skipped_rules`, `unreachable_files`, and `validation_plan`.',
-    '',
-    '## Completion Gate',
-    '',
-    `Run [pr-checklist.md](${checklistLink}) before declaring work complete.`,
-    '',
-    `If this adapter drifts from canonical behavior, refresh from [${CANONICAL_SOURCE_PATH}](${canonicalLink}) and update the hash metadata.`,
-  ].join('\n');
-}
-
 const ADAPTERS = [
-  {
-    relativePath: 'AGENTS.md',
-    title: 'AGENTS.md - Thin Adapter',
-  },
   {
     relativePath: 'CLAUDE.md',
-    title: 'CLAUDE.md - Thin Adapter',
+    content: '@AGENTS.md\n',
   },
   {
     relativePath: 'GEMINI.md',
-    title: 'GEMINI.md - Thin Adapter',
-  },
-  {
-    relativePath: '.github/copilot-instructions.md',
-    title: 'GitHub Copilot Instructions - Thin Adapter',
-  },
-  {
-    relativePath: '.github/instructions/agentic-senior-core.instructions.md',
-    title: 'GitHub Copilot Path Instructions - Thin Adapter',
-    frontmatter: '---\napplyTo: "**"\n---',
-  },
-  {
-    relativePath: '.gemini/instructions.md',
-    title: 'Gemini Instructions - Thin Adapter',
-  },
-  {
-    relativePath: '.cursor/rules/agentic-senior-core.mdc',
-    title: 'Cursor Rule - Thin Adapter',
-    frontmatter: '---\ndescription: Agentic Senior Core bootstrap adapter\nalwaysApply: true\n---',
-  },
-  {
-    relativePath: '.windsurf/rules/agentic-senior-core.md',
-    title: 'Windsurf Rule - Thin Adapter',
+    content: '@AGENTS.md\n',
   },
 ];
 
+function normalizeLineEndings(content) {
+  return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+
 async function main() {
-  const canonicalContent = normalizeLineEndings(await readFile(CANONICAL_SOURCE_ABSOLUTE_PATH, 'utf8'));
-  const canonicalHash = createHash('sha256').update(canonicalContent).digest('hex');
+  await readFile(join(ROOT_DIR, 'AGENTS.md'), 'utf8');
 
   let hasDrift = false;
 
   for (const adapter of ADAPTERS) {
     const adapterAbsolutePath = join(ROOT_DIR, adapter.relativePath);
-    const expectedContent = buildThinAdapter({
-      ...adapter,
-      canonicalHash,
-    });
 
     if (IS_CHECK_MODE) {
       const existingContent = normalizeLineEndings(await readFile(adapterAbsolutePath, 'utf8'));
-      const expectedNormalized = normalizeLineEndings(`${expectedContent.trimEnd()}\n`);
-      if (existingContent !== expectedNormalized) {
+      if (existingContent !== adapter.content) {
         hasDrift = true;
         console.error(`[DRIFT] ${adapter.relativePath} does not match canonical adapter output.`);
       } else {
@@ -159,8 +52,7 @@ async function main() {
       continue;
     }
 
-    await mkdir(dirname(adapterAbsolutePath), { recursive: true });
-    await writeFile(adapterAbsolutePath, `${expectedContent.trimEnd()}\n`, 'utf8');
+    await writeFile(adapterAbsolutePath, adapter.content, 'utf8');
     console.log(`[SYNC] ${adapter.relativePath}`);
   }
 
@@ -170,7 +62,7 @@ async function main() {
       return;
     }
 
-    console.log('[OK] All thin adapters match canonical source output.');
+    console.log('[OK] All native import bridges match canonical source output.');
   }
 }
 

package/scripts/validate/config.mjs

@@ -1,31 +1,22 @@
 export const ALLOWED_SEVERITIES = new Set(['critical', 'high', 'medium', 'low']);
-export const OVERRIDE_WARNING_WINDOW_DAYS = 30;
 export const THIN_ADAPTER_PATHS = [
-  'AGENTS.md',
   'CLAUDE.md',
   'GEMINI.md',
-  '.github/copilot-instructions.md',
-  '.github/instructions/agentic-senior-core.instructions.md',
-  '.gemini/instructions.md',
-  '.cursor/rules/agentic-senior-core.mdc',
-  '.windsurf/rules/agentic-senior-core.md',
 ];
 export const FORMAL_ARTIFACT_PATHS = [
-  '.instructions.md',
+  'AGENTS.md',
   'README.md',
   'CHANGELOG.md',
+  'docs/doc-index.md',
+  'docs/project-brief.md',
+  'docs/flow-overview.md',
+  'docs/api-contract.md',
   'docs/deep-analysis-and-roadmap-backlog.md',
   '.agent-context/rules/api-docs.md',
   '.agent-context/review-checklists/pr-checklist.md',
   '.agent-context/prompts/review-code.md',
-  'AGENTS.md',
   'CLAUDE.md',
   'GEMINI.md',
-  '.github/copilot-instructions.md',
-  '.github/instructions/agentic-senior-core.instructions.md',
-  '.gemini/instructions.md',
-  '.cursor/rules/agentic-senior-core.mdc',
-  '.windsurf/rules/agentic-senior-core.md',
 ];
 export const REQUIRED_HUMAN_WRITING_SNIPPETS = [
   {
@@ -102,7 +93,7 @@ export const REQUIRED_DEVELOPER_FIRST_MENTION_PATTERNS = [
   {
     path: 'lib/cli/commands/init.mjs',
     label: 'Init command wording includes project guidance pack',
-    pattern: /copy the project guidance pack[^\n]*compile a single rulebook/iu,
+    pattern: /copy the project guidance pack[^\n]*AGENTS\.md and native import bridges/iu,
   },
   {
     path: 'lib/cli/commands/upgrade.mjs',
@@ -157,7 +148,7 @@ export const REQUIRED_DETECTION_TRANSPARENCY_SNIPPETS = [
 ];
 export const REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS = [
   {
-    path: '.instructions.md',
+    path: 'AGENTS.md',
     snippets: [
       'Do not silently choose frameworks or architecture from offline heuristics.',
       'produce a short recommendation from evidence and live official documentation before coding',
@@ -192,10 +183,11 @@ export const REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS = [
 ];
 export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
   {
-    path: '.instructions.md',
+    path: 'AGENTS.md',
     snippets: [
       '### 1. Documentation-First Mode',
       'root `README.md` for every fresh or existing project',
+      'docs/doc-index.md',
       'Stop after documentation when the user only asked for docs.',
       'Do not write application, firmware, or UI code',
     ],
@@ -205,6 +197,7 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
     snippets: [
       '## Universal SOP Baseline (Mandatory)',
       'Root `README.md` must exist for every fresh or existing project',
+      '`docs/doc-index.md` must exist whenever `docs/` exists',
       'Security and testing are non-negotiable baseline requirements.',
       'If required project context docs are missing, stop implementation and bootstrap docs before writing application code.',
     ],
@@ -214,6 +207,7 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
     snippets: [
       '## Documentation-First Requests',
       'root `README.md` for every fresh or existing project',
+      '`docs/doc-index.md` whenever `docs/` exists',
       'Stop after docs when the user only asked for docs.',
       'Write formal project docs in English by default',
     ],
@@ -230,19 +224,20 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
   {
     path: '.agent-context/prompts/review-code.md',
     snippets: [
-      'Enforce Universal SOP hard gate: block coding flow when required project docs are missing (root `README.md`; `docs/architecture-decision-record.md`; and for UI scope `docs/DESIGN.md` plus `docs/design-intent.json`).',
+      'Enforce Universal SOP hard gate: block coding flow when required project docs are missing (root `README.md`; `docs/doc-index.md` when `docs/` exists; `docs/architecture-decision-record.md`; and for UI scope `docs/DESIGN.md` plus `docs/design-intent.json`).',
     ],
   },
   {
     path: '.agent-context/prompts/refactor.md',
     snippets: [
-      '6. Enforce Universal SOP hard gate: stop implementation if root `README.md` is missing, if `docs/architecture-decision-record.md` is missing, or for UI scope if `docs/DESIGN.md` or `docs/design-intent.json` is missing.',
+      '6. Enforce Universal SOP hard gate: stop implementation if root `README.md` is missing, if `docs/doc-index.md` is missing while `docs/` exists, if `docs/architecture-decision-record.md` is missing, or for UI scope if `docs/DESIGN.md` or `docs/design-intent.json` is missing.',
     ],
   },
   {
     path: 'lib/cli/compiler.mjs',
     snippets: [
       'Universal SOP hard block policy:',
+      'docs/doc-index.md whenever docs/ exists',
       'README.md must exist and read as a public and developer entrypoint',
       'Hard block: do not write application code until docs/project-brief.md and docs/architecture-decision-record.md exist.',
       'Documentation-first policy:',
@@ -294,14 +289,12 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
     path: 'AGENTS.md',
     snippets: [
-      'Critical Bootstrap Floor',
-      'If your host stops at this file',
+      'UI Design Mode',
       'bootstrap-design.md',
       'frontend-architecture.md',
       'docs/DESIGN.md',
       'docs/design-intent.json',
-      'does not replace bootstrap loading',
-      'documentation-first requests',
+      'Documentation-First Mode',
       'English by default',
       'do not write application, firmware, or UI code',
       'Motion/Palette Decision',
@@ -310,7 +303,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
     ],
   },
   {
-    path: '.instructions.md',
+    path: 'AGENTS.md',
     snippets: [
       'Resolve the smallest relevant layer set for the current request.',
       'UI Design Mode',
@@ -517,7 +510,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
 ];
 export const REQUIRED_DOCKER_RUNTIME_AUTOMATION_SNIPPETS = [
   {
-    path: '.instructions.md',
+    path: 'AGENTS.md',
     snippets: [
       'docker-runtime.md',
       'For Docker or Compose work, load `docker-runtime.md` and verify the latest official Docker docs before authoring container assets.',
@@ -545,7 +538,7 @@ export const REQUIRED_DOCKER_RUNTIME_AUTOMATION_SNIPPETS = [
 ];
 export const REQUIRED_DEPENDENCY_FRESHNESS_AUTOMATION_SNIPPETS = [
   {
-    path: '.instructions.md',
+    path: 'AGENTS.md',
     snippets: [
       'use the latest stable compatible dependency set and official setup flow',
     ],
@@ -579,7 +572,7 @@ export const FORBIDDEN_TEMPLATE_BOOTSTRAP_SNIPPETS = [
 ];
 export const FORBIDDEN_ACTIVE_BIAS_ANCHOR_SNIPPETS = [
   {
-    path: '.instructions.md',
+    path: 'AGENTS.md',
     snippets: [
       'illustrative, not exhaustive',
       'explicitly approved reference systems',

package/scripts/validate/coverage-checks.mjs

@@ -1,4 +1,3 @@
-import { createHash } from 'node:crypto';
 import { join, relative } from 'node:path';
 import {
   COMPLIANCE_ALIAS_TERMS,
@@ -383,7 +382,6 @@ export async function validateInstructionAdapters(context) {
   console.log('\nChecking instruction adapter consolidation...');
 
   const canonicalInstructionContent = normalizeLineEndings(await readTextFile(CANONICAL_INSTRUCTION_PATH));
-  const canonicalSnapshotHash = createHash('sha256').update(canonicalInstructionContent).digest('hex');
   const requiredBootstrapReceiptSnippets = [
     'Bootstrap Receipt',
     'loaded_files',
@@ -397,25 +395,24 @@ export async function validateInstructionAdapters(context) {
     'product categories are heuristics',
   ];
   const instructionFootprintLimits = [
-    { path: '.instructions.md', maxLines: 220 },
+    { path: 'AGENTS.md', maxLines: 180 },
     { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 180 },
     { path: '.agent-context/rules/frontend-architecture.md', maxLines: 110 },
   ];
-  const legacyRootAdapterPaths = ['.cursorrules', '.windsurfrules'];
 
   for (const requiredBootstrapReceiptSnippet of requiredBootstrapReceiptSnippets) {
     if (canonicalInstructionContent.includes(requiredBootstrapReceiptSnippet)) {
-      pass(`.instructions.md includes bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
+      pass(`AGENTS.md includes bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
     } else {
-      fail(`.instructions.md is missing bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
+      fail(`AGENTS.md is missing bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
     }
   }
 
   for (const requiredUiReadabilitySnippet of requiredUiReadabilitySnippets) {
     if (canonicalInstructionContent.includes(requiredUiReadabilitySnippet)) {
-      pass(`.instructions.md includes UI readability snippet: ${requiredUiReadabilitySnippet}`);
+      pass(`AGENTS.md includes UI readability snippet: ${requiredUiReadabilitySnippet}`);
     } else {
-      fail(`.instructions.md is missing UI readability snippet: ${requiredUiReadabilitySnippet}`);
+      fail(`AGENTS.md is missing UI readability snippet: ${requiredUiReadabilitySnippet}`);
     }
   }
 
@@ -445,83 +442,19 @@ export async function validateInstructionAdapters(context) {
 
     const thinAdapterContent = await readTextFile(absoluteAdapterPath);
 
-    if (
-      thinAdapterContent.includes('Adapter Mode: thin')
-      && thinAdapterContent.includes('Adapter Source: .instructions.md')
-    ) {
-      pass(`${thinAdapterPath} declares thin adapter metadata`);
+    if (thinAdapterContent.trim() === '@AGENTS.md') {
+      pass(`${thinAdapterPath} imports AGENTS.md`);
     } else {
-      fail(`${thinAdapterPath} must declare Adapter Mode: thin and Adapter Source: .instructions.md`);
-    }
-
-    for (const requiredBootstrapReceiptSnippet of requiredBootstrapReceiptSnippets) {
-      if (thinAdapterContent.includes(requiredBootstrapReceiptSnippet)) {
-        pass(`${thinAdapterPath} includes bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
-      } else {
-        fail(`${thinAdapterPath} is missing bootstrap receipt snippet: ${requiredBootstrapReceiptSnippet}`);
-      }
-    }
-
-    for (const requiredUiReadabilitySnippet of requiredUiReadabilitySnippets) {
-      if (thinAdapterContent.includes(requiredUiReadabilitySnippet)) {
-        pass(`${thinAdapterPath} includes UI readability snippet: ${requiredUiReadabilitySnippet}`);
-      } else {
-        fail(`${thinAdapterPath} is missing UI readability snippet: ${requiredUiReadabilitySnippet}`);
-      }
-    }
-
-    const hashMatch = thinAdapterContent.match(/Canonical Snapshot SHA256:\s*([a-f0-9]{64})/);
-    if (!hashMatch) {
-      fail(`${thinAdapterPath} must declare Canonical Snapshot SHA256`);
-      continue;
-    }
-
-    if (hashMatch[1] === canonicalSnapshotHash) {
-      pass(`${thinAdapterPath} canonical hash matches .instructions.md`);
-    } else {
-      fail(`${thinAdapterPath} canonical hash drift detected (expected ${canonicalSnapshotHash})`);
+      fail(`${thinAdapterPath} must be exactly @AGENTS.md`);
     }
 
     const thinAdapterLineCount = thinAdapterContent.split(/\r?\n/u).length;
-    if (thinAdapterLineCount <= 80) {
+    if (thinAdapterLineCount <= 2) {
       pass(`${thinAdapterPath} remains thin (${thinAdapterLineCount} lines)`);
     } else {
       fail(`${thinAdapterPath} is too large for thin-adapter mode (${thinAdapterLineCount} lines)`);
     }
   }
-
-  for (const legacyRootAdapterPath of legacyRootAdapterPaths) {
-    const absoluteLegacyRootAdapterPath = join(ROOT_DIR, legacyRootAdapterPath);
-    if (!(await fileExists(absoluteLegacyRootAdapterPath))) {
-      fail(`Missing legacy root adapter file: ${legacyRootAdapterPath}`);
-      continue;
-    }
-
-    const legacyRootAdapterContent = await readTextFile(absoluteLegacyRootAdapterPath);
-    const requiredLegacyRootAdapterSnippets = [
-      'Generated by Agentic-Senior-Core CLI v',
-      'Adapter Mode: legacy-thin',
-      'Adapter Source: .agent-instructions.md',
-      'Canonical baseline: .instructions.md',
-      '.agent-instructions.md',
-      '.agent-context/rules/',
-    ];
-
-    for (const requiredLegacyRootAdapterSnippet of requiredLegacyRootAdapterSnippets) {
-      if (legacyRootAdapterContent.includes(requiredLegacyRootAdapterSnippet)) {
-        pass(`${legacyRootAdapterPath} includes legacy-thin snippet: ${requiredLegacyRootAdapterSnippet}`);
-      } else {
-        fail(`${legacyRootAdapterPath} is missing legacy-thin snippet: ${requiredLegacyRootAdapterSnippet}`);
-      }
-    }
-
-    const legacyRootAdapterLineCount = legacyRootAdapterContent.split(/\r?\n/u).length;
-    if (legacyRootAdapterLineCount <= 40) {
-      pass(`${legacyRootAdapterPath} remains thin (${legacyRootAdapterLineCount} lines)`);
-    } else {
-      fail(`${legacyRootAdapterPath} is too large for legacy-thin mode (${legacyRootAdapterLineCount} lines)`);
-    }
-  }
 }
 
 export async function validateSkillPurgeSurface(context) {