@adityaaria/agent-os 1.0.0

package/scripts/telegram-poll.mjs

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { assertEnabledChannel, loadReportChannel } from './lib/run-utils.mjs';
+import {
+  createTelegramAccessControl,
+  normalizeTelegramUpdates,
+  processTelegramUpdates,
+  readTelegramUpdatesFromFile,
+  writeTelegramBotOutput
+} from './lib/telegram-bot-utils.mjs';
+import { sendTelegramRequest, telegramEnv } from './lib/telegram-utils.mjs';
+import { createCli, fail, failAll, resolveDefault, resolveDefaultPath, showHelp, wantsHelp } from './lib/cli-utils.mjs';
+
+const { hasFlag, takeOption } = createCli(process.argv.slice(2));
+
+if (wantsHelp(process.argv)) {
+  showHelp({
+    command: 'telegram-poll',
+    description: 'Poll Telegram for bot updates (one-shot)',
+    usage: [
+      'agent-os telegram-poll --send [options]',
+      'agent-os telegram-poll --dry-run [options]'
+    ],
+    required: [
+      { flag: '--send | --dry-run', desc: 'Send responses to Telegram, or write to file' },
+      { flag: '--allowed-chat-id <ids>', desc: 'Comma-separated allowed Telegram chat IDs' }
+    ],
+    options: [
+      { flag: '--channel-config <file>', desc: 'Channel config file', default: '.agent-os/project/report-channels.json' },
+      { flag: '--channel <name>', desc: 'Channel name', default: 'telegram' },
+      { flag: '--run-root <dir>', desc: 'Run directory root', default: '.agent-os/runs' },
+      { flag: '--state-file <file>', desc: 'Poll state file', default: '.agent-os/project/telegram-poll-state.json' },
+      { flag: '--output <file>', desc: 'Override output path' },
+      { flag: '--once', desc: 'Run once (default behavior)' }
+    ],
+    examples: [
+      'agent-os telegram-poll --send --allowed-chat-id 12345',
+      'agent-os telegram-poll --dry-run --allowed-chat-id 12345,67890'
+    ]
+  });
+}
+
+const channelConfig = takeOption('--channel-config') ?? resolveDefault(null, '.agent-os/project/report-channels.json');
+const channelName = takeOption('--channel') ?? 'telegram';
+const allowedChatId = takeOption('--allowed-chat-id');
+const runRoot = takeOption('--run-root') ?? resolveDefault(null, '.agent-os/runs');
+const stateFile = takeOption('--state-file') ?? resolveDefaultPath(null, '.agent-os/project/telegram-poll-state.json');
+const outputOverride = takeOption('--output');
+const once = hasFlag('--once');
+const dryRun = hasFlag('--dry-run');
+const send = hasFlag('--send');
+
+// Batched validation
+const errors = [];
+if (dryRun === send) errors.push('Use either --dry-run or --send (exactly one required).');
+if (!channelConfig) errors.push('Missing --channel-config <file> (no default found at .agent-os/project/report-channels.json).');
+if (!allowedChatId) errors.push('Missing --allowed-chat-id <id[,id]> (required, no default).');
+if (!runRoot) errors.push('Missing --run-root <dir> (no default found at .agent-os/runs).');
+if (!stateFile) errors.push('Missing --state-file <file>.');
+failAll(errors, 'agent-os telegram-poll --send --allowed-chat-id 12345', 'telegram-poll');
+
+let channelContext;
+try {
+  channelContext = loadReportChannel(channelConfig, channelName);
+  assertEnabledChannel(channelContext);
+} catch (err) {
+  fail(err.message);
+}
+
+const channel = channelContext.channel;
+if (channel.type !== 'telegram') {
+  fail(`Report channel is not a telegram channel: ${channelName}`);
+}
+
+const absoluteStateFile = path.resolve(process.cwd(), stateFile);
+const { botTokenEnv, botToken } = telegramEnv(channel);
+
+let updates;
+const mockFile = channel.mockUpdatesFile;
+
+let offset = null;
+if (fs.existsSync(absoluteStateFile)) {
+  try {
+    const state = JSON.parse(fs.readFileSync(absoluteStateFile, 'utf8'));
+    offset = state.offset ?? null;
+  } catch {
+    offset = null;
+  }
+}
+
+if (mockFile) {
+  updates = readTelegramUpdatesFromFile(mockFile, channelContext.outputBaseDir);
+} else {
+  if (!botToken) {
+    fail(`Missing required environment variable: ${botTokenEnv}. Set it or add mockUpdatesFile to the channel config.`);
+  }
+
+  const params = { timeout: 10, allowed_updates: ['message', 'callback_query'] };
+  if (offset !== null) params.offset = offset;
+
+  const result = await sendTelegramRequest({ channel, botToken, method: 'getUpdates', body: params });
+  updates = normalizeTelegramUpdates(result);
+}
+
+const pendingUpdates = offset !== null ? updates.filter((u) => u.update_id >= offset) : updates;
+
+if (pendingUpdates.length > 0) {
+  const maxUpdateId = Math.max(...updates.map((u) => u.update_id));
+  fs.mkdirSync(path.dirname(absoluteStateFile), { recursive: true });
+  fs.writeFileSync(absoluteStateFile, JSON.stringify({ offset: maxUpdateId + 1 }) + '\n');
+}
+
+
+
+
+const responses = processTelegramUpdates({
+  updates: pendingUpdates,
+  accessControl: createTelegramAccessControl({
+    allowedChatId,
+    roles: channel.roles
+  }),
+  runRoot,
+  channelConfig: channel,
+  auditRunRoot: runRoot
+});
+
+if (dryRun) {
+  const outputPath = writeTelegramBotOutput({
+    channelContext,
+    channelName,
+    responses,
+    outputOverride,
+    mode: 'dry-run'
+  });
+  console.log(`Dry-run output: ${outputPath}`);
+  process.exit(0);
+}
+
+const { chatIdEnv, chatId } = telegramEnv(channel);
+for (const response of responses) {
+  const targetChatId = response.chatId ?? chatId;
+  if (!targetChatId) {
+    console.error(`No chat ID for response. Set ${chatIdEnv} or ensure the update contains a chat ID.`);
+    continue;
+  }
+
+  const body = {
+    chat_id: targetChatId,
+    text: response.text,
+    parse_mode: 'MarkdownV2'
+  };
+  if (response.replyMarkup) body.reply_markup = response.replyMarkup;
+
+  try {
+    await sendTelegramRequest({ channel, channelContext, botToken, method: 'sendMessage', body });
+  } catch (err) {
+    console.error(`Failed to send message to ${targetChatId}: ${err.message}`);
+  }
+
+  if (response.callbackQueryId) {
+    try {
+      await sendTelegramRequest({
+        channel,
+        channelContext,
+        botToken,
+        method: 'answerCallbackQuery',
+        body: { callback_query_id: response.callbackQueryId }
+      });
+    } catch {
+      // Callback answer is best-effort
+    }
+  }
+}
+
+console.log(`Processed ${responses.length} response(s).`);

package/scripts/validate-framework.mjs

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { wantsHelp, showHelp } from './lib/cli-utils.mjs';
+
+if (wantsHelp(process.argv)) {
+  showHelp({
+    command: 'validate',
+    description: 'Validate Agent OS framework structure and integrity',
+    usage: ['agent-os validate [--root <dir>]'],
+    options: [
+      { flag: '--root <dir>', desc: 'Agent OS source root', default: '(auto-detected)' }
+    ],
+    examples: [
+      'agent-os validate',
+      'agent-os validate --root /path/to/agent-os'
+    ]
+  });
+}
+
+const __filename = fileURLToPath(import.meta.url);
+const defaultRepoRoot = path.resolve(path.dirname(__filename), '..');
+const args = process.argv.slice(2);
+const rootArgIndex = args.indexOf('--root');
+const repoRoot = rootArgIndex === -1
+  ? defaultRepoRoot
+  : path.resolve(process.cwd(), args[rootArgIndex + 1] ?? defaultRepoRoot);
+
+const failures = [];
+
+function exists(relativePath) {
+  return fs.existsSync(path.join(repoRoot, relativePath));
+}
+
+function fail(message) {
+  failures.push(message);
+}
+
+function requirePath(relativePath) {
+  if (!exists(relativePath)) fail(`Missing required path: ${relativePath}`);
+}
+
+function listDirs(relativePath) {
+  const absolutePath = path.join(repoRoot, relativePath);
+  if (!fs.existsSync(absolutePath)) return [];
+  return fs.readdirSync(absolutePath, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort();
+}
+
+function listFilesRecursive(relativePath) {
+  const absolutePath = path.join(repoRoot, relativePath);
+  if (!fs.existsSync(absolutePath)) return [];
+
+  const entries = fs.readdirSync(absolutePath, { withFileTypes: true });
+  return entries.flatMap((entry) => {
+    const child = path.join(relativePath, entry.name);
+    if (entry.isDirectory()) return listFilesRecursive(child);
+    return child;
+  });
+}
+
+function validateCoreStructure() {
+  [
+    'AGENTS.md',
+    'ENTRYPOINT.md',
+    'AGENT_OS_BOOTSTRAP.md',
+    'plugin.json',
+    'core/TASK_ROUTER.md',
+    'core/QUALITY_GATES.md',
+    'core/SKILL_ORCHESTRATOR.md',
+    '.github/workflows/validate.yml',
+    'bin/agent-os.mjs',
+    'scripts/install.mjs',
+    'scripts/lib/run-utils.mjs',
+    'scripts/orchestrate.mjs',
+    'scripts/run-list.mjs',
+    'scripts/run-status.mjs',
+    'scripts/run-step.mjs',
+    'scripts/sync-runtime.mjs',
+    'scripts/validate-framework.mjs',
+    'templates/PROJECT_PROFILE.md',
+    'skills/enhancement/SKILL.md'
+  ].forEach(requirePath);
+}
+
+function validateDeveloperWorkflow() {
+  const packageJsonPath = path.join(repoRoot, 'package.json');
+  if (!fs.existsSync(packageJsonPath)) {
+    fail('Missing package.json.');
+    return;
+  }
+
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  if (packageJson.bin?.['agent-os'] !== 'bin/agent-os.mjs') {
+    fail('package.json must expose bin.agent-os as bin/agent-os.mjs');
+  }
+
+  for (const script of ['test', 'validate', 'sync:runtime']) {
+    if (!packageJson.scripts?.[script]) fail(`package.json missing required script: ${script}`);
+  }
+
+  const workflowPath = path.join(repoRoot, '.github/workflows/validate.yml');
+  if (fs.existsSync(workflowPath)) {
+    const workflow = fs.readFileSync(workflowPath, 'utf8');
+    for (const command of ['npm run sync:runtime', 'npm test', 'npm run validate']) {
+      if (!workflow.includes(command)) fail(`CI workflow missing command: ${command}`);
+    }
+  }
+
+  const gitignorePath = path.join(repoRoot, '.gitignore');
+  if (fs.existsSync(gitignorePath)) {
+    const gitignore = fs.readFileSync(gitignorePath, 'utf8');
+    if (!/^\.DS_Store$/m.test(gitignore)) fail('.gitignore must ignore .DS_Store');
+  } else {
+    fail('Missing .gitignore');
+  }
+}
+
+function validateRuntimeStructure() {
+  [
+    '.agent-os/ENTRYPOINT.md',
+    '.agent-os/core/TASK_ROUTER.md',
+    '.agent-os/project',
+    '.agent-os/project/PROJECT_PROFILE.md',
+    '.agent-os/project/TECH_STACK.md',
+    '.agent-os/project/ARCHITECTURE.md',
+    '.agent-os/project/WORKSPACE_MAP.md',
+    '.agent-os/skills/enhancement/SKILL.md'
+  ].forEach(requirePath);
+}
+
+function validateSkillAnatomy() {
+  const skills = listDirs('skills');
+  if (skills.length === 0) {
+    fail('No skills found in root skills directory.');
+    return;
+  }
+
+  for (const skill of skills) {
+    for (const file of ['SKILL.md', 'workflow.md', 'checklist.md', 'report-template.md']) {
+      requirePath(`skills/${skill}/${file}`);
+    }
+  }
+}
+
+function validateRuntimeSkillSync() {
+  const sourceSkills = listDirs('skills');
+  const runtimeSkills = listDirs('.agent-os/skills');
+
+  const sourceOnly = sourceSkills.filter((skill) => !runtimeSkills.includes(skill));
+  const runtimeOnly = runtimeSkills.filter((skill) => !sourceSkills.includes(skill));
+
+  for (const skill of sourceOnly) fail(`Runtime skills missing source skill: ${skill}`);
+  for (const skill of runtimeOnly) fail(`Runtime skills contain unknown skill: ${skill}`);
+}
+
+function validateReportTemplates() {
+  const requiredSections = [
+    'Executive Summary',
+    'Scope',
+    'Knowledge Confidence',
+    'Knowledge Classification',
+    'Traceability Matrix',
+    'Evidence',
+    'Root Cause',
+    'Impact',
+    'Recommendation',
+    'Quality Gate',
+    'Enterprise Readiness',
+    'Final Decision'
+  ];
+
+  const reportTemplates = [
+    ...listFilesRecursive('skills'),
+    ...listFilesRecursive('.agent-os/skills')
+  ].filter((file) => file.endsWith('report-template.md'));
+
+  for (const file of reportTemplates) {
+    const content = fs.readFileSync(path.join(repoRoot, file), 'utf8');
+    for (const section of requiredSections) {
+      const sectionPattern = new RegExp(`^# ${section}$`, 'm');
+      if (!sectionPattern.test(content)) {
+        fail(`${file} missing required report section: ${section}`);
+      }
+    }
+  }
+}
+
+function validateNoForbiddenPlaceholders() {
+  const forbidden = [
+    '[TBD]',
+    '[Placeholder]',
+    '[List Here]',
+    '[Describe Here]',
+    '[0-100]',
+    '[Any Generic Text]',
+    '<Detail>'
+  ];
+
+  const files = [
+    ...listFilesRecursive('core'),
+    ...listFilesRecursive('skills'),
+    ...listFilesRecursive('templates'),
+    ...listFilesRecursive('.agent-os/core')
+  ].filter((file) => file.endsWith('.md'));
+
+  for (const file of files) {
+    const content = fs.readFileSync(path.join(repoRoot, file), 'utf8');
+    for (const token of forbidden) {
+      if (content.includes(token)) {
+        fail(`Forbidden placeholder ${token} found in ${file}`);
+      }
+    }
+  }
+}
+
+function validateEntrypointIntegrity() {
+  const coreFiles = [
+    'AGENTS.md',
+    'core/COMPLIANCE_GATE.md',
+    'core/AUTO_PROJECT_DETECTOR.md',
+    'core/KNOWLEDGE_VALIDATOR.md',
+    'core/KNOWLEDGE_REGENERATOR.md',
+    'core/SKILL_ORCHESTRATOR.md',
+    'core/TASK_ROUTER.md',
+    'core/QUALITY_GATES.md',
+    'core/TRACEABILITY_STANDARD.md',
+    'core/REPORTING_STANDARD.md'
+  ];
+
+  let allPresent = true;
+  for (const file of coreFiles) {
+    if (!exists(file)) {
+      fail(`FAIL [entrypoint-integrity]: Missing core file: ${file}`);
+      allPresent = false;
+    }
+  }
+  if (allPresent) {
+    console.log('PASS [entrypoint-integrity]: All 10 core files present');
+  }
+}
+
+const warnings = [];
+
+function warn(message) {
+  warnings.push(message);
+}
+
+function validateSkillComplianceCheck() {
+  const skills = listDirs('skills');
+  const requiredHeadings = ['Purpose', 'Responsibilities', 'Workflow'];
+
+  for (const skill of skills) {
+    const skillPath = `skills/${skill}/SKILL.md`;
+    if (!exists(skillPath)) continue;
+
+    const content = fs.readFileSync(path.join(repoRoot, skillPath), 'utf8');
+    const missing = requiredHeadings.filter((heading) => {
+      const pattern = new RegExp(`^#{1,2}\\s+${heading}`, 'im');
+      return !pattern.test(content);
+    });
+
+    if (missing.length > 0) {
+      fail(`FAIL [skill-compliance]: skills/${skill}/SKILL.md missing required sections: ${missing.join(', ')}`);
+    }
+  }
+}
+
+validateCoreStructure();
+validateDeveloperWorkflow();
+validateRuntimeStructure();
+validateSkillAnatomy();
+validateRuntimeSkillSync();
+validateReportTemplates();
+validateNoForbiddenPlaceholders();
+validateEntrypointIntegrity();
+validateSkillComplianceCheck();
+
+for (const warning of warnings) console.warn(warning);
+
+if (failures.length > 0) {
+  console.error('Framework validation failed:');
+  for (const failure of failures) console.error(`- ${failure}`);
+  process.exit(1);
+}
+
+console.log('Framework validation passed.');

package/skills/api-contract-audit/SKILL.md

@@ -0,0 +1,26 @@
+# API-CONTRACT-AUDIT SKILL
+
+## Purpose
+To audit the strict compliance between Frontend requests and Backend API Contracts, ensuring that payloads, responses, validations, and status codes are synchronized.
+
+## Responsibilities
+- Audit Frontend Request Payloads.
+- Audit Backend Response Payloads.
+- Validate DTOs and Swagger/OpenAPI documentation.
+- Check validation rules and HTTP Status code handling.
+
+## Workflow
+Follow the detailed workflow in `workflow.md` for this skill.
+
+## Required Inputs
+Minimal Prompting: `AUDIT: API Contract [Endpoint/Module]`
+
+## Expected Outputs
+API Contract Compliance Report.
+
+## Execution Rules
+- Never assume an API structure; verify against explicit DTOs or Swagger specs.
+- Ensure Evidence Collection is populated (e.g., sample JSON payloads).
+
+## Minimal Prompting Target
+- Agent automatically infers the FE and BE code locations using onboarding knowledge.

package/skills/api-contract-audit/checklist.md

@@ -0,0 +1,16 @@
+# API-CONTRACT-AUDIT CHECKLIST
+
+## Entry Criteria
+- [ ] Target API or Module is clearly identified.
+
+## Execution
+- [ ] Frontend request payload validated.
+- [ ] Backend response payload validated.
+- [ ] DTO & Swagger specification validated.
+- [ ] Validation rules (required, types, constraints) verified.
+- [ ] HTTP Status handling verified.
+
+## Exit Criteria / Definition of Done
+- [ ] API Contract Compliance Report generated.
+- [ ] Severity classified for all findings.
+- [ ] Quality Gate set to PASS.

package/skills/api-contract-audit/examples.md

@@ -0,0 +1,3 @@
+# EXAMPLES
+
+To be populated by Agent OS automatically based on project context.

package/skills/api-contract-audit/report-template.md

@@ -0,0 +1,39 @@
+# Executive Summary
+* **Trigger Detected**: N/A. Reason: Populated during skill execution.
+* **Purpose**: N/A. Reason: Populated during skill execution.
+
+# Scope
+* **Target**: N/A. Reason: Populated during skill execution.
+
+# Knowledge Confidence
+* **Score**: N/A. Reason: Populated during skill execution.
+
+# Knowledge Classification
+* **Classification**: N/A. Reason: Populated during skill execution.
+
+# Traceability Matrix
+| Layer | File | Function | Notes |
+| ----- | ---- | -------- | ----- |
+| Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
+
+# Evidence
+* N/A. Reason: Populated during skill execution.
+
+# Root Cause
+* N/A. Reason: Populated during skill execution.
+
+# Impact
+* N/A. Reason: Populated during skill execution.
+
+# Recommendation
+* **Quick Win**: N/A. Reason: Populated during skill execution.
+* **Long Term Improvement**: N/A. Reason: Populated during skill execution.
+
+# Quality Gate
+* N/A. Reason: Populated during skill execution.
+
+# Enterprise Readiness
+* N/A. Reason: Populated during skill execution.
+
+# Final Decision
+N/A. Reason: Populated during skill execution.

package/skills/api-contract-audit/workflow.md

@@ -0,0 +1,15 @@
+# API-CONTRACT-AUDIT WORKFLOW
+
+You MUST execute these explicit steps sequentially:
+
+1. **Pre Validation** (Verify `traceability-analysis` coverage exists)
+2. **Locate Frontend Request** (Identify payload generation in FE)
+3. **Locate Backend Contract** (Identify Controller & DTO)
+4. **Compare Payload Structure** (Match keys and types)
+5. **Compare Response Structure** (Match BE response to FE expectations)
+6. **Audit Swagger/Docs** (Check if docs match implementation)
+7. **Audit Validation Rules** (Check class-validator constraints)
+8. **Audit HTTP Statuses** (Ensure correct error/success codes)
+9. **Execution Validation** (Ensure all mismatches are backed by Evidence)
+10. **Generate Compliance Report**
+11. **Post Validation** (Verify report conforms to Enterprise Standard)

package/skills/audit/SKILL.md

@@ -0,0 +1,28 @@
+# AUDIT SKILL
+
+## Purpose
+To execute a comprehensive Enterprise Architecture Audit across the repository, ensuring code adheres strictly to architectural, security, performance, maintainability, scalability, and traceability standards.
+
+## Responsibilities
+- Audit Architecture (Monolith/Microservice boundary leaks).
+- Audit Security (Hardcoded secrets, exposed vulnerabilities).
+- Audit Performance (N+1 queries, heavy bundles).
+- Audit Maintainability (Code duplication, missing tests).
+- Audit Scalability (Statelessness, caching).
+- Audit Traceability (FE-BE links).
+
+## Workflow
+Follow the detailed workflow in `workflow.md` for this skill.
+
+## Required Inputs
+Minimal Prompting: `AUDIT: [Target component/module or whole project]`
+
+## Expected Outputs
+An Enterprise Architecture Audit Report with explicit severity assignments.
+
+## Execution Rules
+- Do not propose fixes blindly; categorize the severity (Critical, High, Medium, Low) and provide actionable recommendations.
+- Collect explicit evidence (Snippets, Logs) for every finding.
+
+## Minimal Prompting Target
+- Agent autonomously parses "AUDIT: Order Module", analyzes the FE component, traces it to the BE service and DB, and audits all 6 vectors without further prompts.

package/skills/audit/checklist.md

@@ -0,0 +1,18 @@
+# AUDIT CHECKLIST
+
+## Entry Criteria
+- [ ] Audit scope is clearly defined via minimal prompt.
+
+## Execution
+- [ ] Traceability established for the scope.
+- [ ] Architecture audited.
+- [ ] Security audited.
+- [ ] Performance audited.
+- [ ] Maintainability audited.
+- [ ] Scalability audited.
+- [ ] Evidence collected for all findings.
+
+## Exit Criteria / Definition of Done
+- [ ] Enterprise Architecture Audit Report generated.
+- [ ] All findings categorized by Severity (Critical/High/Medium/Low).
+- [ ] Quality Gate set to PASS.

package/skills/audit/examples.md

@@ -0,0 +1,26 @@
+# AUDIT EXAMPLES
+
+### Example 1
+```txt
+AUDIT: Review the Auth module for token leaks.
+```
+
+### Example 2
+```txt
+AUDIT: Check DB queries for N+1 problems.
+```
+
+### Example 3
+```txt
+AUDIT: Verify FE components use Atomic Design.
+```
+
+### Example 4
+```txt
+AUDIT: Audit dependencies for known CVEs.
+```
+
+### Example 5
+```txt
+AUDIT: Review error handling in controllers.
+```

package/skills/audit/report-template.md

@@ -0,0 +1,39 @@
+# Executive Summary
+* **Trigger Detected**: N/A. Reason: Populated during skill execution.
+* **Purpose**: N/A. Reason: Populated during skill execution.
+
+# Scope
+* **Target**: N/A. Reason: Populated during skill execution.
+
+# Knowledge Confidence
+* **Score**: N/A. Reason: Populated during skill execution.
+
+# Knowledge Classification
+* **Classification**: N/A. Reason: Populated during skill execution.
+
+# Traceability Matrix
+| Layer | File | Function | Notes |
+| ----- | ---- | -------- | ----- |
+| Framework | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. | N/A. Reason: Populated during skill execution. |
+
+# Evidence
+* N/A. Reason: Populated during skill execution.
+
+# Root Cause
+* N/A. Reason: Populated during skill execution.
+
+# Impact
+* N/A. Reason: Populated during skill execution.
+
+# Recommendation
+* **Quick Win**: N/A. Reason: Populated during skill execution.
+* **Long Term Improvement**: N/A. Reason: Populated during skill execution.
+
+# Quality Gate
+* N/A. Reason: Populated during skill execution.
+
+# Enterprise Readiness
+* N/A. Reason: Populated during skill execution.
+
+# Final Decision
+N/A. Reason: Populated during skill execution.