@thanhthi2895/luna-ai 2.16.2

package/agentic/shared/scripts/luna-cli/command-registry.cjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+/**
+ * command-registry.cjs
+ * Alias → script mapping for Luna CLI permission wrapper.
+ *
+ * Naming convention:
+ *   get_*, list_*, search_*, read_*  → read-only (auto-approved via settings.json)
+ *   update_*, create_*, set_*, delete_* → write (still prompts permission)
+ */
+
+'use strict';
+
+const path = require('path');
+
+const target = process.env.LUNA_AGENT || 'claude';
+const isAntigravity = target === 'antigravity' || target === 'gemini';
+const isOpencode = target === 'opencode';
+
+const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, '.claude');
+
+let basePath;
+if (isAntigravity) {
+  basePath = path.join(homeDir, '.gemini', 'antigravity');
+} else if (isOpencode) {
+  basePath = path.join(homeDir, '.config', 'opencode');
+} else {
+  basePath = claudeConfigDir;
+}
+
+const SKILLS_DIR = path.join(basePath, 'skills');
+const SHARED_SKILLS_DIR = path.join(homeDir, '.luna', 'skills');
+const SCRIPTS_DIR = path.join(homeDir, '.luna', 'scripts');
+
+// --- Registry definition ---------------------------------------------------
+
+const COMMANDS = [
+  // ── ClickUp (read) ──
+  { alias: 'get_clickup_task',     skill: 'clickup-task', script: 'clickup-api.cjs', subcommand: 'get-task',     description: 'Fetch ClickUp task details' },
+  { alias: 'get_clickup_subtasks', skill: 'clickup-task', script: 'clickup-api.cjs', subcommand: 'get-subtasks', description: 'List subtasks of a ClickUp task' },
+  { alias: 'get_clickup_comments', skill: 'clickup-task', script: 'clickup-api.cjs', subcommand: 'get-comments', description: 'Fetch comments on a ClickUp task' },
+  { alias: 'get_clickup_pr_url',   skill: 'clickup-task', script: 'clickup-api.cjs', subcommand: 'get-pr-url',   description: 'Get Pull Request URL from ClickUp task' },
+  { alias: 'search_clickup',       skill: 'clickup-task', script: 'clickup-api.cjs', subcommand: 'search',       description: 'Search ClickUp tasks by keyword' },
+
+  // ── ClickUp (write) ──
+  { alias: 'update_clickup_task',      skill: 'clickup-task', script: 'clickup-api.cjs',              subcommand: 'update-task',    description: 'Update ClickUp task status' },
+  { alias: 'set_clickup_pr_url',       skill: 'clickup-task', script: 'clickup-api.cjs',              subcommand: 'set-pr-url',     description: 'Set Pull Request URL on ClickUp task' },
+  { alias: 'create_clickup_comment',   skill: 'clickup-task', script: 'clickup-api.cjs',              subcommand: 'create-comment', description: 'Add comment to ClickUp task', stdin: true },
+  { alias: 'update_clickup_idtc',      skill: 'clickup-task', script: 'clickup-update-idtc.cjs',      subcommand: null,             description: 'Update ID/TC section in ClickUp task', stdin: true },
+  { alias: 'update_clickup_checklist', skill: 'clickup-task', script: 'clickup-update-checklist.cjs', subcommand: null,             description: 'Toggle checklist items in ClickUp task' },
+
+  // ── Jira (read) ──
+  { alias: 'get_jira_issue',    skill: 'jira-task', script: 'jira-api.cjs', subcommand: 'get-issue',    description: 'Fetch Jira issue details' },
+  { alias: 'get_jira_comments', skill: 'jira-task', script: 'jira-api.cjs', subcommand: 'get-comments', description: 'Fetch comments on a Jira issue' },
+  { alias: 'search_jira',       skill: 'jira-task', script: 'jira-api.cjs', subcommand: 'search',       description: 'Search Jira issues via JQL or keywords' },
+
+  // ── Asana (read) ──
+  { alias: 'get_asana_task',     skill: 'asana-task', script: 'asana-api.cjs', subcommand: 'get-task',     description: 'Fetch Asana task details' },
+  { alias: 'get_asana_subtasks', skill: 'asana-task', script: 'asana-api.cjs', subcommand: 'get-subtasks', description: 'List subtasks of an Asana task' },
+  { alias: 'get_asana_comments', skill: 'asana-task', script: 'asana-api.cjs', subcommand: 'get-comments', description: 'Fetch comments on an Asana task' },
+
+  // ── Git (read) ──
+  { alias: 'get_git_platform', shared: true, script: 'git-platform.cjs', subcommand: null, description: 'Detect git platform (GitHub/GitLab) from remote' },
+
+  // ── Asana (write) ──
+  { alias: 'update_asana_notes', skill: 'asana-task', script: 'asana-update-notes.cjs', subcommand: null, description: 'Write a named section to Asana task description (html_notes)', stdin: true },
+];
+
+// --- Build lookup map -------------------------------------------------------
+
+const fs = require('fs');
+const commandMap = new Map();
+for (const cmd of COMMANDS) {
+  let scriptPath;
+  if (cmd.shared) {
+    scriptPath = path.join(SCRIPTS_DIR, cmd.script);
+  } else {
+    // Priority: Try global shared skill first, then fall back to agent-specific skill
+    const sharedPath = path.join(SHARED_SKILLS_DIR, cmd.skill, 'scripts', cmd.script);
+    if (fs.existsSync(sharedPath)) {
+      scriptPath = sharedPath;
+    } else {
+      scriptPath = path.join(SKILLS_DIR, cmd.skill, 'scripts', cmd.script);
+    }
+  }
+
+  commandMap.set(cmd.alias, {
+    ...cmd,
+    scriptPath,
+  });
+}
+
+// --- Exports ----------------------------------------------------------------
+
+/** Get a single command by alias. Returns undefined if not found. */
+function getCommand(alias) {
+  return commandMap.get(alias);
+}
+
+/** List all commands, optionally grouped by skill. */
+function listCommands({ grouped = false } = {}) {
+  if (!grouped) return COMMANDS;
+
+  const groups = {};
+  for (const cmd of COMMANDS) {
+    const group = cmd.skill || 'shared';
+    if (!groups[group]) groups[group] = [];
+    groups[group].push(cmd);
+  }
+  return groups;
+}
+
+module.exports = { getCommand, listCommands };

package/agentic/shared/scripts/luna-cli/luna-cli.cjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * luna-cli.cjs
+ * CLI entry point that routes aliases to existing skill scripts.
+ *
+ * Usage:
+ *   luna <alias> [args...]     Route to skill script
+ *   luna --help                Show all available commands
+ *   luna --list                List aliases only
+ *
+ * Permission model:
+ *   get_*, list_*, search_*, read_*  → auto-approved via settings.json
+ *   update_*, create_*, set_*, delete_* → Claude Code prompts for approval
+ */
+
+'use strict';
+
+const { spawnSync } = require('child_process');
+const { getCommand, listCommands } = require('./command-registry.cjs');
+
+// --- Help output ------------------------------------------------------------
+
+function showHelp() {
+  const groups = listCommands({ grouped: true });
+
+  console.log('Luna CLI — Skill command router with permission control\n');
+  console.log('Usage: luna <command> [args...]\n');
+  console.log('Auto-approved (read):  get_*, list_*, search_*, read_*');
+  console.log('Prompted     (write):  update_*, create_*, set_*, delete_*\n');
+
+  for (const [skill, cmds] of Object.entries(groups)) {
+    console.log(`  ${skill}:`);
+    for (const cmd of cmds) {
+      const tag = /^(get_|list_|search_|read_)/.test(cmd.alias) ? '  ' : 'W ';
+      console.log(`    ${tag}${cmd.alias.padEnd(28)} ${cmd.description}`);
+    }
+    console.log();
+  }
+}
+
+function showList() {
+  const cmds = listCommands();
+  for (const cmd of cmds) {
+    console.log(cmd.alias);
+  }
+}
+
+// --- Main -------------------------------------------------------------------
+
+function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (args[0] === '--list') {
+    showList();
+    process.exit(0);
+  }
+
+  // Forward installer commands to bin/cli.js (luna -g, luna install, luna init, etc.)
+  const INSTALLER_COMMANDS = new Set([
+    '-g', '--global', 'install', 'init', 'migrate', 'add',
+    'version', '-v', '--version', 'help',
+  ]);
+  if (INSTALLER_COMMANDS.has(args[0])) {
+    const path = require('path');
+    const fs = require('fs');
+    const homeDir = require('os').homedir();
+    const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, '.claude');
+    const target = process.env.LUNA_AGENT || 'claude';
+    const isAntigravity = target === 'antigravity' || target === 'gemini';
+    const isOpencode = target === 'opencode';
+
+    let basePath;
+    if (isAntigravity) {
+      basePath = path.join(homeDir, '.gemini', 'antigravity');
+    } else if (isOpencode) {
+      basePath = path.join(homeDir, '.config', 'opencode');
+    } else {
+      basePath = claudeConfigDir;
+    }
+    const rootFile = path.join(basePath, '.luna-framework-root');
+    let frameworkRoot;
+    try {
+      frameworkRoot = fs.readFileSync(rootFile, 'utf8').trim();
+    } catch {
+      console.error('ERROR: Luna AI framework root not found.');
+      console.error('Please run the installer from the source directory first:');
+      console.error('  cd <luna-ai-project> && node bin/cli.js -g');
+      process.exit(1);
+    }
+    const cliPath = path.join(frameworkRoot, 'bin', 'cli.js');
+    if (!fs.existsSync(cliPath)) {
+      console.error(`ERROR: Framework installer not found at ${cliPath}`);
+      console.error('The framework source directory may have moved.');
+      process.exit(1);
+    }
+    const result = spawnSync(process.execPath, [cliPath, ...args], {
+      stdio: 'inherit',
+      env: process.env,
+    });
+    process.exit(result.status ?? 1);
+  }
+
+  const alias = args[0];
+  const restArgs = args.slice(1);
+  const cmd = getCommand(alias);
+
+  if (!cmd) {
+    console.error(`ERROR: Unknown command "${alias}"\n`);
+    console.error('Run "luna --help" to see available commands.');
+    process.exit(1);
+  }
+
+  // Build argv for the target script
+  const scriptArgs = [];
+  if (cmd.subcommand) scriptArgs.push(cmd.subcommand);
+  scriptArgs.push(...restArgs);
+
+  // Spawn the actual script, inheriting stdio for stdin piping support
+  const result = spawnSync(process.execPath, [cmd.scriptPath, ...scriptArgs], {
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  process.exit(result.status ?? 1);
+}
+
+main();

package/agentic/shared/scripts/set-active-plan.cjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+/**
+ * Update session state with a new active plan.
+ *
+ * Usage: node scripts/set-active-plan.cjs <plan-path>
+ *
+ * This script updates session state when available and always refreshes plans/ACTIVE
+ * so later steps can resolve the latest plan context.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Resolve luna-config-utils path gracefully across different execution contexts
+const possiblePaths = [
+  // 1. If executed globally from ~/.claude/scripts/ (standard case)
+  path.join(__dirname, '../hooks/lib/luna-config-utils.cjs'),
+  
+  // 2. If executed from agentic/shared/scripts/ via symlink pointing to here
+  path.join(__dirname, '../../claude/.claude/hooks/lib/luna-config-utils.cjs'),
+
+  // 3. Fallback for antigravity structure
+  path.join(__dirname, '../../antigravity/.agents/lib/luna-config-utils.cjs')
+];
+
+let utilsPath = null;
+for (const p of possiblePaths) {
+  if (fs.existsSync(p)) {
+    utilsPath = p;
+    break;
+  }
+}
+
+let writeSessionState = () => {};
+let readSessionState = () => null;
+
+if (utilsPath) {
+  try {
+    const utils = require(utilsPath);
+    if (typeof utils.writeSessionState === 'function') writeSessionState = utils.writeSessionState;
+    if (typeof utils.readSessionState === 'function') readSessionState = utils.readSessionState;
+  } catch (err) {
+    console.warn(`Warning: Failed to load luna-config-utils from ${utilsPath}: ${err.message}`);
+  }
+} else {
+  console.warn('Warning: luna-config-utils.cjs not found. Session state sync disabled; only plans/ACTIVE will be updated.');
+}
+
+const sessionId =
+  process.env.CLAUDE_SESSION_ID ||
+  process.env.LUNA_SESSION_ID ||
+  process.env.GEMINI_SESSION_ID ||
+  process.env.OPENCODE_SESSION_ID;
+const newPlan = process.argv[2];
+
+if (!newPlan) {
+  console.error('Error: Plan path required');
+  console.log('Usage: node scripts/set-active-plan.cjs <plan-path>');
+  console.log('Example: node scripts/set-active-plan.cjs plans/260331-1200-feature-name');
+  process.exit(1);
+}
+
+const absolutePlan = path.resolve(newPlan);
+
+if (!sessionId) {
+  console.warn('Warning: SESSION_ID not set - session state will not persist');
+  console.log(`Would set active plan to: ${absolutePlan}`);
+} else {
+  const current = readSessionState(sessionId) || {};
+  writeSessionState(sessionId, {
+    ...current,
+    activePlan: absolutePlan,
+    timestamp: Date.now()
+  });
+}
+
+// Also write to plans/ACTIVE file for backwards compatibility with active-file resolution
+try {
+  const plansDir = path.join(process.cwd(), 'plans');
+  if (!fs.existsSync(plansDir)) {
+    fs.mkdirSync(plansDir, { recursive: true });
+  }
+  const activeFile = path.join(plansDir, 'ACTIVE');
+  fs.writeFileSync(activeFile, absolutePlan, 'utf8');
+  console.log(`Active plan set to: ${absolutePlan}`);
+} catch (err) {
+  console.error(`Failed to write plans/ACTIVE: ${err.message}`);
+  process.exit(1);
+}
+
+process.exit(0);

package/agentic/shared/scripts/validate-agents.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * validate-agents.js — Validate agent YAML frontmatter in ~/.claude/agents/
+ *
+ * Usage:
+ *   node ~/.claude/scripts/validate-agents.js [agents-dir]
+ *   (global: node ~/.claude/scripts/validate-agents.js)
+ *
+ * Exit code:
+ *   0 = all agents valid (or only warnings)
+ *   1 = one or more agents have invalid YAML frontmatter
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const rootDir   = path.join(__dirname, '..', '..');
+
+const agentsDirArg = process.argv[2];
+const agentsDir = agentsDirArg
+  ? (path.isAbsolute(agentsDirArg) ? agentsDirArg : path.join(rootDir, agentsDirArg))
+  : path.join(rootDir, '.agents', 'agents');
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+let hasError = false;
+
+function fail(msg) { console.error(`  ❌ ${msg}`); hasError = true; }
+function ok(msg)   { console.log(`  ✅ ${msg}`); }
+function warn(msg) { console.log(`  ⚠️  ${msg}`); }
+
+/**
+ * Parse YAML frontmatter from markdown content.
+ * Returns { hasFrontmatter, fields } where fields is a key→value map.
+ */
+function parseFrontmatter(content) {
+  if (!content.startsWith('---')) return { hasFrontmatter: false, fields: {} };
+  const end = content.indexOf('\n---', 3);
+  if (end === -1) return { hasFrontmatter: false, fields: {} };
+  const block = content.slice(4, end);
+  const fields = {};
+  for (const line of block.split('\n')) {
+    const m = line.match(/^(\w[\w-]*):\s*(.*)$/);
+    if (m) fields[m[1]] = m[2].replace(/^["']|["']$/g, '').trim();
+  }
+  return { hasFrontmatter: true, fields };
+}
+
+// ─── Scan agents dir ──────────────────────────────────────────────────────────
+
+if (!fs.existsSync(agentsDir)) {
+  console.error(`❌ Agents directory not found: ${agentsDir}`);
+  process.exit(1);
+}
+
+const agentFiles = fs.readdirSync(agentsDir)
+  .filter(f => f.endsWith('.md'))
+  .sort();
+
+if (agentFiles.length === 0) {
+  console.error(`❌ No .md files found in: ${agentsDir}`);
+  process.exit(1);
+}
+
+console.log(`\n🔍 Validate agents: ${agentsDir}\n`);
+console.log(`   Found ${agentFiles.length} agent files\n`);
+
+const REQUIRED_FIELDS = ['name', 'description', 'tools'];
+
+let passCount  = 0;
+let warnCount  = 0;
+let failCount  = 0;
+
+for (const file of agentFiles) {
+  const filePath = path.join(agentsDir, file);
+  const content  = fs.readFileSync(filePath, 'utf-8');
+  const { hasFrontmatter, fields } = parseFrontmatter(content);
+
+  console.log(`📄 ${file}`);
+
+  if (!hasFrontmatter) {
+    warn('No YAML frontmatter — legacy Markdown format (add name/description/tools to enable routing)');
+    warnCount++;
+    continue;
+  }
+
+  let fileFail = false;
+  for (const field of REQUIRED_FIELDS) {
+    if (!fields[field] || fields[field].trim() === '') {
+      fail(`Missing required field: "${field}"`);
+      fileFail = true;
+    }
+  }
+
+  if (!fileFail) {
+    ok(`YAML valid — name: "${fields.name}", tools: ${fields.tools ? '✓' : 'empty'}`);
+    passCount++;
+  } else {
+    failCount++;
+  }
+}
+
+// ─── Summary ──────────────────────────────────────────────────────────────────
+
+console.log('\n─────────────────────────────────────────');
+console.log(`  ✅ PASS    : ${passCount}`);
+console.log(`  ⚠️  WARN    : ${warnCount}  (legacy format — no YAML frontmatter)`);
+console.log(`  ❌ FAIL    : ${failCount}`);
+console.log('─────────────────────────────────────────\n');
+
+if (hasError) {
+  console.error('🚫 AGENTS INVALID — fix YAML frontmatter before deploying.\n');
+  process.exit(1);
+} else {
+  const msg = warnCount > 0
+    ? `🎉 AGENTS VALID — ${warnCount} legacy-format agent(s) detected (non-blocking).\n`
+    : '🎉 AGENTS VALID — All agents have proper YAML frontmatter.\n';
+  console.log(msg);
+  process.exit(0);
+}

package/agentic/shared/skills/asana-task/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: lu:asana-task
+author: luna
+description: "Asana task skill: read tasks, subtasks, comments, write ID/TC, write QA testing instructions, implement features, fix bugs from Asana tasks. Triggers: 'asana task', 'asana subtasks', 'asana comments', 'update asana idtc', 'update asana qatest', 'implement asana task', 'fix asana task'."
+argument-hint: "[task-gid or URL]"
+---
+
+# Asana Task
+
+**Scope:** Read tasks, subtasks, comments + write ID/TC or QA Testing Instructions + implement features / fix bugs from Asana context.
+
+## Default (No Arguments)
+
+If invoked without a clear intent, present available operations:
+
+| Operation   | Description                                                   |
+| ----------- | ------------------------------------------------------------- |
+| `read`      | Fetch and display task details                                |
+| `subtasks`  | List subtasks of a task                                       |
+| `comments`  | Show comment thread                                           |
+| `id-tc`     | Write Implementation Detail + Testing Checklist to task notes |
+| `qa-test`   | Write QA Testing Instructions to task notes                   |
+| `implement` | Read task → delegate to `lu:cook` for implementation          |
+| `fix`       | Read task → delegate to `lu:fix` for bug fixing               |
+
+## Quick Reference
+
+| Task             | Command                                                        |
+| ---------------- | -------------------------------------------------------------- |
+| Get task details | `luna get_asana_task <gid-or-url>`                             |
+| Get subtasks     | `luna get_asana_subtasks <gid-or-url>`                         |
+| Get comments     | `luna get_asana_comments <gid-or-url>`                         |
+| Write ID/TC      | `luna update_asana_notes <gid> --file idtc.html --section "Implementation Detail"` |
+| Write QA Testing | `luna update_asana_notes <gid> --file qatest.html --section "QA Testing Instructions"` |
+
+| Reference                | File                                             |
+| ------------------------ | ------------------------------------------------ |
+| ID/TC generation         | `references/id-tc-workflow.md`                   |
+| QA testing instructions  | `references/qa-testing-instructions-workflow.md` |
+| Implement / Fix workflow | `references/implement-workflow.md`               |
+
+## Intent Detection
+
+| User intent    | Keywords                                                                   |
+| -------------- | -------------------------------------------------------------------------- |
+| **Read task**  | "asana task", "read asana", task GID or URL                                |
+| **Subtasks**   | "asana subtasks", "get subtasks"                                           |
+| **Comments**   | "asana comments", "read comments"                                          |
+| **ID/TC**      | "id-tc", "id/tc", "write id-tc", "generate id-tc", "update id-tc"          |
+| **QA Testing** | "qa-test", "qa test", "write qa", "generate qa", "qa testing instructions" |
+| **Implement**  | "implement asana", "cook asana", "build from asana"                        |
+| **Fix bug**    | "fix asana", "fix bug asana", "debug asana task"                           |
+
+---
+
+## Core Workflow
+
+### Step 1: Resolve Task
+
+Extract task GID from input — supports GID or URL.
+
+```bash
+luna get_asana_task <task-gid-or-url>
+```
+
+**URL patterns supported:**
+
+- `https://app.asana.com/0/PROJECT_GID/TASK_GID`
+- `https://app.asana.com/0/PROJECT_GID/TASK_GID/f`
+- `https://app.asana.com/0/PROJECT_GID/list?taskId=TASK_GID`
+- `https://app.asana.com/1/WORKSPACE_GID/project/PROJECT_GID/task/TASK_GID`
+- `https://app.asana.com/1/WORKSPACE_GID/project/PROJECT_GID/task/TASK_GID?focus=true`
+
+### Step 2: Display Summary
+
+```
+## Asana Task: [NAME]
+- **GID**: 1234567890
+- **Type**: default_task / milestone / approval
+- **Assignee**: [name]
+- **Section**: [section name]
+- **Project**: [project name]
+- **Due**: [due_on]
+- **Status**: [completed: true/false]
+- **Tags**: [tags]
+- **Subtasks**: [num_subtasks] items
+- **Parent**: [parent name] (if subtask)
+- **Created**: [date] | **Modified**: [date]
+- **Description**: [first 3 lines or "See full description below"]
+```
+
+### Step 3: Execute Action
+
+Based on detected intent, proceed to the appropriate action:
+
+#### Read (subtasks / comments)
+
+```bash
+luna get_asana_subtasks <task-gid>   # checklist with assignee, due, status
+luna get_asana_comments <task-gid>   # user comments only, system stories filtered
+```
+
+#### ID/TC — Write Implementation Detail + Testing Checklist
+
+Follow `references/id-tc-workflow.md` exactly.
+
+> ⚠️ CRITICAL: The ONLY Asana action is writing ID/TC to task notes. Do NOT update status, do NOT comment, do NOT perform any other Asana action.
+
+#### QA Testing — Write QA Testing Instructions
+
+Follow `references/qa-testing-instructions-workflow.md` exactly.
+
+> ⚠️ CRITICAL: The ONLY Asana action is writing QA Testing Instructions to task notes. Do NOT update status, do NOT comment, do NOT perform any other Asana action.
+
+#### Implement — Build feature from Asana task
+
+Follow `references/implement-workflow.md` exactly. Delegates to `lu:cook`.
+
+#### Fix Bug — Debug + fix from Asana task
+
+Follow `references/implement-workflow.md` exactly. Delegates to `lu:fix`.

package/agentic/shared/skills/asana-task/references/id-tc-workflow.md

@@ -0,0 +1,75 @@
+# ID/TC Generation for Asana
+
+Generate Implementation Detail (ID) and Testing Checklist (TC) for an Asana task from PR.
+
+**⚠️ CRITICAL RULE**: When generating ID/TC (both auto and standalone), the ONLY action is writing ID/TC content to the task notes/description. Do NOT update task status, do NOT post comments, do NOT perform any other Asana action. ID/TC generation = notes update ONLY.
+
+## Process
+
+### 1. Locate PR / MR
+
+Detect platform:
+
+```bash
+luna get_git_platform
+# Output: {"platform":"github|gitlab","cli":"gh|glab","authenticated":true,"remote":"..."}
+```
+
+**GitHub:**
+
+```bash
+gh pr view HEAD --json url,title,body,files
+```
+
+**GitLab:**
+
+```bash
+glab mr view --source-branch "$(git branch --show-current)"
+```
+
+If PR/MR URL found in task notes or comments:
+
+```bash
+# GitHub
+gh pr view <pr-url> --json title,body,files
+# GitLab
+glab mr view <mr-id>
+```
+
+If no PR/MR found → generate from task description only.
+
+### 2. Generate Content
+
+**Implementation Detail** — SHORT bullet points:
+
+- 1 line each, max 3-5 bullets
+- Focus on WHAT changed, not HOW
+- Use imperative form: "Add...", "Fix...", "Update..."
+- Example: `Add permission check for Champion role`
+- NOT: `Added a new permission check that verifies whether the user has Champion role`
+- **Highlight** specific values (labels, text, names) with `<code>`:
+  - Example: `Update <code>Webinar Series</code> text to <code>Recordings</code>`
+
+**Testing Checklist** — SHORT test cases:
+
+- Start with action verb: Verify, Check, Confirm, Test
+- 1 specific behavior per checkbox, max 5-7 items
+- Example: `- [ ] Verify Champion can view blockwalks`
+- NOT: `- [ ] Verify that a user with Champion role is able to view the blockwalks section`
+
+**Files** — concise list:
+
+- Filenames only (not full paths) when possible
+- Group by directory if many files
+
+### 3. Run Update Script
+
+Write the generated content in HTML format to a local temporary file (e.g., `idtc.html` in the current working directory) using the template at `skills/asana-task/templates/id-tc.html` inside your agent's config directory (e.g., `~/.claude/skills/asana-task/templates/id-tc.html`), then call via `luna`:
+
+**⚠️ CRITICAL:** Do NOT use `/tmp/` or absolute paths outside the context directory. Create the file locally (e.g., `./idtc.html`) to avoid "Error writing file" permission issues.
+
+```bash
+# Generate content to idtc.html, then:
+luna update_asana_notes {task_gid} --file idtc.html --section "Implementation Detail"
+rm idtc.html
+```