@ryuenn3123/agentic-senior-core 3.0.46 → 3.0.48

package/lib/cli/compiler.mjs

@@ -15,7 +15,6 @@ import {
 import {
   pathExists,
   collectFileNames,
-  isAgenticManagedContent,
 } from './utils.mjs';
 
 import {
@@ -106,38 +105,6 @@ function buildAnchorCommitmentHeader(designIntent) {
   ].join('\n');
 }
 
-function buildLegacyRootAdapterContent(adapterFileName, toolLabel) {
-  return [
-    `# ${adapterFileName} - Legacy Thin Adapter`,
-    '',
-    `Generated by Agentic-Senior-Core CLI v${CLI_VERSION}`,
-    'Adapter Mode: legacy-thin',
-    'Adapter Source: .agent-instructions.md when present; fallback .instructions.md',
-    'Canonical baseline: .instructions.md',
-    '',
-    `This file is kept only for older ${toolLabel} discovery.`,
-    'Read .agent-instructions.md for the compiled rulebook when present.',
-    'Use .instructions.md as the canonical policy source.',
-    '',
-    'Mandatory load floor:',
-    '1. Read .agent-instructions.md when present; otherwise read .instructions.md.',
-    '2. Load only relevant .agent-context/rules/ by task scope.',
-    '3. Apply matching .agent-context/prompts/ contracts.',
-    '4. Enforce .agent-context/review-checklists/ before completion.',
-    '5. Use .agent-context/state/ and .agent-context/policies/ only when relevant.',
-    '6. Resolve Runtime Decision Signals from repo evidence and live official docs.',
-    '7. Resolve Structural Planning Signals from constraints and architecture boundaries.',
-    '',
-    'Current bridges:',
-    '- Cursor: .cursor/rules/agentic-senior-core.mdc',
-    '- Windsurf: .windsurf/rules/agentic-senior-core.md',
-    '- Claude: CLAUDE.md',
-    '- Gemini: GEMINI.md and .gemini/instructions.md',
-    '- Copilot: .github/copilot-instructions.md and .github/instructions/agentic-senior-core.instructions.md',
-    '',
-  ].join('\n');
-}
-
 function buildContainerizationStrategySnapshot(dockerStrategy) {
   const selectedDockerStrategy = String(dockerStrategy || '').trim();
   const normalizedDockerStrategy = selectedDockerStrategy.toLowerCase();
@@ -220,7 +187,7 @@ export async function writeOnboardingReport({
     selectedBlueprint: hasExplicitArchitectureDecision ? selectedBlueprintFileName : null,
     selectedAdditionalBlueprints: hasExplicitArchitectureDecision ? selectedAdditionalBlueprintFileNames : [],
     ruleLoadingPolicy: {
-      canonicalSource: '.instructions.md',
+      canonicalSource: 'AGENTS.md',
       stackLoadingMode: 'lazy',
       domainRuleLoadingMode: 'lazy',
       loadedOnDemand: true,
@@ -330,11 +297,10 @@ export async function buildCompiledRulesContent({
       `6. .agent-context/policies/${POLICY_FILE_NAME}`,
       '7. docs/ project context (or bootstrap prompts when docs are not materialized)',
       '',
-      'Project-specific compiled snapshot: .agent-instructions.md',
-      'Compiled rulebook: .agent-instructions.md',
-      'Legacy thin root adapters: .cursorrules, .windsurfrules, .clauderc',
-      'Generated bridge adapters: AGENTS.md, CLAUDE.md, GEMINI.md, .cursor/rules/agentic-senior-core.mdc, .windsurf/rules/agentic-senior-core.md, .github/copilot-instructions.md, .github/instructions/agentic-senior-core.instructions.md, .gemini/instructions.md',
-      'Canonical baseline: .instructions.md',
+      'Canonical instruction source: AGENTS.md',
+      'Native import bridges: CLAUDE.md, GEMINI.md',
+      'Managed rule library: .agent-context/',
+      'Project decisions and dynamic state: .agent-context/state/onboarding-report.json',
     ].join('\n')
   );
 
@@ -422,8 +388,10 @@ export async function buildCompiledRulesContent({
       '3. .agent-context/prompts/review-code.md -> review, audit, check, analyze',
       '4. .agent-context/prompts/bootstrap-design.md -> ui, ux, layout, screen, tailwind, frontend, redesign',
       'Documentation-first policy:',
-      '- Create or refine required project docs before implementation: README.md for every fresh or existing project; docs/project-brief.md; docs/architecture-decision-record.md; docs/flow-overview.md; docs/api-contract.md when APIs, firmware endpoints, CLI commands, or web application flows exist; docs/database-schema.md when persistent data exists; and docs/DESIGN.md plus docs/design-intent.json for UI scope.',
+      '- Create or refine required project docs before implementation: README.md for every fresh or existing project; docs/doc-index.md whenever docs/ exists; docs/project-brief.md; docs/architecture-decision-record.md; docs/flow-overview.md; docs/api-contract.md when APIs, firmware endpoints, CLI commands, or web application flows exist; docs/database-schema.md when persistent data exists; and docs/DESIGN.md plus docs/design-intent.json for UI scope.',
       '- Keep README.md public and developer friendly, including for private projects: explain what the project is, who it is for, setup, usage, configuration, and links to deeper docs. Do not put secrets, internal agent notes, private reasoning, or governance policy dumps in it.',
+      '- Use docs/doc-index.md as the compact read-routing map before selecting deeper docs. Do not broad-read docs/*.md by default.',
+      '- Add PRD, SRS, technical-design, or separate ERD only when project evidence justifies them.',
       '- Keep docs complete but compact. Add extra docs files only for stable, distinct, or long workflows such as hardware setup, deployment, operations, testing validation, or troubleshooting.',
       '- Write formal project docs in English by default unless the user explicitly asks for another documentation language.',
       '- For docs-only/docs-first requests, do not write application, firmware, or UI code until the user asks or approves an implementation plan.',
@@ -546,14 +514,22 @@ export async function buildCompiledRulesContent({
 
   if (await pathExists(projectBriefPath)) {
     const hasRootReadme = await pathExists(path.join(resolvedTargetDirectoryPath, 'README.md'));
-    const projectDocsEntries = ['project-brief.md'];
+    const projectDocsEntries = [];
     const candidateDocFileNames = [
+      'doc-index.md',
+      'project-brief.md',
       'architecture-decision-record.md',
+      'technical-design.md',
+      'prd.md',
+      'srs.md',
       'database-schema.md',
+      'erd.md',
       'api-contract.md',
       'flow-overview.md',
       'DESIGN.md',
       'design-intent.json',
+      'runbook.md',
+      'troubleshooting.md',
     ];
 
     for (const candidateFileName of candidateDocFileNames) {
@@ -573,6 +549,7 @@ export async function buildCompiledRulesContent({
         '',
         'Universal SOP hard block policy:',
         '- README.md must exist and read as a public and developer entrypoint.',
+        '- docs/doc-index.md must exist whenever docs/ exists and act as the compact read-routing map.',
         '- 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.',
@@ -580,6 +557,8 @@ export async function buildCompiledRulesContent({
         '- 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.',
         '- Keep README.md overview-level, public, and developer friendly; do not put secrets, internal agent notes, private reasoning, or governance policy dumps in it.',
+        '- Use README.md plus docs/doc-index.md to choose the smallest relevant read set before loading deeper docs.',
+        '- Add PRD, SRS, technical-design, or separate ERD only when project evidence justifies them.',
         '- 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.',
@@ -612,10 +591,12 @@ export async function buildCompiledRulesContent({
         '',
         'Bootstrap policy:',
         '- Create README.md as a public and developer entrypoint before coding continues.',
+        '- Create docs/doc-index.md as the compact read-routing map whenever docs/ exists.',
         '- 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.',
+        '- Add PRD, SRS, technical-design, or separate ERD only when project evidence justifies them.',
         '- For docs-only/docs-first requests, stop after docs unless the user asks for implementation or approves an implementation plan.',
         '- If docs/project-brief.md is missing, execute bootstrap-project-context prompt immediately.',
         hasBootstrapDesignPrompt
@@ -644,62 +625,11 @@ export async function buildCompiledRulesContent({
     `Selected policy file: .agent-context/policies/${POLICY_FILE_NAME}`,
     '',
     '## GOVERNANCE PRECEDENCE',
-    '1. Follow this compiled rulebook as the primary source.',
-    '2. Resolve exceptions from .agent-override.md only when explicitly defined.',
-    '3. Use architecture-map.md and dependency-map.md as change safety boundaries.',
-    '4. Enforce pr-checklist.md before declaring completion.',
-    '',
-    '## OVERRIDE PROTOCOL',
-    '- Default: strict compliance with this file.',
-    '- Exception path: .agent-override.md may explicitly allow narrow deviations.',
-    '- Scope policy: every override must include module scope, rationale, and expiry date.',
+    '1. Follow AGENTS.md as the primary source.',
+    '2. Use architecture-map.md and dependency-map.md as change safety boundaries.',
+    '3. Enforce pr-checklist.md before declaring completion.',
     '',
     ...contextBlocks,
     '',
   ].join('\n');
 }
-
-export async function compileDynamicContext({
-  targetDirectoryPath,
-  selectedStackFileName,
-  selectedAdditionalStackFileNames = [],
-  selectedBlueprintFileName,
-  selectedAdditionalBlueprintFileNames = [],
-  includeCiGuardrails,
-  preserveUserOwnedEntrypoints = true,
-}) {
-  const resolvedTargetDirectoryPath = path.resolve(targetDirectoryPath);
-  const compiledRules = await buildCompiledRulesContent({
-    targetDirectoryPath: resolvedTargetDirectoryPath,
-    selectedStackFileName,
-    selectedAdditionalStackFileNames,
-    selectedBlueprintFileName,
-    selectedAdditionalBlueprintFileNames,
-    includeCiGuardrails,
-  });
-  const preservedEntrypoints = [];
-
-  async function writeGeneratedEntrypointFile(relativeFilePath, content) {
-    const targetFilePath = path.join(resolvedTargetDirectoryPath, relativeFilePath);
-
-    if (preserveUserOwnedEntrypoints && await pathExists(targetFilePath)) {
-      const existingContent = await fs.readFile(targetFilePath, 'utf8');
-      if (!isAgenticManagedContent(existingContent)) {
-        preservedEntrypoints.push(relativeFilePath);
-        return;
-      }
-    }
-
-    await fs.mkdir(path.dirname(targetFilePath), { recursive: true });
-    await fs.writeFile(targetFilePath, content, 'utf8');
-  }
-
-  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.agent-instructions.md'), compiledRules, 'utf8');
-  await writeGeneratedEntrypointFile('.cursorrules', buildLegacyRootAdapterContent('.cursorrules', 'Cursor'));
-  await writeGeneratedEntrypointFile('.windsurfrules', buildLegacyRootAdapterContent('.windsurfrules', 'Windsurf'));
-  await writeGeneratedEntrypointFile('.clauderc', buildLegacyRootAdapterContent('.clauderc', 'Claude'));
-
-  return {
-    preservedEntrypoints,
-  };
-}

package/lib/cli/constants.mjs

@@ -126,19 +126,11 @@ export const RUNTIME_ENVIRONMENT_CHOICES = [
 ];
 
 export const entryPointFiles = [
-  '.instructions.md',
-  '.cursorrules',
-  '.windsurfrules',
   'AGENTS.md',
   'CLAUDE.md',
   'GEMINI.md',
-  '.cursor/rules/agentic-senior-core.mdc',
-  '.github/copilot-instructions.md',
-  '.github/instructions/agentic-senior-core.instructions.md',
-  '.windsurf/rules/agentic-senior-core.md',
-  '.agent-override.md',
 ];
 
-export const directoryCopies = ['.agent-context', '.gemini', '.agents'];
+export const directoryCopies = ['.agent-context'];
 
 export const BACKUP_DIR_NAME = '.agentic-backup';

package/lib/cli/detector.mjs

@@ -102,7 +102,6 @@ const PROJECT_MARKER_FILE_NAMES = new Set([
 const INTERNAL_GOVERNANCE_SURFACE_NAMES = new Set([
   '.agent-context',
   '.agent-instructions.md',
-  '.agent-override.md',
   '.agentic-backup',
   '.agents',
   '.clauderc',

package/lib/cli/init-options.mjs

@@ -23,7 +23,7 @@ export function parseInitArguments(commandArguments) {
     tokenOptimize: true,
     memoryContinuity: true,
     tokenAgent: 'copilot',
-    includeMcpTemplate: true,
+    includeMcpTemplate: false,
     scaffoldDocs: undefined,
     docsLang: 'en',
     docsLangProvided: false,

package/lib/cli/project-scaffolder/constants.mjs

@@ -6,6 +6,7 @@ export const PROJECT_DOC_FILE_NAMES = [
   'api-contract.md',
   'flow-overview.md',
 ];
+export const DOC_INDEX_FILE_NAME = 'doc-index.md';
 export const UI_DESIGN_CONTRACT_FILE_NAMES = ['DESIGN.md', 'design-intent.json'];
 
 // Legacy project docs may still carry this version header; keep for upgrade staleness checks.

package/lib/cli/project-scaffolder/discovery.mjs

@@ -3,6 +3,7 @@ import fs from 'node:fs/promises';
 import { askChoice, askYesNo } from '../utils.mjs';
 import {
   ARCHITECTURE_STYLE_CHOICES,
+  DOC_INDEX_FILE_NAME,
   DOCKER_STRATEGY_CHOICES,
   SUPPORTED_DOC_LANGUAGES,
 } from './constants.mjs';
@@ -169,6 +170,7 @@ export function resolveProjectDocTargets(discoveryAnswers) {
     || discoveryAnswers.primaryDomain.toLowerCase().includes('fullstack');
 
   const requiredDocFileNames = [
+    DOC_INDEX_FILE_NAME,
     'project-brief.md',
     'architecture-decision-record.md',
     'flow-overview.md',

package/lib/cli/project-scaffolder/prompt-builders.mjs

@@ -78,7 +78,9 @@ export function buildProjectContextBootstrapPrompt({
     '12. Treat topology as an agent decision unless the user explicitly constrained it. If monolith fits, explain why. If a service split fits, document the evidence and service boundary logic.',
     '13. Required docs coverage must include a public and developer README entrypoint, feature plan, architecture rationale, flow, public API or integration contracts when relevant, data model when relevant, UI/design when relevant, security assumptions, testing strategy, runtime/deployment notes, and next validation actions.',
     '14. README.md must be public and developer friendly, including for private projects: what it is, who it is for, setup, core workflow, configuration, and links to deeper docs. Do not include secrets, internal agent notes, private reasoning, or governance policy dumps.',
-    '15. Keep docs complete but compact. Add extra docs files only for stable, distinct, or long workflows such as hardware setup, deployment, operations, testing validation, or troubleshooting.',
+    '15. docs/doc-index.md is the low-token routing map for docs/*. Keep it short, list each active doc, and explain when an agent should read it. Do not make it the source of truth for requirements or architecture.',
+    '16. Keep docs complete but compact. Add extra docs files only for stable, distinct, or long workflows such as hardware setup, deployment, operations, testing validation, or troubleshooting.',
+    '17. Add SRS, PRD, technical-design, or ERD docs only when project evidence triggers them. Use PRD for product-roadmap/user-story ownership, SRS for contractual or multi-stakeholder acceptance criteria, technical-design for non-trivial architecture decisions, and ERD only as a separate file when the schema is too complex for docs/database-schema.md.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -105,10 +107,12 @@ export function buildProjectContextBootstrapPrompt({
     '## Required Execution',
     '1. Create all required docs files listed above with complete Markdown content.',
     '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. Before implementation, use the docs to confirm stack, runtime, architecture, public contracts, data, validation, and delivery assumptions.',
-    '5. Keep content original, specific to this project, and actionable for implementation.',
-    '6. After writing docs, continue coding tasks using these docs as living project context.',
+    '3. In docs/doc-index.md, include a compact table with document path, purpose, reads-when triggers, status, and last-updated date.',
+    '4. 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.',
+    '5. Before implementation, use README.md plus docs/doc-index.md to select only the relevant docs for the current task instead of broad-reading docs/*.md.',
+    '6. Before implementation, use the docs to confirm stack, runtime, architecture, public contracts, data, validation, and delivery assumptions.',
+    '7. Keep content original, specific to this project, and actionable for implementation.',
+    '8. After writing docs, continue coding tasks using these docs as living project context.',
     '',
   ].join('\n');
 }

package/lib/cli/utils/filesystem.mjs

@@ -51,6 +51,8 @@ export function isAgenticManagedContent(content) {
     'Adapter Mode: legacy-thin',
     'Canonical Snapshot SHA256',
     'Canonical baseline: .instructions.md',
+    'canonical instruction source for this repository',
+    '@AGENTS.md',
   ].some((managedSignal) => normalizedContent.includes(managedSignal));
 }
 

package/lib/cli/utils/managed-surface.mjs

@@ -6,7 +6,10 @@ import {
   entryPointFiles,
   directoryCopies,
 } from '../constants.mjs';
-import { pathExists } from './filesystem.mjs';
+import {
+  isAgenticManagedContent,
+  pathExists,
+} from './filesystem.mjs';
 
 function toPosixRelativePath(relativePath) {
   return relativePath.split(path.sep).join('/');
@@ -29,6 +32,34 @@ const localOnlyGovernanceFiles = new Set([
   '.agent-context/state/v3-purge-audit.json',
 ]);
 
+const legacyManagedInstructionFiles = [
+  '.instructions.md',
+  '.agent-instructions.md',
+  '.cursorrules',
+  '.windsurfrules',
+  '.clauderc',
+  '.cursor/rules/agentic-senior-core.mdc',
+  '.windsurf/rules/agentic-senior-core.md',
+  '.github/copilot-instructions.md',
+  '.github/instructions/agentic-senior-core.instructions.md',
+  '.gemini/instructions.md',
+  '.agents/workflows/init-project.md',
+  '.agents/workflows/refactor.md',
+  '.agents/workflows/review-code.md',
+];
+
+export const legacyManagedInstructionDirectories = [
+  '.agents/workflows',
+  '.agents',
+  '.cursor/rules',
+  '.cursor',
+  '.windsurf/rules',
+  '.windsurf',
+  '.github/instructions',
+  '.github',
+  '.gemini',
+];
+
 function isLocalOnlyGovernanceFile(relativePath) {
   return localOnlyGovernanceFiles.has(toPosixRelativePath(relativePath));
 }
@@ -171,6 +202,18 @@ async function collectManagedTargetManifest(resolvedTargetDirectoryPath, options
     targetDirectories.add(targetDirectoryPath);
   }
 
+  for (const legacyManagedFile of legacyManagedInstructionFiles) {
+    const targetFilePath = path.join(resolvedTargetDirectoryPath, ...legacyManagedFile.split('/'));
+    if (!(await pathExists(targetFilePath))) {
+      continue;
+    }
+
+    const targetFileContent = await fs.readFile(targetFilePath);
+    if (isAgenticManagedContent(targetFileContent)) {
+      targetFiles.add(legacyManagedFile);
+    }
+  }
+
   return {
     files: targetFiles,
     directories: targetDirectories,
@@ -183,7 +226,7 @@ export async function analyzeManagedGovernanceSurface(
 ) {
   const preservePathPrefixes = Array.isArray(options.preservePathPrefixes)
     ? options.preservePathPrefixes
-    : ['.agent-context/state', '.gemini'];
+    : ['.agent-context/state'];
 
   const sourceManifest = await buildManagedSourceManifest(options);
   const targetManifest = await collectManagedTargetManifest(resolvedTargetDirectoryPath, options);

package/lib/cli/utils.mjs

@@ -22,6 +22,7 @@ import {
 import {
   collectRelativeTreeEntries,
   analyzeManagedGovernanceSurface,
+  legacyManagedInstructionDirectories,
 } from './utils/managed-surface.mjs';
 export {
   pathExists,
@@ -32,6 +33,7 @@ export {
 } from './utils/filesystem.mjs';
 export {
   analyzeManagedGovernanceSurface,
+  legacyManagedInstructionDirectories,
 } from './utils/managed-surface.mjs';
 export {
   askChoice,
@@ -71,8 +73,8 @@ export function printUsage() {
   console.log('  --no-token-optimize  Disable token optimization policy during init');
   console.log('  --memory-continuity  Explicitly enable cross-session memory continuity policy during init (default behavior)');
   console.log('  --no-memory-continuity  Disable memory continuity policy during init');
-  console.log('  --mcp-template   Explicitly enable cross-IDE MCP auto-configuration (default behavior)');
-  console.log('  --no-mcp-template Disable automatic MCP configuration across your IDEs');
+  console.log('  --mcp-template   Explicitly enable cross-IDE MCP auto-configuration (opt-in)');
+  console.log('  --no-mcp-template Keep MCP configuration disabled (default behavior)');
   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 bootstrap docs synthesis language (default: en)');
@@ -83,8 +85,8 @@ export function printUsage() {
   console.log('  --prune      Keep managed governance files synchronized 1:1 (default in upgrade)');
   console.log('  --no-prune   Do not remove stale managed governance files during upgrade');
   console.log('  --agent      Target agent integration for token optimization mode');
-  console.log('  --enable     Enable token optimization policy and rebuild compiled rules');
-  console.log('  --disable    Disable token optimization policy and rebuild compiled rules');
+  console.log('  --enable     Enable token optimization policy state');
+  console.log('  --disable    Disable token optimization policy state');
   console.log('  --show       Print current token optimization state as JSON');
 }
 
@@ -125,6 +127,17 @@ async function syncMcpConfig(mcpJsonPath, templateConfig) {
   }
 }
 
+async function pruneEmptyLegacyInstructionDirectories(resolvedTargetDirectoryPath) {
+  for (const relativeDirectoryPath of legacyManagedInstructionDirectories) {
+    const directoryPath = path.join(resolvedTargetDirectoryPath, ...relativeDirectoryPath.split('/'));
+    try {
+      await fs.rmdir(directoryPath);
+    } catch {
+      // Keep non-empty or missing directories. They may contain user-owned files.
+    }
+  }
+}
+
 export async function copyGovernanceAssetsToTarget(
   resolvedTargetDirectoryPath,
   options = {}
@@ -205,6 +218,8 @@ export async function copyGovernanceAssetsToTarget(
       await fs.rm(staleDirectoryPath, { recursive: true, force: true });
       deletedManagedDirectories.push(staleDirectoryRelativePath);
     }
+
+    await pruneEmptyLegacyInstructionDirectories(resolvedTargetDirectoryPath);
   }
 
   if (shouldIncludeMcpTemplate) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "3.0.46",
+  "version": "3.0.48",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {
@@ -10,7 +10,6 @@
     "bin/",
     "lib/",
     "scripts/",
-    ".instructions.md",
     ".agent-context/policies/",
     ".agent-context/prompts/",
     ".agent-context/review-checklists/",
@@ -24,17 +23,9 @@
     ".agent-context/state/benchmark-writer-judge-config.json",
     ".agent-context/state/memory-adapter-contract.json",
     ".agent-context/state/memory-schema-v1.json",
-    ".agents/",
-    ".cursor/",
-    ".github/",
-    ".gemini/",
-    ".windsurf/",
-    ".cursorrules",
-    ".windsurfrules",
     "AGENTS.md",
     "CLAUDE.md",
     "GEMINI.md",
-    ".agent-override.md",
     "mcp.json",
     "README.md",
     "LICENSE",

package/scripts/bump-version.mjs

@@ -71,22 +71,7 @@ async function bumpVersion() {
     console.log('Updated docs/deep-analysis-and-roadmap-backlog.md');
   }
 
-  // 4. Update legacy root adapters that carry release metadata.
-  const legacyAdapterFiles = ['.cursorrules', '.windsurfrules'];
-  for (const legacyAdapterFile of legacyAdapterFiles) {
-    const legacyAdapterPath = path.join(ROOT_DIR, legacyAdapterFile);
-    if (await fileExists(legacyAdapterPath)) {
-      const legacyAdapterContent = await readTextFile(legacyAdapterPath);
-      const updatedLegacyAdapterContent = legacyAdapterContent.replace(
-        /Generated by Agentic-Senior-Core CLI v\d+\.\d+\.\d+/,
-        `Generated by Agentic-Senior-Core CLI v${newVersion}`
-      );
-      await writeTextFile(legacyAdapterPath, updatedLegacyAdapterContent);
-      console.log(`Updated ${legacyAdapterFile}`);
-    }
-  }
-
-  // 5. Update CHANGELOG.md
+  // 4. Update CHANGELOG.md
   const changelogPath = path.join(ROOT_DIR, 'CHANGELOG.md');
   if (await fileExists(changelogPath)) {
     let changelogContent = await readTextFile(changelogPath);

package/scripts/docs-quality-drift-report.mjs

@@ -24,15 +24,9 @@ const LONG_SENTENCE_WORD_THRESHOLD = 28;
 const MONITORED_STATIC_FILE_PATHS = [
   'README.md',
   'CHANGELOG.md',
-  '.instructions.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',
   'docs/deep-analysis-and-roadmap-backlog.md',
 ];
 

package/scripts/frontend-usability-audit.mjs

@@ -20,7 +20,7 @@ const REQUIRED_FILES = [
   'docs/roadmap.md',
   'docs/archive/v1.7-issue-breakdown.md',
   'docs/archive/v1.7-execution-playbook.md',
-  '.instructions.md',
+  'AGENTS.md',
   '.agent-context/prompts/bootstrap-design.md',
   'scripts/ui-design-judge.mjs',
   'scripts/ui-rubric-calibration.mjs',
@@ -173,7 +173,7 @@ function runAudit() {
   const roadmapPath = 'docs/roadmap.md';
   const frontendRulePath = '.agent-context/rules/frontend-architecture.md';
   const bootstrapDesignPromptPath = '.agent-context/prompts/bootstrap-design.md';
-  const instructionsPath = '.instructions.md';
+  const instructionsPath = 'AGENTS.md';
   const prChecklistPath = '.agent-context/review-checklists/pr-checklist.md';
   const architectureChecklistPath = '.agent-context/review-checklists/architecture-review.md';
   const designEvidenceExtractorPath = 'lib/cli/detector/design-evidence.mjs';

package/scripts/governance-weekly-report.mjs

@@ -44,7 +44,7 @@ const REQUIRED_VERIFIED_DOMAINS = new Set([
   'state-continuity',
 ]);
 const GOVERNANCE_SURFACE_PATHS = {
-  'canonical-instructions': '.instructions.md',
+  'canonical-instructions': 'AGENTS.md',
   'frontend-design-contract': '.agent-context/prompts/bootstrap-design.md',
   'frontend-architecture': '.agent-context/rules/frontend-architecture.md',
   'backend-architecture': '.agent-context/rules/architecture.md',
@@ -75,7 +75,7 @@ const BACKEND_GOVERNANCE_COVERAGE = [
     constraint: 'Global backend/API rule routing',
     status: 'strengthened',
     sourcePaths: [
-      '.instructions.md',
+      'AGENTS.md',
       '.agent-context/rules/architecture.md',
       '.agent-context/prompts/refactor.md',
     ],