aios-core 4.2.5 → 4.2.7

package/.aios-core/core/orchestration/dashboard-integration.js

@@ -252,12 +252,28 @@ class DashboardIntegration extends EventEmitter {
       await fs.writeJson(this.statusPath, status, { spaces: 2 });
       this.emit('statusUpdated', status);
     } catch (error) {
-      this.emit('error', { type: 'statusUpdate', error });
+      this._emitSafeError({ type: 'statusUpdate', error });
     }
 
     return status;
   }
 
+  /**
+   * Emit error event only when listeners are present, otherwise degrade to warning.
+   * Avoids unhandled EventEmitter 'error' exceptions in background update flows.
+   * @private
+   * @param {Object} payload
+   */
+  _emitSafeError(payload) {
+    if (this.listenerCount('error') > 0) {
+      this.emit('error', payload);
+      return;
+    }
+
+    const message = payload?.error?.message || 'unknown dashboard error';
+    console.warn(`[DashboardIntegration] ${payload?.type || 'error'}: ${message}`);
+  }
+
   /**
    * Build status object (AC2)
    * @returns {Object} Status object

package/.aios-core/core/orchestration/execution-profile-resolver.js

@@ -0,0 +1,107 @@
+'use strict';
+
+const VALID_PROFILES = ['safe', 'balanced', 'aggressive'];
+const VALID_CONTEXTS = ['production', 'migration', 'security-sensitive', 'development'];
+
+const PROFILE_POLICIES = {
+  safe: {
+    require_confirmation: true,
+    require_tests_before_handoff: true,
+    max_parallel_changes: 1,
+    allow_destructive_operations: false,
+    allow_autonomous_refactors: false,
+  },
+  balanced: {
+    require_confirmation: 'high-risk-only',
+    require_tests_before_handoff: true,
+    max_parallel_changes: 3,
+    allow_destructive_operations: false,
+    allow_autonomous_refactors: true,
+  },
+  aggressive: {
+    require_confirmation: false,
+    require_tests_before_handoff: false,
+    max_parallel_changes: 8,
+    allow_destructive_operations: false,
+    allow_autonomous_refactors: true,
+  },
+};
+
+function normalizeProfile(profile) {
+  const value = String(profile || '').trim().toLowerCase();
+  return VALID_PROFILES.includes(value) ? value : null;
+}
+
+function normalizeContext(context) {
+  const value = String(context || '').trim().toLowerCase();
+  return VALID_CONTEXTS.includes(value) ? value : 'development';
+}
+
+function resolveExecutionProfile(input = {}) {
+  const context = normalizeContext(input.context);
+  const explicitProfile = normalizeProfile(input.explicitProfile);
+  const yolo = Boolean(input.yolo);
+  const reasons = [];
+
+  if (explicitProfile) {
+    reasons.push(`explicit profile selected: ${explicitProfile}`);
+    return {
+      profile: explicitProfile,
+      context,
+      policy: PROFILE_POLICIES[explicitProfile],
+      reasons,
+      source: 'explicit',
+    };
+  }
+
+  if (context === 'production' || context === 'security-sensitive') {
+    reasons.push(`context "${context}" enforces safe profile`);
+    return {
+      profile: 'safe',
+      context,
+      policy: PROFILE_POLICIES.safe,
+      reasons,
+      source: 'context',
+    };
+  }
+
+  if (context === 'migration') {
+    reasons.push('migration context enforces balanced profile');
+    return {
+      profile: 'balanced',
+      context,
+      policy: PROFILE_POLICIES.balanced,
+      reasons,
+      source: 'context',
+    };
+  }
+
+  if (yolo) {
+    reasons.push('yolo mode enabled for non-critical context');
+    return {
+      profile: 'aggressive',
+      context,
+      policy: PROFILE_POLICIES.aggressive,
+      reasons,
+      source: 'yolo',
+    };
+  }
+
+  reasons.push('default profile for standard development context');
+  return {
+    profile: 'balanced',
+    context,
+    policy: PROFILE_POLICIES.balanced,
+    reasons,
+    source: 'default',
+  };
+}
+
+module.exports = {
+  VALID_PROFILES,
+  VALID_CONTEXTS,
+  PROFILE_POLICIES,
+  normalizeProfile,
+  normalizeContext,
+  resolveExecutionProfile,
+};

package/.aios-core/core/orchestration/index.js

@@ -22,6 +22,7 @@ const ParallelExecutor = require('./parallel-executor');
 const TechStackDetector = require('./tech-stack-detector');
 const ConditionEvaluator = require('./condition-evaluator');
 const SkillDispatcher = require('./skill-dispatcher');
+const executionProfileResolver = require('./execution-profile-resolver');
 
 // Epic 0: Master Orchestrator (ADE)
 const MasterOrchestrator = require('./master-orchestrator');
@@ -159,6 +160,8 @@ module.exports = {
   TechStackDetector,
   ConditionEvaluator,
   SkillDispatcher,
+  ExecutionProfileResolver: executionProfileResolver,
+  resolveExecutionProfile: executionProfileResolver.resolveExecutionProfile,
 
   // Epic 0: Orchestrator constants
   OrchestratorState: MasterOrchestrator.OrchestratorState,

package/.aios-core/core/orchestration/skill-dispatcher.js

@@ -170,6 +170,8 @@ class SkillDispatcher {
         workflowId: context.workflowId,
         yoloMode: context.yoloMode || false,
         previousPhases: context.previousPhases || {},
+        executionProfile: context.executionProfile || null,
+        executionPolicy: context.executionPolicy || null,
       },
     };
   }

package/.aios-core/core/orchestration/subagent-prompt-builder.js

@@ -299,7 +299,9 @@ ${agentDef}
 **Task File:** ${taskFile}
 **Expected Output:** ${context.creates || 'See task definition'}
 **Execution Mode:** ${context.yoloMode ? 'YOLO (autonomous)' : 'Interactive'}
+**Execution Profile:** ${context.executionProfile || 'balanced'}
 **Elicitation Required:** ${context.elicit ? 'Yes' : 'No'}
+**Risk Policy:** ${JSON.stringify(context.executionPolicy || {}, null, 0)}
 
 ### Complete Task Definition:
 

package/.aios-core/core/orchestration/workflow-orchestrator.js

@@ -23,6 +23,7 @@ const ChecklistRunner = require('./checklist-runner');
 const TechStackDetector = require('./tech-stack-detector');
 const ConditionEvaluator = require('./condition-evaluator');
 const SkillDispatcher = require('./skill-dispatcher');
+const { resolveExecutionProfile } = require('./execution-profile-resolver');
 
 /**
  * Orchestrates multi-agent workflow execution
@@ -41,11 +42,15 @@ class WorkflowOrchestrator {
     this.workflowPath = workflowPath;
     this.options = {
       yolo: options.yolo || false,
+      executionProfile: options.executionProfile || null,
+      executionContext: options.executionContext || 'development',
       parallel: options.parallel !== false, // Default true
       onPhaseStart: options.onPhaseStart || this._defaultPhaseStart.bind(this),
       onPhaseComplete: options.onPhaseComplete || this._defaultPhaseComplete.bind(this),
       dispatchSubagent: options.dispatchSubagent || null,
       projectRoot: options.projectRoot || process.cwd(),
+      confidenceThreshold: this._resolveConfidenceThreshold(options.confidenceThreshold),
+      enableConfidenceGate: options.enableConfidenceGate !== false,
     };
 
     this.workflow = null;
@@ -59,6 +64,11 @@ class WorkflowOrchestrator {
     this.skillDispatcher = new SkillDispatcher(this.options);
     this.conditionEvaluator = null; // Initialized after pre-flight detection
     this.techStackProfile = null; // Populated by pre-flight detection
+    this.executionProfile = resolveExecutionProfile({
+      explicitProfile: this.options.executionProfile,
+      context: this.options.executionContext,
+      yolo: this.options.yolo,
+    });
 
     // Execution state
     this.executionState = {
@@ -395,8 +405,15 @@ class WorkflowOrchestrator {
       }
     }
 
-    // Generate execution summary
-    return this._generateExecutionSummary();
+    // Generate execution summary + confidence gate
+    const summary = this._generateExecutionSummary();
+    if (summary.confidenceGate?.enabled && !summary.confidenceGate.passed) {
+      await this.contextManager.markFailed(
+        `Delivery confidence ${summary.deliveryConfidence.score}% below threshold ${summary.confidenceGate.threshold}%`,
+        this.executionState.currentPhase,
+      );
+    }
+    return summary;
   }
 
   /**
@@ -478,7 +495,9 @@ class WorkflowOrchestrator {
 
         // V3.1: Save skip result to context with reason
         const skipResult = this.skillDispatcher.createSkipResult(phase, skipReason);
-        await this.contextManager.savePhaseOutput(phaseNum, skipResult);
+        await this.contextManager.savePhaseOutput(phaseNum, skipResult, {
+          handoffTarget: this._getNextPhaseHandoffTarget(phaseNum),
+        });
 
         return { skipped: true, phase: phaseNum, reason: skipReason };
       }
@@ -522,6 +541,8 @@ class WorkflowOrchestrator {
           notes: phase.notes,
           checklist: phase.checklist,
           template: phase.template,
+          executionProfile: this.executionProfile.profile,
+          executionPolicy: this.executionProfile.policy,
         },
       );
 
@@ -534,6 +555,8 @@ class WorkflowOrchestrator {
           ...context,
           workflowId: this.workflow.workflow?.id,
           yoloMode: this.options.yolo,
+          executionProfile: this.executionProfile.profile,
+          executionPolicy: this.executionProfile.policy,
           previousPhases: this.executionState.completedPhases,
         },
         techStackProfile: this.techStackProfile,
@@ -545,6 +568,11 @@ class WorkflowOrchestrator {
           `   🚀 ${this.skillDispatcher.formatDispatchLog(dispatchPayload).split('\n')[0]}`,
         ),
       );
+      console.log(
+        chalk.gray(
+          `   🛡️  Execution profile: ${this.executionProfile.profile} (${this.executionProfile.context})`,
+        ),
+      );
 
       // Dispatch to subagent
       let result;
@@ -556,7 +584,8 @@ class WorkflowOrchestrator {
           agentId: phase.agent,
           prompt,
           phase,
-          context,
+          context: dispatchPayload.context,
+          baseContext: context,
         });
 
         // V3.1: Parse and normalize skill output
@@ -586,6 +615,8 @@ class WorkflowOrchestrator {
         result,
         validation,
         timestamp: new Date().toISOString(),
+      }, {
+        handoffTarget: this._getNextPhaseHandoffTarget(phaseNum),
       });
 
       // Notify phase complete
@@ -615,6 +646,31 @@ class WorkflowOrchestrator {
     return this._evaluateConditionLegacy(condition);
   }
 
+  /**
+   * Determine next phase handoff target from workflow sequence.
+   * @private
+   */
+  _getNextPhaseHandoffTarget(currentPhaseNum) {
+    const sequence = Array.isArray(this.workflow?.sequence) ? this.workflow.sequence : [];
+    const currentIndex = sequence.findIndex((p) => p && p.phase === currentPhaseNum);
+    if (currentIndex < 0) {
+      return { phase: null, agent: null };
+    }
+
+    for (let i = currentIndex + 1; i < sequence.length; i += 1) {
+      const next = sequence[i];
+      if (!next || next.workflow_end || !next.phase) {
+        continue;
+      }
+      return {
+        phase: next.phase,
+        agent: next.agent || null,
+      };
+    }
+
+    return { phase: null, agent: null };
+  }
+
   /**
    * Legacy condition evaluation (backward compatibility)
    * @private
@@ -703,7 +759,8 @@ class WorkflowOrchestrator {
     const minutes = Math.floor(duration / 60000);
     const seconds = Math.floor((duration % 60000) / 1000);
 
-    return {
+    const deliveryConfidence = this.contextManager?.getDeliveryConfidence?.() || null;
+    const summary = {
       workflow: this.workflow.workflow?.id,
       status: this.executionState.failedPhases.length === 0 ? 'completed' : 'completed_with_errors',
       duration: `${minutes}m ${seconds}s`,
@@ -717,6 +774,57 @@ class WorkflowOrchestrator {
       failedPhases: this.executionState.failedPhases,
       skippedPhases: this.executionState.skippedPhases,
       outputs: this.contextManager?.getPreviousPhaseOutputs() || {},
+      deliveryConfidence,
+    };
+
+    const confidenceGate = this._evaluateConfidenceGate(deliveryConfidence);
+    if (confidenceGate.enabled) {
+      summary.confidenceGate = confidenceGate;
+      if (!confidenceGate.passed && summary.status === 'completed') {
+        summary.status = 'failed_confidence_gate';
+      }
+    }
+
+    return summary;
+  }
+
+  /**
+   * Resolve confidence threshold from explicit option > env > default.
+   * @private
+   */
+  _resolveConfidenceThreshold(explicitThreshold) {
+    const explicit = Number(explicitThreshold);
+    if (Number.isFinite(explicit)) {
+      return explicit;
+    }
+    const envThreshold = Number(process.env.AIOS_DELIVERY_CONFIDENCE_THRESHOLD);
+    return Number.isFinite(envThreshold) ? envThreshold : 70;
+  }
+
+  /**
+   * Evaluate delivery confidence gate.
+   * @private
+   */
+  _evaluateConfidenceGate(deliveryConfidence) {
+    if (!this.options.enableConfidenceGate) {
+      return { enabled: false, threshold: this.options.confidenceThreshold, passed: true };
+    }
+
+    if (!deliveryConfidence || !Number.isFinite(deliveryConfidence.score)) {
+      return {
+        enabled: true,
+        threshold: this.options.confidenceThreshold,
+        passed: false,
+        reason: 'delivery_confidence_unavailable',
+      };
+    }
+
+    const passed = deliveryConfidence.score >= this.options.confidenceThreshold;
+    return {
+      enabled: true,
+      threshold: this.options.confidenceThreshold,
+      score: deliveryConfidence.score,
+      passed,
     };
   }
 

package/.aios-core/data/entity-registry.yaml

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-02-16T01:40:14.162Z'
-  entityCount: 505
+  lastUpdated: '2026-02-16T04:49:07.416Z'
+  entityCount: 506
   checksumAlgorithm: sha256
 entities:
   tasks:
@@ -1952,13 +1952,14 @@ entities:
       usedBy: []
       dependencies:
         - suggestion-engine
+        - workflow-state-manager
         - output-formatter
       adaptability:
         score: 0.8
         constraints: []
         extensionPoints: []
-      checksum: sha256:8ba7dc4567c0c7bf7001f0a26650767f72f45442d312daeb0e321ba4605ce429
-      lastVerified: '2026-02-15T19:17:32.644Z'
+      checksum: sha256:d9c84f8892367cd8e1bd453dd08876d051bcc368ca9eacf5d2babb26235427fb
+      lastVerified: '2026-02-16T01:52:27.944Z'
     orchestrate-resume:
       path: .aios-core/development/tasks/orchestrate-resume.md
       type: task
@@ -4764,21 +4765,24 @@ entities:
         extensionPoints: []
       checksum: sha256:e8345404f17977a268b917a4ff86e4f10f80174a6bb572865e5413c8f7dd217a
       lastVerified: '2026-02-15T17:43:13.184Z'
-    statusline-script:
-      path: .aios-core/product/templates/statusline/statusline-script.js
+    brownfield-risk-report-tmpl:
+      path: .aios-core/product/templates/brownfield-risk-report-tmpl.yaml
       type: template
-      purpose: Entity at .aios-core\product\templates\statusline\statusline-script.js
+      purpose: '>'
       keywords:
-        - statusline
-        - script
+        - brownfield
+        - risk
+        - report
+        - tmpl
+        - template
       usedBy: []
       dependencies: []
       adaptability:
         score: 0.5
         constraints: []
         extensionPoints: []
-      checksum: sha256:352b928acd0a477875192ce96fa3aebb278fe9d9b55bc24a144e7aaafa180b45
-      lastVerified: '2026-02-16T01:40:14.160Z'
+      checksum: sha256:173adec3131f0924bc7d64c10f54386bb85dcadc14e6ff3fb9bb2f8172caf162
+      lastVerified: '2026-02-16T04:49:07.415Z'
   scripts:
     agent-assignment-resolver:
       path: .aios-core/development/scripts/agent-assignment-resolver.js
@@ -5726,20 +5730,21 @@ entities:
     workflow-state-manager:
       path: .aios-core/development/scripts/workflow-state-manager.js
       type: script
-      purpose: Entity at .aios-core\development\scripts\workflow-state-manager.js
+      purpose: Entity at .aios-core/development/scripts/workflow-state-manager.js
       keywords:
         - workflow
         - state
         - manager
       usedBy:
+        - next
         - verify-workflow-gaps
       dependencies: []
       adaptability:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:56758b8af8b53b74b89b758d84feda85b73ea196704c2969573d183025f052d7
-      lastVerified: '2026-02-08T13:33:24.304Z'
+      checksum: sha256:89177df1184e1650ba3e9aad18c9a3b07f6b77711f0271949e8676701695e431
+      lastVerified: '2026-02-16T01:52:27.944Z'
     workflow-validator:
       path: .aios-core/development/scripts/workflow-validator.js
       type: script
@@ -6817,7 +6822,7 @@ entities:
     context-manager:
       path: .aios-core/core/orchestration/context-manager.js
       type: module
-      purpose: Entity at .aios-core\core\orchestration\context-manager.js
+      purpose: Entity at .aios-core/core/orchestration/context-manager.js
       keywords:
         - context
         - manager
@@ -6828,8 +6833,8 @@ entities:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:91b4e84f1a6246f9a1c94191a096bf9ee26b668610cc3fe7aec893931f54d241
-      lastVerified: '2026-02-08T13:33:24.342Z'
+      checksum: sha256:0dd03e84d0a2ea06165825c5eb7154531337ef98275918119ccd03769af576c3
+      lastVerified: '2026-02-16T02:23:49.802Z'
     dashboard-integration:
       path: .aios-core/core/orchestration/dashboard-integration.js
       type: module
@@ -7061,8 +7066,8 @@ entities:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:0a2dcf12cb8b04c26006c57016cf0d651332e60dee09762f88927c216464abde
-      lastVerified: '2026-02-08T13:33:24.350Z'
+      checksum: sha256:4a54fec3a3338431d1d9634ebf06f3983d06903570c45d67d0ac15d25c95eb05
+      lastVerified: '2026-02-16T02:23:49.802Z'
     subagent-prompt-builder:
       path: .aios-core/core/orchestration/subagent-prompt-builder.js
       type: module
@@ -7175,7 +7180,7 @@ entities:
     workflow-orchestrator:
       path: .aios-core/core/orchestration/workflow-orchestrator.js
       type: module
-      purpose: Entity at .aios-core\core\orchestration\workflow-orchestrator.js
+      purpose: Entity at .aios-core/core/orchestration/workflow-orchestrator.js
       keywords:
         - workflow
         - orchestrator
@@ -7188,12 +7193,13 @@ entities:
         - tech-stack-detector
         - condition-evaluator
         - skill-dispatcher
+        - execution-profile-resolver
       adaptability:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:fb89682ea86d33bf8453062f82be0313fbfdf4da42ebf0220dd12dc29238a50a
-      lastVerified: '2026-02-08T13:33:24.353Z'
+      checksum: sha256:5d3f14d5f12742ce87c3ae8745f82f4ac9f3df3d1889cf16bfc13743130963f9
+      lastVerified: '2026-02-16T02:23:49.803Z'
     operation-guard:
       path: .aios-core/core/permissions/operation-guard.js
       type: module
@@ -9016,6 +9022,22 @@ entities:
         extensionPoints: []
       checksum: sha256:869fbc8fbc333ac8eea4eca3ea4ab9ca79917fa5e53735b70d634c85ac6420c8
       lastVerified: '2026-02-08T13:33:24.391Z'
+    brownfield-compatibility-checklist:
+      path: .aios-core/development/checklists/brownfield-compatibility-checklist.md
+      type: checklist
+      purpose: Brownfield Compatibility Checklist
+      keywords:
+        - brownfield
+        - compatibility
+        - checklist
+      usedBy: []
+      dependencies: []
+      adaptability:
+        score: 0.6
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:d07b1f9e2fcb78f62188ef05a6e6f75a94821b6bb297ea67f2e782e260d27f49
+      lastVerified: '2026-02-16T04:49:07.414Z'
   data:
     agent-config-requirements:
       path: .aios-core/data/agent-config-requirements.yaml

package/.aios-core/development/agents/ux-design-expert.md

@@ -196,7 +196,7 @@ commands:
 
   # === UNIVERSAL COMMANDS ===
   scan {path|url}: 'Analyze HTML/React artifact for patterns'
-  integrate {pack}: 'Connect with squad'
+  integrate {squad}: 'Connect with squad'
   help: 'Show all commands organized by phase'
   status: 'Show current workflow phase'
   guide: 'Show comprehensive usage guide for this agent'

package/.aios-core/development/checklists/brownfield-compatibility-checklist.md

@@ -0,0 +1,114 @@
+# Brownfield Compatibility Checklist
+
+> Story AIOS-DIFF-4.3.2: Checklist formal de compatibilidade retroativa
+
+## Pre-Migration Compatibility Check
+
+### 1. Source Control Status
+- [ ] All changes committed to version control
+- [ ] Working branch created from main/master
+- [ ] Remote backup verified (push before migration)
+
+### 2. Existing Configuration Preservation
+- [ ] `.env` files backed up (never overwritten by AIOS)
+- [ ] `package.json` scripts preserved
+- [ ] Existing linting config (.eslintrc, .prettierrc) detected
+- [ ] CI/CD workflows (.github/workflows) inventoried
+
+### 3. Dependency Compatibility
+- [ ] Node.js version compatible (>=18)
+- [ ] No conflicting global dependencies
+- [ ] Lock file (package-lock.json/yarn.lock) preserved
+
+### 4. Directory Structure Analysis
+- [ ] `docs/` directory status checked (empty/existing)
+- [ ] `.aios-core/` not present (fresh install)
+- [ ] No naming conflicts with AIOS directories
+
+## During Migration Checks
+
+### 5. Non-Destructive Operations
+- [ ] AIOS creates new files, never overwrites existing
+- [ ] Merge conflicts surfaced for user decision
+- [ ] Original files preserved with `.backup` if conflict
+
+### 6. Configuration Merge Strategy
+- [ ] Existing `.gitignore` entries preserved + AIOS entries added
+- [ ] TypeScript config extended (not replaced) if existing
+- [ ] ESLint rules merged (not overwritten)
+
+### 7. Rollback Points
+- [ ] Pre-migration commit hash recorded
+- [ ] AIOS files clearly identified (can be removed cleanly)
+- [ ] No modifications to existing source code during install
+
+## Post-Migration Validation
+
+### 8. Existing Functionality
+- [ ] `npm test` passes (if tests existed before)
+- [ ] `npm run build` succeeds (if build existed)
+- [ ] Application starts normally
+
+### 9. AIOS Integration
+- [ ] `npx aios-core doctor` reports healthy
+- [ ] Agent activation works (@dev, @architect, etc.)
+- [ ] Existing docs not duplicated
+
+### 10. Rollback Verification
+- [ ] `git diff HEAD~1` shows only AIOS additions
+- [ ] `git checkout HEAD~1 -- .` would restore pre-AIOS state
+- [ ] No orphaned AIOS processes or files
+
+---
+
+## Compatibility Matrix
+
+| Existing Config | AIOS Behavior | User Action Required |
+|-----------------|---------------|---------------------|
+| `.eslintrc.*` | Detect + preserve | None |
+| `.prettierrc.*` | Detect + preserve | None |
+| `tsconfig.json` | Extend (not replace) | Review extends |
+| `jest.config.*` | Detect + preserve | None |
+| `docs/*.md` | Skip (don't overwrite) | Manual merge if needed |
+| `.github/workflows/*` | Inventory only | User decides integration |
+| `package.json` scripts | Preserve all | None |
+
+## Rollback Procedure
+
+If migration fails or is unwanted:
+
+```bash
+# Option 1: Full rollback to pre-migration state
+git checkout HEAD~1 -- .
+
+# Option 2: Remove only AIOS files
+rm -rf .aios-core/
+rm -rf docs/architecture/ docs/prd/ docs/stories/
+# Review and revert .gitignore AIOS entries
+
+# Option 3: Soft rollback (keep docs, remove runtime)
+rm -rf .aios-core/
+```
+
+---
+
+## Checklist Usage
+
+**Pre-Migration:**
+```bash
+# Run compatibility check
+npx aios-core doctor --pre-migration
+```
+
+**Post-Migration:**
+```bash
+# Validate migration
+npx aios-core doctor
+npm test  # if tests exist
+npm run build  # if build exists
+```
+
+---
+
+*AIOS Brownfield Compatibility Checklist v1.0*
+*Story AIOS-DIFF-4.3.2*