diff --git a/src/components/guides/commands/command-card-details.astro b/src/components/guides/commands/command-card-details.astro
new file mode 100644
index 0000000..4fa9e74
--- /dev/null
+++ b/src/components/guides/commands/command-card-details.astro
@@ -0,0 +1,193 @@
+---
+// Renders chip rows (subcommands/args/flags/betaFlags) followed by a
+// "Details" trigger that opens a native <dialog> modal listing each
+// chip with its 1-line explanation. Card height stays constant so the
+// CSS grid does not jump. Accepts both legacy string chips (MK) and
+// structured ChipItem chips (EK migrated in Phase 1); only chips
+// carrying a descKey appear in the modal definition list.
+import { chipDescKey, chipName, type Chip, type CommandItem, type TranslationFn } from "@/data/guides/commands-types";
+
+interface Props {
+  cmd: CommandItem;
+  t: TranslationFn;
+}
+
+const { cmd, t } = Astro.props;
+
+type Section = {
+  kind: "subcommand" | "arg" | "flag" | "betaFlag";
+  headerKey: string;
+  chips: Chip[];
+};
+
+const sections: Section[] = [
+  { kind: "subcommand", headerKey: "commands.details.section.subcommands", chips: cmd.subcommands ?? [] },
+  { kind: "arg",        headerKey: "commands.details.section.args",        chips: cmd.args ?? [] },
+  { kind: "flag",       headerKey: "commands.details.section.flags",       chips: cmd.flags ?? [] },
+  { kind: "betaFlag",   headerKey: "commands.details.section.beta_flags",  chips: cmd.betaFlags ?? [] },
+];
+
+// Sections with at least one chip carrying a descKey contribute rows
+// to the modal definition list. Empty descKey sections are skipped.
+const detailSections = sections
+  .map((s) => ({ ...s, rows: s.chips.filter((c) => chipDescKey(c) !== null) }))
+  .filter((s) => s.rows.length > 0);
+
+const hasDetails = detailSections.length > 0;
+
+// Counter on the trigger button, e.g. "3 subcommands · 8 flags"
+const counterParts = sections
+  .map((s) => {
+    if (s.chips.length === 0) return null;
+    const label = t(`commands.details.count.${s.kind === "betaFlag" ? "beta_flag" : s.kind}`);
+    return `${s.chips.length} ${label}`;
+  })
+  .filter((x): x is string => x !== null);
+
+// Stable DOM id for the dialog. cmd.command shape: "/ck:plan", "/mkt:ask".
+const dialogId = `cmd-dialog-${cmd.command.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase()}`;
+---
+
+{/* Subcommands chips (purple) */}
+{cmd.subcommands && cmd.subcommands.length > 0 && (
+  <div class="flex flex-wrap gap-1 mt-1.5">
+    {cmd.subcommands.map((sub: Chip) => (
+      <code class="text-[9px] px-1 py-0.5 rounded bg-purple-100 dark:bg-purple-900/30 text-purple-600 dark:text-purple-400 font-mono">
+        {chipName(sub)}
+      </code>
+    ))}
+  </div>
+)}
+
+{/* Args chips (slate) */}
+{cmd.args && cmd.args.length > 0 && (
+  <div class="flex flex-wrap gap-1 mt-1.5">
+    {cmd.args.map((arg: Chip) => (
+      <code class="text-[9px] px-1 py-0.5 rounded bg-slate-200 dark:bg-slate-700 text-slate-600 dark:text-slate-400 font-mono">
+        {chipName(arg)}
+      </code>
+    ))}
+  </div>
+)}
+
+{/* Flags + betaFlags chips */}
+{((cmd.flags && cmd.flags.length > 0) || (cmd.betaFlags && cmd.betaFlags.length > 0)) && (
+  <div class="flex flex-wrap gap-1 mt-1.5">
+    {cmd.flags && cmd.flags.map((flag: Chip) => (
+      <code class="text-[9px] px-1 py-0.5 rounded bg-teal-100 dark:bg-teal-900/30 text-teal-600 dark:text-teal-400 font-mono">
+        {chipName(flag)}
+      </code>
+    ))}
+    {cmd.betaFlags && cmd.betaFlags.map((flag: Chip) => (
+      <code class="text-[9px] px-1 py-0.5 rounded bg-amber-100 dark:bg-amber-900/30 text-amber-600 dark:text-amber-400 font-mono">
+        {chipName(flag)} <span class="text-[7px] font-bold uppercase">beta</span>
+      </code>
+    ))}
+  </div>
+)}
+
+{/* Details trigger + modal */}
+{hasDetails && (
+  <>
+    <button
+      type="button"
+      class="cmd-details-trigger mt-2 text-[11px] text-slate-500 dark:text-slate-400 hover:text-slate-700 dark:hover:text-slate-200 cursor-pointer select-none flex items-center gap-1.5"
+      data-dialog-target={dialogId}
+    >
+      <svg class="w-3 h-3" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <circle cx="12" cy="12" r="10"></circle>
+        <line x1="12" y1="16" x2="12" y2="12"></line>
+        <line x1="12" y1="8" x2="12.01" y2="8"></line>
+      </svg>
+      <span>{t("commands.details.button")}</span>
+      {counterParts.length > 0 && (
+        <span class="text-slate-400 dark:text-slate-500">· {counterParts.join(" · ")}</span>
+      )}
+    </button>
+
+    <dialog id={dialogId} class="cmd-dialog backdrop:bg-slate-900/60 backdrop:backdrop-blur-sm rounded-xl p-0 w-[min(92vw,520px)] max-h-[80vh] bg-white dark:bg-slate-900 text-slate-700 dark:text-slate-200 shadow-2xl border border-slate-200 dark:border-slate-700/50">
+      <div class="sticky top-0 flex items-center justify-between gap-3 px-4 py-3 border-b border-slate-100 dark:border-slate-800 bg-white dark:bg-slate-900 rounded-t-xl">
+        <div class="flex items-center gap-2 min-w-0">
+          <code class="text-sm font-mono text-purple-600 dark:text-purple-400 truncate">{cmd.command}</code>
+          {counterParts.length > 0 && (
+            <span class="text-[10px] text-slate-400 dark:text-slate-500 truncate">· {counterParts.join(" · ")}</span>
+          )}
+        </div>
+        <button
+          type="button"
+          class="cmd-dialog-close shrink-0 w-6 h-6 flex items-center justify-center rounded text-slate-400 hover:text-slate-700 dark:hover:text-slate-200 hover:bg-slate-100 dark:hover:bg-slate-800"
+          aria-label={t("commands.details.close")}
+        >
+          <svg class="w-4 h-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <line x1="18" y1="6" x2="6" y2="18"></line>
+            <line x1="6" y1="6" x2="18" y2="18"></line>
+          </svg>
+        </button>
+      </div>
+      <div class="px-4 py-3 overflow-y-auto max-h-[calc(80vh-3.25rem)] space-y-3">
+        {detailSections.map((section) => (
+          <div>
+            <div class="text-[9px] uppercase tracking-wider text-slate-400 dark:text-slate-500 font-semibold mb-1.5">
+              {t(section.headerKey)}
+            </div>
+            <dl class="grid grid-cols-[auto_1fr] gap-x-3 gap-y-1.5">
+              {section.rows.map((chip) => {
+                const key = chipDescKey(chip);
+                const desc = key ? t(key) : "";
+                const chipClass =
+                  section.kind === "subcommand"
+                    ? "bg-purple-100 dark:bg-purple-900/30 text-purple-600 dark:text-purple-400"
+                    : section.kind === "arg"
+                    ? "bg-slate-200 dark:bg-slate-700 text-slate-600 dark:text-slate-400"
+                    : section.kind === "betaFlag"
+                    ? "bg-amber-100 dark:bg-amber-900/30 text-amber-600 dark:text-amber-400"
+                    : "bg-teal-100 dark:bg-teal-900/30 text-teal-600 dark:text-teal-400";
+                return (
+                  <>
+                    <dt class={`text-[11px] px-1.5 py-0.5 rounded font-mono self-start ${chipClass}`}>
+                      {chipName(chip)}
+                    </dt>
+                    <dd class="text-[12px] leading-snug text-slate-600 dark:text-slate-300">
+                      {desc || <span class="italic text-slate-400 dark:text-slate-500">—</span>}
+                    </dd>
+                  </>
+                );
+              })}
+            </dl>
+          </div>
+        ))}
+      </div>
+    </dialog>
+  </>
+)}
+
+<script>
+  // One hoisted bundle wires every trigger + dialog on the page.
+  // Click outside content closes; <dialog> native handles Esc + focus trap.
+  document.querySelectorAll<HTMLButtonElement>(".cmd-details-trigger").forEach((btn) => {
+    btn.addEventListener("click", (e) => {
+      e.stopPropagation();
+      const id = btn.dataset.dialogTarget;
+      if (!id) return;
+      const dlg = document.getElementById(id) as HTMLDialogElement | null;
+      dlg?.showModal();
+    });
+  });
+  document.querySelectorAll<HTMLDialogElement>("dialog.cmd-dialog").forEach((dlg) => {
+    dlg.addEventListener("click", (e) => {
+      if (e.target === dlg) dlg.close();
+    });
+    dlg.querySelector(".cmd-dialog-close")?.addEventListener("click", () => dlg.close());
+  });
+</script>
+
+<style is:global>
+  /* Force-center the modal — some Tailwind resets neutralize the
+     UA default (position: fixed + inset: 0 + margin: auto) on
+     top-layer <dialog>. Re-apply explicitly. */
+  dialog.cmd-dialog[open] {
+    position: fixed;
+    inset: 0;
+    margin: auto;
+  }
+</style>
diff --git a/src/components/guides/commands/commands-categories-grid.astro b/src/components/guides/commands/commands-categories-grid.astro
index 1bddf2c..aed936d 100644
--- a/src/components/guides/commands/commands-categories-grid.astro
+++ b/src/components/guides/commands/commands-categories-grid.astro
@@ -5,6 +5,7 @@ import { getLangFromUrl, type Language } from "@/i18n";
 import { getEngineerKitCategories } from "@/data/guides/commands-engineer-kit";
 import { getMarketingKitCategories } from "@/data/guides/commands-marketing-kit";
 import { styles } from "@/data/guides/commands-styles";
+import CommandCardDetails from "./command-card-details.astro";
 
 interface Props {
   lang?: Language;
@@ -152,41 +153,7 @@ const marketingCategories = getMarketingKitCategories(t as any);
                   <span class="text-purple-500 dark:text-purple-400">{cmd.betaNote}</span>
                 </div>
               )}
-              {/* Subcommands (space-separated) */}
-              {cmd.subcommands && cmd.subcommands.length > 0 && (
-                <div class="flex flex-wrap gap-1 mt-1.5">
-                  {cmd.subcommands.map((sub: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-purple-100 dark:bg-purple-900/30 text-purple-600 dark:text-purple-400 font-mono">
-                      {sub}
-                    </code>
-                  ))}
-                </div>
-              )}
-              {/* Arguments (space-separated) */}
-              {cmd.args && cmd.args.length > 0 && (
-                <div class="flex flex-wrap gap-1 mt-1.5">
-                  {cmd.args.map((arg: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-slate-200 dark:bg-slate-700 text-slate-600 dark:text-slate-400 font-mono">
-                      {arg}
-                    </code>
-                  ))}
-                </div>
-              )}
-              {/* Flags (dash-prefixed) */}
-              {cmd.flags && cmd.flags.length > 0 && (
-                <div class="flex flex-wrap gap-1 mt-1.5">
-                  {cmd.flags.map((flag: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-teal-100 dark:bg-teal-900/30 text-teal-600 dark:text-teal-400 font-mono">
-                      {flag}
-                    </code>
-                  ))}
-                  {cmd.betaFlags && cmd.betaFlags.map((flag: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-amber-100 dark:bg-amber-900/30 text-amber-600 dark:text-amber-400 font-mono">
-                      {flag} <span class="text-[7px] font-bold uppercase">beta</span>
-                    </code>
-                  ))}
-                </div>
-              )}
+              <CommandCardDetails cmd={cmd} t={t as any} />
               {cmd.replacedCommand && (
                 <p class="text-[10px] text-slate-500 mt-1 flex items-center gap-1">
                   <svg class="w-3 h-3" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
@@ -297,41 +264,7 @@ const marketingCategories = getMarketingKitCategories(t as any);
                   <span class="text-purple-500 dark:text-purple-400">{cmd.betaNote}</span>
                 </div>
               )}
-              {/* Subcommands (space-separated) */}
-              {cmd.subcommands && cmd.subcommands.length > 0 && (
-                <div class="flex flex-wrap gap-1 mt-1.5">
-                  {cmd.subcommands.map((sub: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-purple-100 dark:bg-purple-900/30 text-purple-600 dark:text-purple-400 font-mono">
-                      {sub}
-                    </code>
-                  ))}
-                </div>
-              )}
-              {/* Arguments (space-separated) */}
-              {cmd.args && cmd.args.length > 0 && (
-                <div class="flex flex-wrap gap-1 mt-1.5">
-                  {cmd.args.map((arg: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-slate-200 dark:bg-slate-700 text-slate-600 dark:text-slate-400 font-mono">
-                      {arg}
-                    </code>
-                  ))}
-                </div>
-              )}
-              {/* Flags (dash-prefixed) */}
-              {cmd.flags && cmd.flags.length > 0 && (
-                <div class="flex flex-wrap gap-1 mt-1.5">
-                  {cmd.flags.map((flag: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-teal-100 dark:bg-teal-900/30 text-teal-600 dark:text-teal-400 font-mono">
-                      {flag}
-                    </code>
-                  ))}
-                  {cmd.betaFlags && cmd.betaFlags.map((flag: string) => (
-                    <code class="text-[9px] px-1 py-0.5 rounded bg-amber-100 dark:bg-amber-900/30 text-amber-600 dark:text-amber-400 font-mono">
-                      {flag} <span class="text-[7px] font-bold uppercase">beta</span>
-                    </code>
-                  ))}
-                </div>
-              )}
+              <CommandCardDetails cmd={cmd} t={t as any} />
               {/* Beta syntax footer note */}
               {cmd.betaSyntax && (
                 <div class="mt-1.5 pt-1.5 border-t border-purple-200/50 dark:border-purple-800/30 text-[10px] flex items-center gap-1">
diff --git a/src/data/guides/commands-engineer-kit.ts b/src/data/guides/commands-engineer-kit.ts
index e6ea91e..3992876 100644
--- a/src/data/guides/commands-engineer-kit.ts
+++ b/src/data/guides/commands-engineer-kit.ts
@@ -38,7 +38,7 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.ask.desc"),
           detail: t("commands.stable.ask.detail"),
           isSkill: true,
-          args: ["[question]"],
+          args: [{ name: "[question]", descKey: "commands.stable.ask.arg.question" }],
           step: 2,
         },
         // Step 3: Brainstorm ideas
@@ -59,8 +59,21 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.plan.desc"),
           detail: t("commands.stable.plan.detail"),
           isSkill: true,
-          subcommands: ["archive", "red-team", "validate"],
-          flags: ["--auto", "--fast", "--hard", "--parallel", "--two", "--no-tasks", "--deep", "--tdd"],
+          subcommands: [
+            { name: "archive", descKey: "commands.stable.plan.subcommand.archive" },
+            { name: "red-team", descKey: "commands.stable.plan.subcommand.red_team" },
+            { name: "validate", descKey: "commands.stable.plan.subcommand.validate" },
+          ],
+          flags: [
+            { name: "--auto", descKey: "commands.stable.plan.flag.auto" },
+            { name: "--fast", descKey: "commands.stable.plan.flag.fast" },
+            { name: "--hard", descKey: "commands.stable.plan.flag.hard" },
+            { name: "--parallel", descKey: "commands.stable.plan.flag.parallel" },
+            { name: "--two", descKey: "commands.stable.plan.flag.two" },
+            { name: "--no-tasks", descKey: "commands.stable.plan.flag.no_tasks" },
+            { name: "--deep", descKey: "commands.stable.plan.flag.deep" },
+            { name: "--tdd", descKey: "commands.stable.plan.flag.tdd" },
+          ],
           step: 4,
         },
         // Step 5: Execute plan
@@ -71,7 +84,14 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.cook.desc"),
           detail: t("commands.stable.cook.detail"),
           isSkill: true,
-          flags: ["--interactive", "--fast", "--parallel", "--auto", "--no-test", "--tdd"],
+          flags: [
+            { name: "--interactive", descKey: "commands.stable.cook.flag.interactive" },
+            { name: "--fast", descKey: "commands.stable.cook.flag.fast" },
+            { name: "--parallel", descKey: "commands.stable.cook.flag.parallel" },
+            { name: "--auto", descKey: "commands.stable.cook.flag.auto" },
+            { name: "--no-test", descKey: "commands.stable.cook.flag.no_test" },
+            { name: "--tdd", descKey: "commands.stable.cook.flag.tdd" },
+          ],
           step: 5,
         },
       ],
@@ -97,7 +117,7 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.research.desc"),
           detail: t("commands.stable.research.detail"),
           isSkill: true,
-          args: ["[topic]"],
+          args: [{ name: "[topic]", descKey: "commands.stable.research.arg.topic" }],
         },
         {
           command: "/ck:scout",
@@ -106,7 +126,10 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.scout.desc"),
           detail: t("commands.stable.scout.detail"),
           isSkill: true,
-          args: ["[search-target]", "[ext]"],
+          args: [
+            { name: "[search-target]", descKey: "commands.stable.scout.arg.search_target" },
+            { name: "[ext]", descKey: "commands.stable.scout.arg.ext" },
+          ],
         },
         {
           command: "/ck:plan",
@@ -115,8 +138,21 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.plan.desc"),
           detail: t("commands.stable.plan.detail"),
           isSkill: true,
-          subcommands: ["archive", "red-team", "validate"],
-          flags: ["--auto", "--fast", "--hard", "--parallel", "--two", "--no-tasks", "--deep", "--tdd"],
+          subcommands: [
+            { name: "archive", descKey: "commands.stable.plan.subcommand.archive" },
+            { name: "red-team", descKey: "commands.stable.plan.subcommand.red_team" },
+            { name: "validate", descKey: "commands.stable.plan.subcommand.validate" },
+          ],
+          flags: [
+            { name: "--auto", descKey: "commands.stable.plan.flag.auto" },
+            { name: "--fast", descKey: "commands.stable.plan.flag.fast" },
+            { name: "--hard", descKey: "commands.stable.plan.flag.hard" },
+            { name: "--parallel", descKey: "commands.stable.plan.flag.parallel" },
+            { name: "--two", descKey: "commands.stable.plan.flag.two" },
+            { name: "--no-tasks", descKey: "commands.stable.plan.flag.no_tasks" },
+            { name: "--deep", descKey: "commands.stable.plan.flag.deep" },
+            { name: "--tdd", descKey: "commands.stable.plan.flag.tdd" },
+          ],
         },
         {
           command: "/ck:sequential-thinking",
@@ -158,7 +194,10 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.predict.desc"),
           detail: t("commands.stable.predict.detail"),
           isSkill: true,
-          flags: ["--chain reason", "--chain probe"],
+          flags: [
+            { name: "--chain reason", descKey: "commands.stable.predict.flag.chain_reason" },
+            { name: "--chain probe", descKey: "commands.stable.predict.flag.chain_probe" },
+          ],
         },
         {
           command: "/ck:xia",
@@ -167,8 +206,18 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.xia.desc"),
           detail: t("commands.stable.xia.detail"),
           isSkill: true,
-          args: ["<github-url|owner/repo|local-path>", "[feature]"],
-          flags: ["--compare", "--copy", "--improve", "--port", "--auto", "--fast"],
+          args: [
+            { name: "<github-url|owner/repo|local-path>", descKey: "commands.stable.xia.arg.target" },
+            { name: "[feature]", descKey: "commands.stable.xia.arg.feature" },
+          ],
+          flags: [
+            { name: "--compare", descKey: "commands.stable.xia.flag.compare" },
+            { name: "--copy", descKey: "commands.stable.xia.flag.copy" },
+            { name: "--improve", descKey: "commands.stable.xia.flag.improve" },
+            { name: "--port", descKey: "commands.stable.xia.flag.port" },
+            { name: "--auto", descKey: "commands.stable.xia.flag.auto" },
+            { name: "--fast", descKey: "commands.stable.xia.flag.fast" },
+          ],
         },
       ],
     },
@@ -217,8 +266,15 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.stitch.desc"),
           detail: t("commands.stable.stitch.detail"),
           isSkill: true,
-          subcommands: ["generate", "export"],
-          flags: ["--format all", "--format html", "--device mobile"],
+          subcommands: [
+            { name: "generate", descKey: "commands.stable.stitch.subcommand.generate" },
+            { name: "export", descKey: "commands.stable.stitch.subcommand.export" },
+          ],
+          flags: [
+            { name: "--format all", descKey: "commands.stable.stitch.flag.format_all" },
+            { name: "--format html", descKey: "commands.stable.stitch.flag.format_html" },
+            { name: "--device mobile", descKey: "commands.stable.stitch.flag.device_mobile" },
+          ],
         },
         {
           command: "/ck:ui-ux-pro-max",
@@ -291,7 +347,13 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.ai_artist.desc"),
           detail: t("commands.stable.ai_artist.detail"),
           isSkill: true,
-          flags: ["--mode search", "--mode creative", "--mode wild", "--mode all", "--skip"],
+          flags: [
+            { name: "--mode search", descKey: "commands.stable.ai_artist.flag.mode_search" },
+            { name: "--mode creative", descKey: "commands.stable.ai_artist.flag.mode_creative" },
+            { name: "--mode wild", descKey: "commands.stable.ai_artist.flag.mode_wild" },
+            { name: "--mode all", descKey: "commands.stable.ai_artist.flag.mode_all" },
+            { name: "--skip", descKey: "commands.stable.ai_artist.flag.skip" },
+          ],
         },
         {
           command: "/ck:media-processing",
@@ -324,7 +386,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.bootstrap.desc"),
           detail: t("commands.stable.bootstrap.detail"),
           isSkill: true,
-          flags: ["--full", "--auto", "--fast", "--parallel"],
+          flags: [
+            { name: "--full", descKey: "commands.stable.bootstrap.flag.full" },
+            { name: "--auto", descKey: "commands.stable.bootstrap.flag.auto" },
+            { name: "--fast", descKey: "commands.stable.bootstrap.flag.fast" },
+            { name: "--parallel", descKey: "commands.stable.bootstrap.flag.parallel" },
+          ],
         },
         {
           command: "/ck:backend-development",
@@ -381,7 +448,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.ship.desc"),
           detail: t("commands.stable.ship.detail"),
           isSkill: true,
-          flags: ["--official", "--beta", "--skip-tests", "--skip-review"],
+          flags: [
+            { name: "--official", descKey: "commands.stable.ship.flag.official" },
+            { name: "--beta", descKey: "commands.stable.ship.flag.beta" },
+            { name: "--skip-tests", descKey: "commands.stable.ship.flag.skip_tests" },
+            { name: "--skip-review", descKey: "commands.stable.ship.flag.skip_review" },
+          ],
         },
         {
           command: "/ck:mobile-development",
@@ -398,7 +470,13 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.team.desc"),
           detail: t("commands.stable.team.detail"),
           isSkill: true,
-          flags: ["<template> <context>", "--devs N", "--researchers N", "--reviewers N", "--delegate"],
+          flags: [
+            { name: "<template> <context>", descKey: "commands.stable.team.flag.template_context" },
+            { name: "--devs N", descKey: "commands.stable.team.flag.devs" },
+            { name: "--researchers N", descKey: "commands.stable.team.flag.researchers" },
+            { name: "--reviewers N", descKey: "commands.stable.team.flag.reviewers" },
+            { name: "--delegate", descKey: "commands.stable.team.flag.delegate" },
+          ],
         },
         {
           command: "/ck:deploy",
@@ -407,7 +485,10 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.deploy.desc"),
           detail: t("commands.stable.deploy.detail"),
           isSkill: true,
-          args: ["[platform]", "[environment]"],
+          args: [
+            { name: "[platform]", descKey: "commands.stable.deploy.arg.platform" },
+            { name: "[environment]", descKey: "commands.stable.deploy.arg.environment" },
+          ],
         },
         {
           command: "/ck:cook",
@@ -416,7 +497,14 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.cook.desc"),
           detail: t("commands.stable.cook.detail"),
           isSkill: true,
-          flags: ["--interactive", "--fast", "--parallel", "--auto", "--no-test", "--tdd"],
+          flags: [
+            { name: "--interactive", descKey: "commands.stable.cook.flag.interactive" },
+            { name: "--fast", descKey: "commands.stable.cook.flag.fast" },
+            { name: "--parallel", descKey: "commands.stable.cook.flag.parallel" },
+            { name: "--auto", descKey: "commands.stable.cook.flag.auto" },
+            { name: "--no-test", descKey: "commands.stable.cook.flag.no_test" },
+            { name: "--tdd", descKey: "commands.stable.cook.flag.tdd" },
+          ],
         },
       ],
     },
@@ -433,7 +521,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.git.desc"),
           detail: t("commands.stable.git.detail"),
           isSkill: true,
-          flags: ["cm", "cp", "pr", "merge"],
+          flags: [
+            { name: "cm", descKey: "commands.stable.git.flag.cm" },
+            { name: "cp", descKey: "commands.stable.git.flag.cp" },
+            { name: "pr", descKey: "commands.stable.git.flag.pr" },
+            { name: "merge", descKey: "commands.stable.git.flag.merge" },
+          ],
         },
         {
           command: "/ck:worktree",
@@ -458,7 +551,10 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.test.desc"),
           detail: t("commands.stable.test.detail"),
           isSkill: true,
-          flags: ["[context]", "ui [url]"],
+          flags: [
+            { name: "[context]", descKey: "commands.stable.test.flag.context" },
+            { name: "ui [url]", descKey: "commands.stable.test.flag.ui_url" },
+          ],
         },
         {
           command: "/ck:code-review",
@@ -467,7 +563,14 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.code_review.desc"),
           detail: t("commands.stable.code_review.detail"),
           isSkill: true,
-          flags: ["[context]", "#PR", "COMMIT", "--pending", "codebase", "codebase parallel"],
+          flags: [
+            { name: "[context]", descKey: "commands.stable.code_review.flag.context" },
+            { name: "#PR", descKey: "commands.stable.code_review.flag.pr" },
+            { name: "COMMIT", descKey: "commands.stable.code_review.flag.commit" },
+            { name: "--pending", descKey: "commands.stable.code_review.flag.pending" },
+            { name: "codebase", descKey: "commands.stable.code_review.flag.codebase" },
+            { name: "codebase parallel", descKey: "commands.stable.code_review.flag.codebase_parallel" },
+          ],
         },
         {
           command: "/ck:fix",
@@ -476,7 +579,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.fix.desc"),
           detail: t("commands.stable.fix.detail"),
           isSkill: true,
-          flags: ["--auto", "--review", "--quick", "--parallel"],
+          flags: [
+            { name: "--auto", descKey: "commands.stable.fix.flag.auto" },
+            { name: "--review", descKey: "commands.stable.fix.flag.review" },
+            { name: "--quick", descKey: "commands.stable.fix.flag.quick" },
+            { name: "--parallel", descKey: "commands.stable.fix.flag.parallel" },
+          ],
         },
         {
           command: "/ck:debug",
@@ -509,7 +617,10 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.scenario.desc"),
           detail: t("commands.stable.scenario.detail"),
           isSkill: true,
-          flags: ["--saturation", "--iterations"],
+          flags: [
+            { name: "--saturation", descKey: "commands.stable.scenario.flag.saturation" },
+            { name: "--iterations", descKey: "commands.stable.scenario.flag.iterations" },
+          ],
         },
       ],
     },
@@ -526,7 +637,11 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.security.desc"),
           detail: t("commands.stable.security.detail"),
           isSkill: true,
-          flags: ["--fix", "--red-team", "--iterations"],
+          flags: [
+            { name: "--fix", descKey: "commands.stable.security.flag.fix" },
+            { name: "--red-team", descKey: "commands.stable.security.flag.red_team" },
+            { name: "--iterations", descKey: "commands.stable.security.flag.iterations" },
+          ],
         },
         {
           command: "/ck:security-scan",
@@ -535,8 +650,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.security_scan.desc"),
           detail: t("commands.stable.security_scan.detail"),
           isSkill: true,
-          args: ["[scope]"],
-          flags: ["--secrets-only", "--deps-only", "--full"],
+          args: [{ name: "[scope]", descKey: "commands.stable.security_scan.arg.scope" }],
+          flags: [
+            { name: "--secrets-only", descKey: "commands.stable.security_scan.flag.secrets_only" },
+            { name: "--deps-only", descKey: "commands.stable.security_scan.flag.deps_only" },
+            { name: "--full", descKey: "commands.stable.security_scan.flag.full" },
+          ],
         },
         {
           command: "/ck:better-auth",
@@ -553,8 +672,14 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.cti_expert.desc"),
           detail: t("commands.stable.cti_expert.detail"),
           isSkill: true,
-          args: ["[target]"],
-          flags: ["--yolo", "--case", "--sweep", "--query", "--flow"],
+          args: [{ name: "[target]", descKey: "commands.stable.cti_expert.arg.target" }],
+          flags: [
+            { name: "--yolo", descKey: "commands.stable.cti_expert.flag.yolo" },
+            { name: "--case", descKey: "commands.stable.cti_expert.flag.case" },
+            { name: "--sweep", descKey: "commands.stable.cti_expert.flag.sweep" },
+            { name: "--query", descKey: "commands.stable.cti_expert.flag.query" },
+            { name: "--flow", descKey: "commands.stable.cti_expert.flag.flow" },
+          ],
         },
       ],
     },
@@ -571,7 +696,11 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.docs.desc"),
           detail: t("commands.stable.docs.detail"),
           isSkill: true,
-          flags: ["init", "update", "summarize"],
+          flags: [
+            { name: "init", descKey: "commands.stable.docs.flag.init" },
+            { name: "update", descKey: "commands.stable.docs.flag.update" },
+            { name: "summarize", descKey: "commands.stable.docs.flag.summarize" },
+          ],
         },
         {
           command: "/ck:docs-seeker",
@@ -588,7 +717,7 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.copywriting.desc"),
           detail: t("commands.stable.copywriting.detail"),
           isSkill: true,
-          flags: ["[copy-type] [context]"],
+          flags: [{ name: "[copy-type] [context]", descKey: "commands.stable.copywriting.flag.copy_type_context" }],
         },
         {
           command: "/ck:mintlify",
@@ -613,7 +742,16 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.preview.desc"),
           detail: t("commands.stable.preview.detail"),
           isSkill: true,
-          flags: ["--explain", "--slides", "--diagram", "--ascii", "--html", "--diff", "--plan-review", "--recap"],
+          flags: [
+            { name: "--explain", descKey: "commands.stable.preview.flag.explain" },
+            { name: "--slides", descKey: "commands.stable.preview.flag.slides" },
+            { name: "--diagram", descKey: "commands.stable.preview.flag.diagram" },
+            { name: "--ascii", descKey: "commands.stable.preview.flag.ascii" },
+            { name: "--html", descKey: "commands.stable.preview.flag.html" },
+            { name: "--diff", descKey: "commands.stable.preview.flag.diff" },
+            { name: "--plan-review", descKey: "commands.stable.preview.flag.plan_review" },
+            { name: "--recap", descKey: "commands.stable.preview.flag.recap" },
+          ],
         },
         {
           command: "/ck:tech-graph",
@@ -694,7 +832,11 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.agentize.desc"),
           detail: t("commands.stable.agentize.detail"),
           isSkill: true,
-          flags: ["--both", "--mcp", "--cli"],
+          flags: [
+            { name: "--both", descKey: "commands.stable.agentize.flag.both" },
+            { name: "--mcp", descKey: "commands.stable.agentize.flag.mcp" },
+            { name: "--cli", descKey: "commands.stable.agentize.flag.cli" },
+          ],
         },
       ],
     },
@@ -735,8 +877,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.retro.desc"),
           detail: t("commands.stable.retro.detail"),
           isSkill: true,
-          args: ["[timeframe]"],
-          flags: ["--compare", "--team", "--format html|md"],
+          args: [{ name: "[timeframe]", descKey: "commands.stable.retro.arg.timeframe" }],
+          flags: [
+            { name: "--compare", descKey: "commands.stable.retro.flag.compare" },
+            { name: "--team", descKey: "commands.stable.retro.flag.team" },
+            { name: "--format html|md", descKey: "commands.stable.retro.flag.format_html_md" },
+          ],
         },
       ],
     },
@@ -753,7 +899,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.project_management.desc"),
           detail: t("commands.stable.project_management.detail"),
           isSkill: true,
-          flags: ["status", "hydrate", "sync", "report"],
+          flags: [
+            { name: "status", descKey: "commands.stable.project_management.flag.status" },
+            { name: "hydrate", descKey: "commands.stable.project_management.flag.hydrate" },
+            { name: "sync", descKey: "commands.stable.project_management.flag.sync" },
+            { name: "report", descKey: "commands.stable.project_management.flag.report" },
+          ],
         },
         {
           command: "/ck:plans-kanban",
@@ -802,7 +953,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.repomix.desc"),
           detail: t("commands.stable.repomix.detail"),
           isSkill: true,
-          flags: ["--style xml", "--style markdown", "--style plain", "--style json"],
+          flags: [
+            { name: "--style xml", descKey: "commands.stable.repomix.flag.style_xml" },
+            { name: "--style markdown", descKey: "commands.stable.repomix.flag.style_markdown" },
+            { name: "--style plain", descKey: "commands.stable.repomix.flag.style_plain" },
+            { name: "--style json", descKey: "commands.stable.repomix.flag.style_json" },
+          ],
         },
         {
           command: "/ck:gkg",
@@ -819,8 +975,12 @@ export function getEngineerKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.stable.graphify.desc"),
           detail: t("commands.stable.graphify.detail"),
           isSkill: true,
-          args: ["[path]"],
-          flags: ["--mcp", "--report", "--watch"],
+          args: [{ name: "[path]", descKey: "commands.stable.graphify.arg.path" }],
+          flags: [
+            { name: "--mcp", descKey: "commands.stable.graphify.flag.mcp" },
+            { name: "--report", descKey: "commands.stable.graphify.flag.report" },
+            { name: "--watch", descKey: "commands.stable.graphify.flag.watch" },
+          ],
         },
       ],
     },
diff --git a/src/data/guides/commands-marketing-kit.ts b/src/data/guides/commands-marketing-kit.ts
index d75e263..b3e1607 100644
--- a/src/data/guides/commands-marketing-kit.ts
+++ b/src/data/guides/commands-marketing-kit.ts
@@ -37,7 +37,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.easy"),
           desc: t("commands.mkt.ask.desc"),
           detail: t("commands.mkt.ask.detail"),
-          args: ["[question]"],
+          args: [
+            { name: "[question]", descKey: "commands.mkt.ask.arg.question" },
+          ],
           step: 2,
         },
         // Step 3: Brainstorm ideas
@@ -57,7 +59,16 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.plan.desc"),
           detail: t("commands.mkt.plan.detail"),
-          subcommands: [":cro", ":fast", ":hard", ":parallel", ":archive", ":ci", ":two", ":validate"],
+          subcommands: [
+            { name: ":cro", descKey: "commands.mkt.plan.subcommand.cro" },
+            { name: ":fast", descKey: "commands.mkt.plan.subcommand.fast" },
+            { name: ":hard", descKey: "commands.mkt.plan.subcommand.hard" },
+            { name: ":parallel", descKey: "commands.mkt.plan.subcommand.parallel" },
+            { name: ":archive", descKey: "commands.mkt.plan.subcommand.archive" },
+            { name: ":ci", descKey: "commands.mkt.plan.subcommand.ci" },
+            { name: ":two", descKey: "commands.mkt.plan.subcommand.two" },
+            { name: ":validate", descKey: "commands.mkt.plan.subcommand.validate" },
+          ],
           step: 4,
         },
         // Step 5: Write content
@@ -84,7 +95,16 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.write.desc"),
           detail: t("commands.mkt.write.detail"),
-          subcommands: [":fast", ":good", ":cro", ":blog", ":audit", ":enhance", ":publish", ":formula"],
+          subcommands: [
+            { name: ":fast", descKey: "commands.mkt.write.subcommand.fast" },
+            { name: ":good", descKey: "commands.mkt.write.subcommand.good" },
+            { name: ":cro", descKey: "commands.mkt.write.subcommand.cro" },
+            { name: ":blog", descKey: "commands.mkt.write.subcommand.blog" },
+            { name: ":audit", descKey: "commands.mkt.write.subcommand.audit" },
+            { name: ":enhance", descKey: "commands.mkt.write.subcommand.enhance" },
+            { name: ":publish", descKey: "commands.mkt.write.subcommand.publish" },
+            { name: ":formula", descKey: "commands.mkt.write.subcommand.formula" },
+          ],
         },
         {
           command: "/ckm:content-marketing",
@@ -125,7 +145,12 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.advanced"),
           desc: t("commands.mkt.campaign.desc"),
           detail: t("commands.mkt.campaign.detail"),
-          subcommands: [":create", ":status", ":analyze", ":email"],
+          subcommands: [
+            { name: ":create", descKey: "commands.mkt.campaign.subcommand.create" },
+            { name: ":status", descKey: "commands.mkt.campaign.subcommand.status" },
+            { name: ":analyze", descKey: "commands.mkt.campaign.subcommand.analyze" },
+            { name: ":email", descKey: "commands.mkt.campaign.subcommand.email" },
+          ],
         },
       ],
     },
@@ -142,7 +167,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.seo.desc"),
           detail: t("commands.mkt.seo.detail"),
-          subcommands: [":audit", ":keywords", ":pseo"],
+          subcommands: [
+            { name: ":audit", descKey: "commands.mkt.seo.subcommand.audit" },
+            { name: ":keywords", descKey: "commands.mkt.seo.subcommand.keywords" },
+            { name: ":pseo", descKey: "commands.mkt.seo.subcommand.pseo" },
+          ],
         },
         {
           command: "/ckm:analyze:*",
@@ -150,7 +179,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.analyze.desc"),
           detail: t("commands.mkt.analyze.detail"),
-          subcommands: [":report"],
+          subcommands: [
+            { name: ":report", descKey: "commands.mkt.analyze.subcommand.report" },
+          ],
         },
         {
           command: "/ckm:ab-test-setup",
@@ -175,7 +206,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.ads.desc"),
           detail: t("commands.mkt.ads.detail"),
           isSkill: true,
-          args: ["[platform]", "[campaign-type]"],
+          args: [
+            { name: "[platform]", descKey: "commands.mkt.ads_management.arg.platform" },
+            { name: "[campaign-type]", descKey: "commands.mkt.ads_management.arg.campaign_type" },
+          ],
         },
         {
           command: "/ckm:paid-ads",
@@ -184,7 +218,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.paid_ads.desc"),
           detail: t("commands.mkt.paid_ads.detail"),
           isSkill: true,
-          args: ["[platform]", "[campaign-type]"],
+          args: [
+            { name: "[platform]", descKey: "commands.mkt.paid_ads.arg.platform" },
+            { name: "[campaign-type]", descKey: "commands.mkt.paid_ads.arg.campaign_type" },
+          ],
         },
       ],
     },
@@ -202,7 +239,14 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.design.desc"),
           detail: t("commands.mkt.design.detail"),
           isSkill: true,
-          subcommands: ["logo", "cip", "banner", "icon", "social", "slides"],
+          subcommands: [
+            { name: "logo", descKey: "commands.mkt.design.subcommand.logo" },
+            { name: "cip", descKey: "commands.mkt.design.subcommand.cip" },
+            { name: "banner", descKey: "commands.mkt.design.subcommand.banner" },
+            { name: "icon", descKey: "commands.mkt.design.subcommand.icon" },
+            { name: "social", descKey: "commands.mkt.design.subcommand.social" },
+            { name: "slides", descKey: "commands.mkt.design.subcommand.slides" },
+          ],
         },
         {
           command: "/ckm:design-system",
@@ -227,7 +271,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.email.desc"),
           detail: t("commands.mkt.email.detail"),
-          subcommands: [":flow", ":sequence"],
+          subcommands: [
+            { name: ":flow", descKey: "commands.mkt.email.subcommand.flow" },
+            { name: ":sequence", descKey: "commands.mkt.email.subcommand.sequence" },
+          ],
         },
         // Consolidated: /ckm:social with all subcommands
         {
@@ -236,8 +283,13 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.social.desc"),
           detail: t("commands.mkt.social.detail"),
-          subcommands: [":schedule"],
-          args: ["[platform]", "[type]"],
+          subcommands: [
+            { name: ":schedule", descKey: "commands.mkt.social.subcommand.schedule" },
+          ],
+          args: [
+            { name: "[platform]", descKey: "commands.mkt.social.arg.platform" },
+            { name: "[type]", descKey: "commands.mkt.social.arg.type" },
+          ],
         },
         {
           command: "/ckm:elevenlabs",
@@ -246,7 +298,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.elevenlabs.desc"),
           detail: t("commands.mkt.elevenlabs.detail"),
           isSkill: true,
-          subcommands: ["speak", "clone", "sfx"],
+          subcommands: [
+            { name: "speak", descKey: "commands.mkt.elevenlabs.subcommand.speak" },
+            { name: "clone", descKey: "commands.mkt.elevenlabs.subcommand.clone" },
+            { name: "sfx", descKey: "commands.mkt.elevenlabs.subcommand.sfx" },
+          ],
         },
       ],
     },
@@ -271,7 +327,16 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.plan.desc"),
           detail: t("commands.mkt.plan.detail"),
-          subcommands: [":cro", ":fast", ":hard", ":parallel", ":archive", ":ci", ":two", ":validate"],
+          subcommands: [
+            { name: ":cro", descKey: "commands.mkt.plan.subcommand.cro" },
+            { name: ":fast", descKey: "commands.mkt.plan.subcommand.fast" },
+            { name: ":hard", descKey: "commands.mkt.plan.subcommand.hard" },
+            { name: ":parallel", descKey: "commands.mkt.plan.subcommand.parallel" },
+            { name: ":archive", descKey: "commands.mkt.plan.subcommand.archive" },
+            { name: ":ci", descKey: "commands.mkt.plan.subcommand.ci" },
+            { name: ":two", descKey: "commands.mkt.plan.subcommand.two" },
+            { name: ":validate", descKey: "commands.mkt.plan.subcommand.validate" },
+          ],
         },
         {
           command: "/ckm:competitor",
@@ -279,7 +344,13 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.competitor.desc"),
           detail: t("commands.mkt.competitor.detail"),
-          subcommands: ["analyze", "content", "seo", "alternatives", "list"],
+          subcommands: [
+            { name: "analyze", descKey: "commands.mkt.competitor.subcommand.analyze" },
+            { name: "content", descKey: "commands.mkt.competitor.subcommand.content" },
+            { name: "seo", descKey: "commands.mkt.competitor.subcommand.seo" },
+            { name: "alternatives", descKey: "commands.mkt.competitor.subcommand.alternatives" },
+            { name: "list", descKey: "commands.mkt.competitor.subcommand.list" },
+          ],
         },
         {
           command: "/ckm:persona",
@@ -294,7 +365,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.funnel.desc"),
           detail: t("commands.mkt.funnel.detail"),
-          subcommands: ["design", "analyze", "optimize"],
+          subcommands: [
+            { name: "design", descKey: "commands.mkt.funnel.subcommand.design" },
+            { name: "analyze", descKey: "commands.mkt.funnel.subcommand.analyze" },
+            { name: "optimize", descKey: "commands.mkt.funnel.subcommand.optimize" },
+          ],
         },
         {
           command: "/ckm:marketing-planning",
@@ -335,7 +410,18 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.play.desc"),
           detail: t("commands.mkt.play.detail"),
           isSkill: true,
-          subcommands: [":create", ":next", ":status", ":list", ":blocked", ":learn", ":reset", ":gate", ":templates", ":goals"],
+          subcommands: [
+            { name: ":create", descKey: "commands.mkt.play.subcommand.create" },
+            { name: ":next", descKey: "commands.mkt.play.subcommand.next" },
+            { name: ":status", descKey: "commands.mkt.play.subcommand.status" },
+            { name: ":list", descKey: "commands.mkt.play.subcommand.list" },
+            { name: ":blocked", descKey: "commands.mkt.play.subcommand.blocked" },
+            { name: ":learn", descKey: "commands.mkt.play.subcommand.learn" },
+            { name: ":reset", descKey: "commands.mkt.play.subcommand.reset" },
+            { name: ":gate", descKey: "commands.mkt.play.subcommand.gate" },
+            { name: ":templates", descKey: "commands.mkt.play.subcommand.templates" },
+            { name: ":goals", descKey: "commands.mkt.play.subcommand.goals" },
+          ],
         },
       ],
     },
@@ -352,7 +438,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.video.desc"),
           detail: t("commands.mkt.video.detail"),
-          subcommands: [":create", ":script", ":storyboard"],
+          subcommands: [
+            { name: ":create", descKey: "commands.mkt.video.subcommand.create" },
+            { name: ":script", descKey: "commands.mkt.video.subcommand.script" },
+            { name: ":storyboard", descKey: "commands.mkt.video.subcommand.storyboard" },
+          ],
         },
         // Consolidated: /ckm:youtube with all subcommands
         {
@@ -361,7 +451,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.youtube.desc"),
           detail: t("commands.mkt.youtube.detail"),
-          subcommands: [":blog", ":infographic", ":social"],
+          subcommands: [
+            { name: ":blog", descKey: "commands.mkt.youtube.subcommand.blog" },
+            { name: ":infographic", descKey: "commands.mkt.youtube.subcommand.infographic" },
+            { name: ":social", descKey: "commands.mkt.youtube.subcommand.social" },
+          ],
         },
         {
           command: "/ckm:slides:*",
@@ -369,8 +463,12 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.slides.desc"),
           detail: t("commands.mkt.slides.detail"),
-          subcommands: [":create"],
-          args: ["[topic]"],
+          subcommands: [
+            { name: ":create", descKey: "commands.mkt.slides.subcommand.create" },
+          ],
+          args: [
+            { name: "[topic]", descKey: "commands.mkt.slides.arg.topic" },
+          ],
         },
         {
           command: "/ckm:youtube-thumbnail-design",
@@ -379,7 +477,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.youtube_thumbnail_design.desc"),
           detail: t("commands.mkt.youtube_thumbnail_design.detail"),
           isSkill: true,
-          args: ["[niche]", "[style]"],
+          args: [
+            { name: "[niche]", descKey: "commands.mkt.youtube_thumbnail_design.arg.niche" },
+            { name: "[style]", descKey: "commands.mkt.youtube_thumbnail_design.arg.style" },
+          ],
         },
       ],
     },
@@ -396,7 +497,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.launch_strategy.desc"),
           detail: t("commands.mkt.launch_strategy.detail"),
           isSkill: true,
-          args: ["[product]"],
+          args: [
+            { name: "[product]", descKey: "commands.mkt.launch_strategy.arg.product" },
+          ],
         },
         {
           command: "/ckm:pricing-strategy",
@@ -405,7 +508,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.pricing_strategy.desc"),
           detail: t("commands.mkt.pricing_strategy.detail"),
           isSkill: true,
-          args: ["[product]", "[tier]"],
+          args: [
+            { name: "[product]", descKey: "commands.mkt.pricing_strategy.arg.product" },
+            { name: "[tier]", descKey: "commands.mkt.pricing_strategy.arg.tier" },
+          ],
         },
         {
           command: "/ckm:free-tool-strategy",
@@ -414,7 +520,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.free_tool.desc"),
           detail: t("commands.mkt.free_tool.detail"),
           isSkill: true,
-          args: ["[tool-idea]", "[niche]"],
+          args: [
+            { name: "[tool-idea]", descKey: "commands.mkt.free_tool_strategy.arg.tool_idea" },
+            { name: "[niche]", descKey: "commands.mkt.free_tool_strategy.arg.niche" },
+          ],
         },
         {
           command: "/ckm:gamification-marketing",
@@ -423,7 +532,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.gamification.desc"),
           detail: t("commands.mkt.gamification.detail"),
           isSkill: true,
-          args: ["[mechanic]", "[campaign]"],
+          args: [
+            { name: "[mechanic]", descKey: "commands.mkt.gamification_marketing.arg.mechanic" },
+            { name: "[campaign]", descKey: "commands.mkt.gamification_marketing.arg.campaign" },
+          ],
         },
         {
           command: "/ckm:affiliate-marketing",
@@ -432,7 +544,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.affiliate.desc"),
           detail: t("commands.mkt.affiliate.detail"),
           isSkill: true,
-          args: ["[program]", "[strategy]"],
+          args: [
+            { name: "[program]", descKey: "commands.mkt.affiliate_marketing.arg.program" },
+            { name: "[strategy]", descKey: "commands.mkt.affiliate_marketing.arg.strategy" },
+          ],
         },
         {
           command: "/ckm:referral-program-building",
@@ -441,7 +556,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.referral.desc"),
           detail: t("commands.mkt.referral.detail"),
           isSkill: true,
-          args: ["[product]", "[program-type]"],
+          args: [
+            { name: "[product]", descKey: "commands.mkt.referral_program_building.arg.product" },
+            { name: "[program-type]", descKey: "commands.mkt.referral_program_building.arg.program_type" },
+          ],
         },
         {
           command: "/ckm:form-cro",
@@ -450,7 +568,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.form_cro.desc"),
           detail: t("commands.mkt.form_cro.detail"),
           isSkill: true,
-          args: ["[form-url]"],
+          args: [
+            { name: "[form-url]", descKey: "commands.mkt.form_cro.arg.form_url" },
+          ],
         },
         {
           command: "/ckm:onboarding-cro",
@@ -459,7 +579,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.onboarding_cro.desc"),
           detail: t("commands.mkt.onboarding_cro.detail"),
           isSkill: true,
-          args: ["[flow-url]"],
+          args: [
+            { name: "[flow-url]", descKey: "commands.mkt.onboarding_cro.arg.flow_url" },
+          ],
         },
       ],
     },
@@ -475,7 +597,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.easy"),
           desc: t("commands.mkt.test.desc"),
           detail: t("commands.mkt.test.detail"),
-          subcommands: [":ui", ":workflow"],
+          subcommands: [
+            { name: ":ui", descKey: "commands.mkt.test.subcommand.ui" },
+            { name: ":workflow", descKey: "commands.mkt.test.subcommand.workflow" },
+          ],
         },
         {
           command: "/ck:code-review",
@@ -484,8 +609,13 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.code_review.desc"),
           detail: t("commands.mkt.code_review.detail"),
           isSkill: true,
-          args: ["[context]"],
-          subcommands: ["codebase", "codebase parallel"],
+          args: [
+            { name: "[context]", descKey: "commands.mkt.code_review.arg.context" },
+          ],
+          subcommands: [
+            { name: "codebase", descKey: "commands.mkt.code_review.subcommand.codebase" },
+            { name: "codebase parallel", descKey: "commands.mkt.code_review.subcommand.codebase_parallel" },
+          ],
         },
         {
           command: "/ckm:debugging",
@@ -510,7 +640,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.git_push.desc"),
           detail: t("commands.mkt.git_push.detail"),
           isSkill: true,
-          subcommands: ["cm", "cp", "pr"],
+          subcommands: [
+            { name: "cm", descKey: "commands.mkt.git.subcommand.cm" },
+            { name: "cp", descKey: "commands.mkt.git.subcommand.cp" },
+            { name: "pr", descKey: "commands.mkt.git.subcommand.pr" },
+          ],
         },
         {
           command: "/ckm:worktree",
@@ -563,7 +697,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.dashboard.desc"),
           detail: t("commands.mkt.dashboard.detail"),
-          subcommands: [":check"],
+          subcommands: [
+            { name: ":check", descKey: "commands.mkt.dashboard.subcommand.check" },
+          ],
         },
         {
           command: "/ckm:brand",
@@ -571,7 +707,9 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.brand.desc"),
           detail: t("commands.mkt.brand.detail"),
-          subcommands: [":update"],
+          subcommands: [
+            { name: ":update", descKey: "commands.mkt.brand.subcommand.update" },
+          ],
         },
         {
           command: "/ckm:docs:*",
@@ -579,7 +717,12 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.docs.desc"),
           detail: t("commands.mkt.docs.detail"),
-          subcommands: [":init", ":llms", ":summarize", ":update"],
+          subcommands: [
+            { name: ":init", descKey: "commands.mkt.docs.subcommand.init" },
+            { name: ":llms", descKey: "commands.mkt.docs.subcommand.llms" },
+            { name: ":summarize", descKey: "commands.mkt.docs.subcommand.summarize" },
+            { name: ":update", descKey: "commands.mkt.docs.subcommand.update" },
+          ],
         },
         {
           command: "/ckm:hub",
@@ -587,7 +730,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.easy"),
           desc: t("commands.mkt.hub.desc"),
           detail: t("commands.mkt.hub.detail"),
-          flags: ["--stop", "--scan"],
+          flags: [
+            { name: "--stop", descKey: "commands.mkt.hub.flag.stop" },
+            { name: "--scan", descKey: "commands.mkt.hub.flag.scan" },
+          ],
         },
         {
           command: "/ckm:storage:*",
@@ -595,7 +741,12 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.easy"),
           desc: t("commands.mkt.storage.desc"),
           detail: t("commands.mkt.storage.detail"),
-          subcommands: [":list", ":sync", ":upload", ":url"],
+          subcommands: [
+            { name: ":list", descKey: "commands.mkt.storage.subcommand.list" },
+            { name: ":sync", descKey: "commands.mkt.storage.subcommand.sync" },
+            { name: ":upload", descKey: "commands.mkt.storage.subcommand.upload" },
+            { name: ":url", descKey: "commands.mkt.storage.subcommand.url" },
+          ],
         },
       ],
     },
@@ -611,7 +762,14 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.medium"),
           desc: t("commands.mkt.skill_create.desc"),
           detail: t("commands.mkt.skill_create.detail"),
-          subcommands: [":add", ":create", ":fix-logs", ":optimize", ":plan", ":update"],
+          subcommands: [
+            { name: ":add", descKey: "commands.mkt.skill.subcommand.add" },
+            { name: ":create", descKey: "commands.mkt.skill.subcommand.create" },
+            { name: ":fix-logs", descKey: "commands.mkt.skill.subcommand.fix_logs" },
+            { name: ":optimize", descKey: "commands.mkt.skill.subcommand.optimize" },
+            { name: ":plan", descKey: "commands.mkt.skill.subcommand.plan" },
+            { name: ":update", descKey: "commands.mkt.skill.subcommand.update" },
+          ],
         },
         {
           command: "/ckm:use-mcp",
@@ -626,7 +784,12 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           label: t("commands.label.easy"),
           desc: t("commands.mkt.preview.desc"),
           detail: t("commands.mkt.preview.detail"),
-          flags: ["--explain", "--slides", "--diagram", "--ascii"],
+          flags: [
+            { name: "--explain", descKey: "commands.mkt.preview.flag.explain" },
+            { name: "--slides", descKey: "commands.mkt.preview.flag.slides" },
+            { name: "--diagram", descKey: "commands.mkt.preview.flag.diagram" },
+            { name: "--ascii", descKey: "commands.mkt.preview.flag.ascii" },
+          ],
         },
         {
           command: "/ckm:content-hub",
@@ -635,7 +798,11 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.content_hub.desc"),
           detail: t("commands.mkt.content_hub.detail"),
           isSkill: true,
-          subcommands: ["open", "browse", "search"],
+          subcommands: [
+            { name: "open", descKey: "commands.mkt.content_hub.subcommand.open" },
+            { name: "browse", descKey: "commands.mkt.content_hub.subcommand.browse" },
+            { name: "search", descKey: "commands.mkt.content_hub.subcommand.search" },
+          ],
         },
         {
           command: "/ckm:assets-organizing",
@@ -644,7 +811,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.assets.desc"),
           detail: t("commands.mkt.assets.detail"),
           isSkill: true,
-          args: ["[directory]", "[asset-type]"],
+          args: [
+            { name: "[directory]", descKey: "commands.mkt.assets_organizing.arg.directory" },
+            { name: "[asset-type]", descKey: "commands.mkt.assets_organizing.arg.asset_type" },
+          ],
         },
         {
           command: "/ckm:kit-builder",
@@ -653,7 +823,10 @@ export function getMarketingKitCategories(t: TranslationFn): CommandCategory[] {
           desc: t("commands.mkt.kit_builder.desc"),
           detail: t("commands.mkt.kit_builder.detail"),
           isSkill: true,
-          args: ["[component-type]", "[name]"],
+          args: [
+            { name: "[component-type]", descKey: "commands.mkt.kit_builder.arg.component_type" },
+            { name: "[name]", descKey: "commands.mkt.kit_builder.arg.name" },
+          ],
         },
         {
           command: "/ckm:claude-code",
diff --git a/src/data/guides/commands-types.ts b/src/data/guides/commands-types.ts
index d9848b8..153b7f9 100644
--- a/src/data/guides/commands-types.ts
+++ b/src/data/guides/commands-types.ts
@@ -1,5 +1,16 @@
 // Shared TypeScript interfaces for command guide data
 
+// A chip can be a raw string (legacy, used by Marketing Kit until migrated)
+// or a structured ChipItem with an i18n key for its 1-line explanation.
+export interface ChipItem {
+  // Chip label as shown in card, e.g. "--fast", "archive", "[question]"
+  name: string;
+  // i18n key resolving to the chip's explanation in the expandable Details section
+  descKey: string;
+}
+
+export type Chip = string | ChipItem;
+
 export interface CommandItem {
   command: string;
   complexity: string;
@@ -8,14 +19,14 @@ export interface CommandItem {
   detail: string;
   isSkill?: boolean;
   isBeta?: boolean;
-  // Colon-separated subcommands: /mkt:plan:cro → subcommands: ["cro"]
-  subcommands?: string[];
-  // Space-separated arguments: /mkt:ask [question] → args: ["[question]"]
-  args?: string[];
-  // Dash flags: --fast, --verbose → flags: ["--fast"]
-  flags?: string[];
+  // Colon-separated subcommands: /mkt:plan:cro → subcommands: [{ name: "cro", ... }]
+  subcommands?: Chip[];
+  // Space-separated arguments: /mkt:ask [question] → args: [{ name: "[question]", ... }]
+  args?: Chip[];
+  // Dash flags: --fast, --verbose → flags: [{ name: "--fast", ... }]
+  flags?: Chip[];
   // Beta-only flags (rendered with purple BETA tag in command card)
-  betaFlags?: string[];
+  betaFlags?: Chip[];
   replacedCommand?: string;
   // Beta syntax annotation (for Marketing Kit)
   betaSyntax?: string;
@@ -36,3 +47,12 @@ export interface CommandCategory {
 }
 
 export type TranslationFn = (key: string) => string;
+
+// Helpers for renderer: accept both legacy string chips (MK) and new ChipItem (EK).
+export function chipName(c: Chip): string {
+  return typeof c === "string" ? c : c.name;
+}
+
+export function chipDescKey(c: Chip): string | null {
+  return typeof c === "string" ? null : c.descKey;
+}
diff --git a/src/i18n/en/commands.ts b/src/i18n/en/commands.ts
index e9f875f..24553a6 100644
--- a/src/i18n/en/commands.ts
+++ b/src/i18n/en/commands.ts
@@ -996,4 +996,257 @@ export const commands = {
   // Added: YouTube thumbnail design
   'commands.mkt.youtube_thumbnail_design.desc': 'Design YouTube thumbnails with CTR optimization',
   'commands.mkt.youtube_thumbnail_design.detail': '17 styles, niche-specific guides. AI generation with Gemini. Supports facecam, listicle, bold-text, dark-dramatic.',
+  // Details modal (Phase 2)
+  'commands.details.button': 'Details',
+  'commands.details.close': 'Close',
+  'commands.details.section.subcommands': 'Subcommands',
+  'commands.details.section.args': 'Arguments',
+  'commands.details.section.flags': 'Flags',
+  'commands.details.section.beta_flags': 'Beta flags',
+  'commands.details.count.subcommand': 'subcommands',
+  'commands.details.count.arg': 'args',
+  'commands.details.count.flag': 'flags',
+  'commands.details.count.beta_flag': 'beta flags',
+
+  // Phase 3: per-chip explanations (subcommands/args/flags) for EK stable commands
+  'commands.stable.agentize.flag.both': 'Generate both CLI binary and MCP server in one pass.',
+  'commands.stable.agentize.flag.cli': 'Generate only the CLI binary (skip MCP wrapper).',
+  'commands.stable.agentize.flag.mcp': 'Generate only the MCP server (skip CLI wrapper).',
+  'commands.stable.ai_artist.flag.mode_all': 'Generate all three mode variations (search, creative, wild).',
+  'commands.stable.ai_artist.flag.mode_creative': 'Remix elements from top matching prompts creatively.',
+  'commands.stable.ai_artist.flag.mode_search': 'Find best matching prompt from curated collection.',
+  'commands.stable.ai_artist.flag.mode_wild': 'Out-of-the-box creative interpretation with random style.',
+  'commands.stable.ai_artist.flag.skip': 'Bypass validation interview and proceed directly.',
+  'commands.stable.ask.arg.question': 'Technical question, architecture challenge, or design decision.',
+  'commands.stable.bootstrap.flag.auto': 'Automatic mode with explicit autonomous decision-making.',
+  'commands.stable.bootstrap.flag.fast': 'Quick mode skipping research but keeping review gates.',
+  'commands.stable.bootstrap.flag.full': 'Full interactive mode with all decision gates.',
+  'commands.stable.bootstrap.flag.parallel': 'Multi-agent execution for faster setup.',
+  'commands.stable.code_review.flag.codebase': 'Scan and review the entire codebase.',
+  'commands.stable.code_review.flag.codebase_parallel': 'Parallel multi-reviewer codebase audit.',
+  'commands.stable.code_review.flag.commit': 'Review a specific commit by hash.',
+  'commands.stable.code_review.flag.context': 'Review staged and unstaged pending changes.',
+  'commands.stable.code_review.flag.pending': 'Review staged and unstaged git changes.',
+  'commands.stable.code_review.flag.pr': 'Review a specific pull request by number.',
+  'commands.stable.cook.flag.auto': 'Auto-approve all implementation steps.',
+  'commands.stable.cook.flag.fast': 'Skip research phase, go straight to planning and code.',
+  'commands.stable.cook.flag.interactive': 'Full workflow with user input (default mode).',
+  'commands.stable.cook.flag.no_test': 'Skip testing step (downgrade to warning).',
+  'commands.stable.cook.flag.parallel': 'Multi-agent execution for faster implementation.',
+  'commands.stable.cook.flag.tdd': 'Write tests first before implementing code.',
+  'commands.stable.copywriting.flag.copy_type_context': 'Copy type and context for generating branded copy.',
+  'commands.stable.cti_expert.arg.target': 'Target to investigate (domain, email, username, etc).',
+  'commands.stable.cti_expert.flag.case': 'Case-specific investigation workflow.',
+  'commands.stable.cti_expert.flag.flow': 'Guided flow for first-time investigators.',
+  'commands.stable.cti_expert.flag.query': 'Build search operator queries for reconnaissance.',
+  'commands.stable.cti_expert.flag.sweep': 'Multi-vector recon on any target type.',
+  'commands.stable.cti_expert.flag.yolo': 'Skip all interactive prompts and auto-decide.',
+  'commands.stable.deploy.arg.environment': 'Deployment environment (production, staging, dev).',
+  'commands.stable.deploy.arg.platform': 'Deployment platform (Vercel, Netlify, Railway, etc).',
+  'commands.stable.docs.flag.init': 'Initialize and create project documentation.',
+  'commands.stable.docs.flag.summarize': 'Quick analysis and documentation summary.',
+  'commands.stable.docs.flag.update': 'Update and maintain existing documentation.',
+  'commands.stable.fix.flag.auto': 'Activate autonomous mode with auto-approval.',
+  'commands.stable.fix.flag.parallel': 'Multi-agent parallel execution for faster fixes.',
+  'commands.stable.fix.flag.quick': 'Fast scout-diagnose-fix cycle for trivial issues.',
+  'commands.stable.fix.flag.review': 'Activate human-in-the-loop review mode.',
+  'commands.stable.git.flag.cm': 'Stage files and create commits.',
+  'commands.stable.git.flag.cp': 'Stage files, create commits, and push.',
+  'commands.stable.git.flag.merge': 'Merge source branch into target branch.',
+  'commands.stable.git.flag.pr': 'Create a pull request from source to target.',
+  'commands.stable.graphify.arg.path': 'Path to code, docs, or images to build graph from.',
+  'commands.stable.graphify.flag.mcp': 'Expose graph as MCP server for Claude queries.',
+  'commands.stable.graphify.flag.report': 'Generate knowledge graph report with insights.',
+  'commands.stable.graphify.flag.watch': 'Auto-rebuild graph on file changes.',
+  'commands.stable.plan.flag.auto': 'Auto-detect complexity and create plan autonomously.',
+  'commands.stable.plan.flag.deep': 'Deep analysis with extended research phases.',
+  'commands.stable.plan.flag.fast': 'Quick planning, skip research phase.',
+  'commands.stable.plan.flag.hard': 'Thorough planning with comprehensive validation.',
+  'commands.stable.plan.flag.no_tasks': 'Create plan without detailed task checklist.',
+  'commands.stable.plan.flag.parallel': 'Multi-agent planning with file ownership tracking.',
+  'commands.stable.plan.flag.tdd': 'Plan with test-driven development approach.',
+  'commands.stable.plan.flag.two': 'Two-pass planning with challenge phase.',
+  'commands.stable.plan.subcommand.archive': 'Archive completed plans and write retrospective.',
+  'commands.stable.plan.subcommand.red_team': 'Adversarial plan review to find weaknesses.',
+  'commands.stable.plan.subcommand.validate': 'Validate plan against acceptance criteria.',
+  'commands.stable.predict.flag.chain_probe': 'Use probing technique in chain-of-thought.',
+  'commands.stable.predict.flag.chain_reason': 'Use reasoning technique in chain-of-thought.',
+  'commands.stable.preview.flag.ascii': 'Generate ASCII-only diagrams (terminal-friendly).',
+  'commands.stable.preview.flag.diagram': 'Generate focused diagram with ASCII and Mermaid.',
+  'commands.stable.preview.flag.diff': 'Visual diff review for code changes.',
+  'commands.stable.preview.flag.explain': 'Generate visual explanation with ASCII and Mermaid.',
+  'commands.stable.preview.flag.html': 'Generate self-contained HTML output.',
+  'commands.stable.preview.flag.plan_review': 'Visual comparison of plan vs actual codebase.',
+  'commands.stable.preview.flag.recap': 'Project context snapshot and progress summary.',
+  'commands.stable.preview.flag.slides': 'Generate presentation slides (one concept per slide).',
+  'commands.stable.project_management.flag.hydrate': 'Load and populate project task data.',
+  'commands.stable.project_management.flag.report': 'Generate project status and progress report.',
+  'commands.stable.project_management.flag.status': 'Show current project status snapshot.',
+  'commands.stable.project_management.flag.sync': 'Sync project data with external tracking systems.',
+  'commands.stable.repomix.flag.style_json': 'Output as machine-readable JSON format.',
+  'commands.stable.repomix.flag.style_markdown': 'Output as markdown with code fences.',
+  'commands.stable.repomix.flag.style_plain': 'Output as plain text without formatting.',
+  'commands.stable.repomix.flag.style_xml': 'Output as XML-structured format.',
+  'commands.stable.research.arg.topic': 'Topic or subject to research extensively.',
+  'commands.stable.retro.arg.timeframe': 'Time period to analyze (7d, 2w, 1m, sprint).',
+  'commands.stable.retro.flag.compare': 'Compare metrics against preceding equal timeframe.',
+  'commands.stable.retro.flag.format_html_md': 'Output format (html or markdown).',
+  'commands.stable.retro.flag.team': 'Break down metrics per author.',
+  'commands.stable.scenario.flag.iterations': 'Run exactly N iterations then stop.',
+  'commands.stable.scenario.flag.saturation': 'Keep iterating until convergence is detected.',
+  'commands.stable.scout.arg.ext': 'File extension to filter scout results.',
+  'commands.stable.scout.arg.search_target': 'File, folder, or pattern to scout.',
+  'commands.stable.security_scan.arg.scope': 'Scope of scan (dependencies, secrets, all).',
+  'commands.stable.security_scan.flag.deps_only': 'Scan only dependencies and packages.',
+  'commands.stable.security_scan.flag.full': 'Comprehensive security scan (all checks).',
+  'commands.stable.security_scan.flag.secrets_only': 'Scan only for exposed secrets.',
+  'commands.stable.security.flag.fix': 'Auto-fix identified security issues.',
+  'commands.stable.security.flag.iterations': 'Number of red-team iterations.',
+  'commands.stable.security.flag.red_team': 'Activate adversarial security testing.',
+  'commands.stable.ship.flag.beta': 'Ship to beta branch with lighter pipeline.',
+  'commands.stable.ship.flag.official': 'Ship to main/master with full pipeline.',
+  'commands.stable.ship.flag.skip_review': 'Skip code review step.',
+  'commands.stable.ship.flag.skip_tests': 'Skip test step (use when tests already passed).',
+  'commands.stable.stitch.flag.device_mobile': 'Generate mobile device layout.',
+  'commands.stable.stitch.flag.format_all': 'Generate all available output formats.',
+  'commands.stable.stitch.flag.format_html': 'Generate HTML format output.',
+  'commands.stable.stitch.subcommand.export': 'Export designs to external format.',
+  'commands.stable.stitch.subcommand.generate': 'Generate designs from descriptions.',
+  'commands.stable.team.flag.delegate': 'Lead only coordinates, never touches code.',
+  'commands.stable.team.flag.devs': 'Number of developer agents to spawn.',
+  'commands.stable.team.flag.researchers': 'Number of researcher agents to spawn.',
+  'commands.stable.team.flag.reviewers': 'Number of reviewer agents to spawn.',
+  'commands.stable.team.flag.template_context': 'Template and context for team setup.',
+  'commands.stable.test.flag.context': 'Additional context for test execution.',
+  'commands.stable.test.flag.ui_url': 'URL for UI testing or browser integration.',
+  'commands.stable.xia.arg.feature': 'Feature or module to port from source repo.',
+  'commands.stable.xia.arg.target': 'GitHub URL, owner/repo, or local path.',
+  'commands.stable.xia.flag.auto': 'Keep full workflow, auto-approve gates.',
+  'commands.stable.xia.flag.compare': 'Side-by-side analysis only, no implementation.',
+  'commands.stable.xia.flag.copy': 'Transplant with minimal changes.',
+  'commands.stable.xia.flag.fast': 'Skip research and challenge, auto-approve.',
+  'commands.stable.xia.flag.improve': 'Copy plus refactor for local codebase.',
+  'commands.stable.xia.flag.port': 'Rewrite idiomatically for local stack (default).',
+  // Phase 4: Marketing Kit chip explanations (subcommands/args/flags)
+  'commands.mkt.ads_management.arg.campaign_type': 'Campaign type (awareness, conversion).',
+  'commands.mkt.ads_management.arg.platform': 'Ad platform (Google, Meta, LinkedIn).',
+  'commands.mkt.affiliate_marketing.arg.program': 'Affiliate program name.',
+  'commands.mkt.affiliate_marketing.arg.strategy': 'Go-to-market strategy.',
+  'commands.mkt.analyze.subcommand.report': 'Generate analytics performance report.',
+  'commands.mkt.ask.arg.question': 'Marketing question or topic.',
+  'commands.mkt.assets_organizing.arg.asset_type': 'Asset type to organize.',
+  'commands.mkt.assets_organizing.arg.directory': 'Asset directory path.',
+  'commands.mkt.brand.subcommand.update': 'Update brand guidelines.',
+  'commands.mkt.campaign.subcommand.analyze': 'Deep dive into campaign metrics.',
+  'commands.mkt.campaign.subcommand.create': 'Launch new campaign with full setup.',
+  'commands.mkt.campaign.subcommand.email': 'Email campaign management.',
+  'commands.mkt.campaign.subcommand.status': 'Show active campaigns and progress.',
+  'commands.mkt.code_review.arg.context': 'Code context to review.',
+  'commands.mkt.code_review.subcommand.codebase': 'Review entire codebase.',
+  'commands.mkt.code_review.subcommand.codebase_parallel': 'Parallel codebase review.',
+  'commands.mkt.competitor.subcommand.alternatives': 'Find and analyze alternatives.',
+  'commands.mkt.competitor.subcommand.analyze': 'Competitive positioning analysis.',
+  'commands.mkt.competitor.subcommand.content': 'Competitor content strategy review.',
+  'commands.mkt.competitor.subcommand.list': 'Identify direct competitors.',
+  'commands.mkt.competitor.subcommand.seo': 'Competitor SEO and ranking analysis.',
+  'commands.mkt.content_hub.subcommand.browse': 'Browse organized assets.',
+  'commands.mkt.content_hub.subcommand.open': 'Open asset gallery.',
+  'commands.mkt.content_hub.subcommand.search': 'Search assets by tag.',
+  'commands.mkt.dashboard.subcommand.check': 'Check dashboard metrics.',
+  'commands.mkt.design.subcommand.banner': 'Ad banners in standard sizes.',
+  'commands.mkt.design.subcommand.cip': 'Corporate identity design system.',
+  'commands.mkt.design.subcommand.icon': 'Icon set design.',
+  'commands.mkt.design.subcommand.logo': 'Logo and brand identity design.',
+  'commands.mkt.design.subcommand.slides': 'Presentation deck design.',
+  'commands.mkt.design.subcommand.social': 'Social media visual design.',
+  'commands.mkt.docs.subcommand.init': 'Initialize project documentation.',
+  'commands.mkt.docs.subcommand.llms': 'Generate LLM-friendly docs.',
+  'commands.mkt.docs.subcommand.summarize': 'Quick documentation summary.',
+  'commands.mkt.docs.subcommand.update': 'Update existing documentation.',
+  'commands.mkt.elevenlabs.subcommand.clone': 'Clone voice for TTS.',
+  'commands.mkt.elevenlabs.subcommand.sfx': 'Sound effects generation.',
+  'commands.mkt.elevenlabs.subcommand.speak': 'Text-to-speech generation.',
+  'commands.mkt.email.subcommand.flow': 'Trigger-based email automation flows.',
+  'commands.mkt.email.subcommand.sequence': 'Email sequence design and timing.',
+  'commands.mkt.form_cro.arg.form_url': 'URL of form to optimize.',
+  'commands.mkt.free_tool_strategy.arg.niche': 'Target market niche.',
+  'commands.mkt.free_tool_strategy.arg.tool_idea': 'Free tool concept.',
+  'commands.mkt.funnel.subcommand.analyze': 'Identify drop-off points.',
+  'commands.mkt.funnel.subcommand.design': 'Map customer journey stages.',
+  'commands.mkt.funnel.subcommand.optimize': 'Optimize conversion at each stage.',
+  'commands.mkt.gamification_marketing.arg.campaign': 'Campaign to gamify.',
+  'commands.mkt.gamification_marketing.arg.mechanic': 'Gamification mechanic.',
+  'commands.mkt.git.subcommand.cm': 'Commit with message.',
+  'commands.mkt.git.subcommand.cp': 'Commit and push.',
+  'commands.mkt.git.subcommand.pr': 'Create pull request.',
+  'commands.mkt.hub.flag.scan': 'Scan for new assets.',
+  'commands.mkt.hub.flag.stop': 'Stop dashboard service.',
+  'commands.mkt.kit_builder.arg.component_type': 'Component type to build.',
+  'commands.mkt.kit_builder.arg.name': 'Component name.',
+  'commands.mkt.launch_strategy.arg.product': 'Product to launch.',
+  'commands.mkt.onboarding_cro.arg.flow_url': 'URL of onboarding flow.',
+  'commands.mkt.paid_ads.arg.campaign_type': 'Campaign objective (leads, sales).',
+  'commands.mkt.paid_ads.arg.platform': 'Ad platform for PPC campaigns.',
+  'commands.mkt.plan.subcommand.archive': 'Archive plan and write retrospective.',
+  'commands.mkt.plan.subcommand.ci': 'Plan with continuous integration focus.',
+  'commands.mkt.plan.subcommand.cro': 'Conversion rate optimization planning.',
+  'commands.mkt.plan.subcommand.fast': 'Quick plan without deep research.',
+  'commands.mkt.plan.subcommand.hard': 'Thorough plan with extensive validation.',
+  'commands.mkt.plan.subcommand.parallel': 'Multi-agent planning with task distribution.',
+  'commands.mkt.plan.subcommand.two': 'Two-pass planning with challenge phase.',
+  'commands.mkt.plan.subcommand.validate': 'Validate plan against success criteria.',
+  'commands.mkt.play.subcommand.blocked': 'Show blocked playbook tasks.',
+  'commands.mkt.play.subcommand.create': 'Create new marketing playbook.',
+  'commands.mkt.play.subcommand.gate': 'Set decision gates in playbook.',
+  'commands.mkt.play.subcommand.goals': 'Define playbook success goals.',
+  'commands.mkt.play.subcommand.learn': 'Learn playbook patterns.',
+  'commands.mkt.play.subcommand.list': 'List available playbooks.',
+  'commands.mkt.play.subcommand.next': 'Suggest next playbook action.',
+  'commands.mkt.play.subcommand.reset': 'Reset playbook state.',
+  'commands.mkt.play.subcommand.status': 'Show playbook execution status.',
+  'commands.mkt.play.subcommand.templates': 'Browse playbook templates.',
+  'commands.mkt.preview.flag.ascii': 'ASCII-only diagram output.',
+  'commands.mkt.preview.flag.diagram': 'Generate architecture diagram.',
+  'commands.mkt.preview.flag.explain': 'Generate visual explanation.',
+  'commands.mkt.preview.flag.slides': 'Generate presentation slides.',
+  'commands.mkt.pricing_strategy.arg.product': 'Product to price.',
+  'commands.mkt.pricing_strategy.arg.tier': 'Pricing tier level.',
+  'commands.mkt.referral_program_building.arg.product': 'Product with referral.',
+  'commands.mkt.referral_program_building.arg.program_type': 'Referral mechanics type.',
+  'commands.mkt.seo.subcommand.audit': 'Full site audit with prioritized fixes.',
+  'commands.mkt.seo.subcommand.keywords': 'Target keyword research and gaps.',
+  'commands.mkt.seo.subcommand.pseo': 'Programmatic SEO page generation.',
+  'commands.mkt.skill.subcommand.add': 'Add new skill to library.',
+  'commands.mkt.skill.subcommand.create': 'Create custom marketing skill.',
+  'commands.mkt.skill.subcommand.fix_logs': 'Debug and fix skill logs.',
+  'commands.mkt.skill.subcommand.optimize': 'Optimize skill performance.',
+  'commands.mkt.skill.subcommand.plan': 'Plan skill development.',
+  'commands.mkt.skill.subcommand.update': 'Update existing skill.',
+  'commands.mkt.slides.arg.topic': 'Slide deck topic.',
+  'commands.mkt.slides.subcommand.create': 'Create presentation slides.',
+  'commands.mkt.social.arg.platform': 'Platform (Twitter, LinkedIn, TikTok).',
+  'commands.mkt.social.arg.type': 'Content type (video, carousel, text).',
+  'commands.mkt.social.subcommand.schedule': 'Multi-platform content calendar.',
+  'commands.mkt.storage.subcommand.list': 'List stored assets.',
+  'commands.mkt.storage.subcommand.sync': 'Sync local to S3 storage.',
+  'commands.mkt.storage.subcommand.upload': 'Upload assets to storage.',
+  'commands.mkt.storage.subcommand.url': 'Get public URL for asset.',
+  'commands.mkt.test.subcommand.ui': 'UI/UX testing.',
+  'commands.mkt.test.subcommand.workflow': 'Workflow integration testing.',
+  'commands.mkt.video.subcommand.create': 'End-to-end video production.',
+  'commands.mkt.video.subcommand.script': 'Write compelling video script.',
+  'commands.mkt.video.subcommand.storyboard': 'Create visual storyboard.',
+  'commands.mkt.write.subcommand.audit': 'Audit existing content for quality.',
+  'commands.mkt.write.subcommand.blog': 'SEO-optimized long-form blog content.',
+  'commands.mkt.write.subcommand.cro': 'Conversion-optimized copy with variants.',
+  'commands.mkt.write.subcommand.enhance': 'Improve clarity, tone, and conversion.',
+  'commands.mkt.write.subcommand.fast': 'Fast draft without review cycle.',
+  'commands.mkt.write.subcommand.formula': 'Use persuasion formulas for copy.',
+  'commands.mkt.write.subcommand.good': 'High-quality writing with review stages.',
+  'commands.mkt.write.subcommand.publish': 'Finalize and prepare for publication.',
+  'commands.mkt.youtube.subcommand.blog': 'YouTube to blog conversion.',
+  'commands.mkt.youtube.subcommand.infographic': 'YouTube to infographic format.',
+  'commands.mkt.youtube.subcommand.social': 'Repurpose YouTube for social media.',
+  'commands.mkt.youtube_thumbnail_design.arg.niche': 'Content niche for thumbnails.',
+  'commands.mkt.youtube_thumbnail_design.arg.style': 'Visual style preference.',
 } as const;
diff --git a/src/i18n/vi/commands.ts b/src/i18n/vi/commands.ts
index ca8bfeb..b8843e0 100644
--- a/src/i18n/vi/commands.ts
+++ b/src/i18n/vi/commands.ts
@@ -996,4 +996,258 @@ export const commands = {
   // Added: YouTube thumbnail design
   'commands.mkt.youtube_thumbnail_design.desc': 'Thiết kế thumbnail YouTube tối ưu CTR',
   'commands.mkt.youtube_thumbnail_design.detail': '17 phong cách, hướng dẫn theo niche. Tạo ảnh AI bằng Gemini. Hỗ trợ facecam, listicle, bold-text, dark-dramatic.',
+
+  // Command details toggle (Phase 2)
+  'commands.details.button': 'Chi tiết',
+  'commands.details.close': 'Đóng',
+  'commands.details.section.subcommands': 'Subcommands',
+  'commands.details.section.args': 'Arguments',
+  'commands.details.section.flags': 'Flags',
+  'commands.details.section.beta_flags': 'Beta flags',
+  'commands.details.count.subcommand': 'subcommands',
+  'commands.details.count.arg': 'args',
+  'commands.details.count.flag': 'flags',
+  'commands.details.count.beta_flag': 'beta flags',
+
+  // Phase 3 (VI mirror): per-chip explanations for EK stable commands
+  'commands.stable.agentize.flag.both': 'Tạo cả CLI binary và MCP server cùng lúc.',
+  'commands.stable.agentize.flag.cli': 'Chỉ tạo CLI binary (bỏ qua MCP wrapper).',
+  'commands.stable.agentize.flag.mcp': 'Chỉ tạo MCP server (bỏ qua CLI wrapper).',
+  'commands.stable.ai_artist.flag.mode_all': 'Tạo cả 3 biến thể: search, creative, wild.',
+  'commands.stable.ai_artist.flag.mode_creative': 'Remix yếu tố từ những prompt khớp tốt nhất.',
+  'commands.stable.ai_artist.flag.mode_search': 'Tìm prompt khớp nhất từ bộ sưu tập curated.',
+  'commands.stable.ai_artist.flag.mode_wild': 'Diễn giải sáng tạo, ngẫu hứng theo style ngẫu nhiên.',
+  'commands.stable.ai_artist.flag.skip': 'Bỏ qua bước hỏi-đáp validation, chạy thẳng.',
+  'commands.stable.ask.arg.question': 'Câu hỏi kỹ thuật, kiến trúc hoặc quyết định thiết kế.',
+  'commands.stable.bootstrap.flag.auto': 'Chế độ tự động, agent tự quyết các bước.',
+  'commands.stable.bootstrap.flag.fast': 'Bỏ qua research nhưng giữ các bước review.',
+  'commands.stable.bootstrap.flag.full': 'Chế độ interactive đầy đủ với mọi gate xác nhận.',
+  'commands.stable.bootstrap.flag.parallel': 'Chạy multi-agent song song để setup nhanh hơn.',
+  'commands.stable.code_review.flag.codebase': 'Quét và review toàn bộ codebase.',
+  'commands.stable.code_review.flag.codebase_parallel': 'Audit codebase song song với nhiều reviewer.',
+  'commands.stable.code_review.flag.commit': 'Review một commit cụ thể theo hash.',
+  'commands.stable.code_review.flag.context': 'Review những thay đổi pending (staged + unstaged).',
+  'commands.stable.code_review.flag.pending': 'Review thay đổi staged và unstaged trong git.',
+  'commands.stable.code_review.flag.pr': 'Review một pull request theo số PR.',
+  'commands.stable.cook.flag.auto': 'Tự động approve mọi bước implementation.',
+  'commands.stable.cook.flag.fast': 'Bỏ qua research, vào thẳng plan và code.',
+  'commands.stable.cook.flag.interactive': 'Workflow đầy đủ có user input (mặc định).',
+  'commands.stable.cook.flag.no_test': 'Bỏ qua bước test (chỉ cảnh báo, không chặn).',
+  'commands.stable.cook.flag.parallel': 'Chạy multi-agent song song để implement nhanh hơn.',
+  'commands.stable.cook.flag.tdd': 'Viết test trước rồi mới implement code.',
+  'commands.stable.copywriting.flag.copy_type_context': 'Loại copy và context để sinh nội dung theo brand.',
+  'commands.stable.cti_expert.arg.target': 'Mục tiêu điều tra (domain, email, username, v.v.).',
+  'commands.stable.cti_expert.flag.case': 'Workflow điều tra theo case cụ thể.',
+  'commands.stable.cti_expert.flag.flow': 'Flow hướng dẫn cho người mới điều tra.',
+  'commands.stable.cti_expert.flag.query': 'Xây dựng search operator để do thám.',
+  'commands.stable.cti_expert.flag.sweep': 'Quét đa hướng (multi-vector) cho mọi loại target.',
+  'commands.stable.cti_expert.flag.yolo': 'Bỏ qua mọi prompt, tự quyết.',
+  'commands.stable.deploy.arg.environment': 'Môi trường deploy (production, staging, dev).',
+  'commands.stable.deploy.arg.platform': 'Platform deploy (Vercel, Netlify, Railway, v.v.).',
+  'commands.stable.docs.flag.init': 'Khởi tạo bộ documentation cho project.',
+  'commands.stable.docs.flag.summarize': 'Phân tích nhanh và tóm tắt documentation.',
+  'commands.stable.docs.flag.update': 'Cập nhật và duy trì documentation hiện có.',
+  'commands.stable.fix.flag.auto': 'Bật chế độ autonomous, tự approve.',
+  'commands.stable.fix.flag.parallel': 'Chạy multi-agent song song để fix nhanh hơn.',
+  'commands.stable.fix.flag.quick': 'Vòng scout-diagnose-fix nhanh cho lỗi vặt.',
+  'commands.stable.fix.flag.review': 'Bật chế độ human-in-the-loop có review.',
+  'commands.stable.git.flag.cm': 'Stage files và tạo commit.',
+  'commands.stable.git.flag.cp': 'Stage files, commit, rồi push.',
+  'commands.stable.git.flag.merge': 'Merge source branch vào target branch.',
+  'commands.stable.git.flag.pr': 'Tạo pull request từ source sang target branch.',
+  'commands.stable.graphify.arg.path': 'Đường dẫn tới code, docs hoặc ảnh để build graph.',
+  'commands.stable.graphify.flag.mcp': 'Expose graph qua MCP server cho Claude truy vấn.',
+  'commands.stable.graphify.flag.report': 'Sinh báo cáo knowledge graph kèm insight.',
+  'commands.stable.graphify.flag.watch': 'Tự động rebuild graph khi file thay đổi.',
+  'commands.stable.plan.flag.auto': 'Tự đoán độ phức tạp và lập plan autonomously.',
+  'commands.stable.plan.flag.deep': 'Phân tích sâu với nhiều phase research mở rộng.',
+  'commands.stable.plan.flag.fast': 'Lập plan nhanh, bỏ qua phase research.',
+  'commands.stable.plan.flag.hard': 'Lập plan kỹ lưỡng kèm validation toàn diện.',
+  'commands.stable.plan.flag.no_tasks': 'Tạo plan không kèm checklist task chi tiết.',
+  'commands.stable.plan.flag.parallel': 'Lập plan multi-agent có phân chia ownership.',
+  'commands.stable.plan.flag.tdd': 'Lập plan theo hướng test-driven development.',
+  'commands.stable.plan.flag.two': 'Two-pass planning với phase challenge.',
+  'commands.stable.plan.subcommand.archive': 'Lưu trữ plan đã xong và viết retrospective.',
+  'commands.stable.plan.subcommand.red_team': 'Review đối kháng để tìm điểm yếu của plan.',
+  'commands.stable.plan.subcommand.validate': 'Validate plan theo acceptance criteria.',
+  'commands.stable.predict.flag.chain_probe': 'Dùng kỹ thuật probing trong chain-of-thought.',
+  'commands.stable.predict.flag.chain_reason': 'Dùng kỹ thuật reasoning trong chain-of-thought.',
+  'commands.stable.preview.flag.ascii': 'Sinh diagram chỉ bằng ASCII (chạy được trong terminal).',
+  'commands.stable.preview.flag.diagram': 'Sinh diagram tập trung (ASCII + Mermaid).',
+  'commands.stable.preview.flag.diff': 'Review diff trực quan cho code changes.',
+  'commands.stable.preview.flag.explain': 'Sinh giải thích trực quan (ASCII + Mermaid).',
+  'commands.stable.preview.flag.html': 'Xuất ra HTML self-contained.',
+  'commands.stable.preview.flag.plan_review': 'So sánh trực quan plan với codebase thực tế.',
+  'commands.stable.preview.flag.recap': 'Snapshot context project và tóm tắt tiến độ.',
+  'commands.stable.preview.flag.slides': 'Sinh slide thuyết trình (một concept/slide).',
+  'commands.stable.project_management.flag.hydrate': 'Nạp và populate dữ liệu task của project.',
+  'commands.stable.project_management.flag.report': 'Sinh báo cáo trạng thái và tiến độ.',
+  'commands.stable.project_management.flag.status': 'Hiện snapshot trạng thái project hiện tại.',
+  'commands.stable.project_management.flag.sync': 'Đồng bộ dữ liệu project với hệ thống tracking ngoài.',
+  'commands.stable.repomix.flag.style_json': 'Xuất ở định dạng JSON cho máy đọc.',
+  'commands.stable.repomix.flag.style_markdown': 'Xuất ở định dạng markdown với code fences.',
+  'commands.stable.repomix.flag.style_plain': 'Xuất ở định dạng plain text, không format.',
+  'commands.stable.repomix.flag.style_xml': 'Xuất ở định dạng XML có structure.',
+  'commands.stable.research.arg.topic': 'Chủ đề cần research kỹ.',
+  'commands.stable.retro.arg.timeframe': 'Khoảng thời gian phân tích (7d, 2w, 1m, sprint).',
+  'commands.stable.retro.flag.compare': 'So sánh metric với khoảng thời gian liền trước cùng độ dài.',
+  'commands.stable.retro.flag.format_html_md': 'Định dạng output (html hoặc markdown).',
+  'commands.stable.retro.flag.team': 'Chia nhỏ metric theo từng tác giả.',
+  'commands.stable.scenario.flag.iterations': 'Chạy đúng N vòng rồi dừng.',
+  'commands.stable.scenario.flag.saturation': 'Lặp tới khi phát hiện hội tụ (convergence).',
+  'commands.stable.scout.arg.ext': 'Đuôi file để filter kết quả scout.',
+  'commands.stable.scout.arg.search_target': 'File, folder hoặc pattern cần scout.',
+  'commands.stable.security_scan.arg.scope': 'Phạm vi scan (dependencies, secrets, all).',
+  'commands.stable.security_scan.flag.deps_only': 'Chỉ scan dependencies và package.',
+  'commands.stable.security_scan.flag.full': 'Quét toàn diện (tất cả check).',
+  'commands.stable.security_scan.flag.secrets_only': 'Chỉ scan secrets bị lộ.',
+  'commands.stable.security.flag.fix': 'Tự fix các vấn đề bảo mật phát hiện được.',
+  'commands.stable.security.flag.iterations': 'Số vòng red-team chạy.',
+  'commands.stable.security.flag.red_team': 'Kích hoạt kiểm thử bảo mật đối kháng (adversarial).',
+  'commands.stable.ship.flag.beta': 'Ship lên beta branch với pipeline nhẹ.',
+  'commands.stable.ship.flag.official': 'Ship lên main/master với pipeline đầy đủ.',
+  'commands.stable.ship.flag.skip_review': 'Bỏ qua bước code review.',
+  'commands.stable.ship.flag.skip_tests': 'Bỏ qua bước test (khi test đã pass trước đó).',
+  'commands.stable.stitch.flag.device_mobile': 'Tạo layout cho device mobile.',
+  'commands.stable.stitch.flag.format_all': 'Sinh mọi định dạng output có sẵn.',
+  'commands.stable.stitch.flag.format_html': 'Sinh output dạng HTML.',
+  'commands.stable.stitch.subcommand.export': 'Export design ra format ngoài.',
+  'commands.stable.stitch.subcommand.generate': 'Sinh design từ mô tả.',
+  'commands.stable.team.flag.delegate': 'Lead chỉ điều phối, không tự code.',
+  'commands.stable.team.flag.devs': 'Số agent developer cần spawn.',
+  'commands.stable.team.flag.researchers': 'Số agent researcher cần spawn.',
+  'commands.stable.team.flag.reviewers': 'Số agent reviewer cần spawn.',
+  'commands.stable.team.flag.template_context': 'Template và context để setup team.',
+  'commands.stable.test.flag.context': 'Context bổ sung cho lần chạy test.',
+  'commands.stable.test.flag.ui_url': 'URL dùng cho UI testing hoặc browser integration.',
+  'commands.stable.xia.arg.feature': 'Feature hoặc module cần port từ repo nguồn.',
+  'commands.stable.xia.arg.target': 'GitHub URL, owner/repo hoặc đường dẫn local.',
+  'commands.stable.xia.flag.auto': 'Giữ full workflow, tự approve các gate.',
+  'commands.stable.xia.flag.compare': 'Chỉ phân tích so sánh, không implement.',
+  'commands.stable.xia.flag.copy': 'Transplant với thay đổi tối thiểu.',
+  'commands.stable.xia.flag.fast': 'Bỏ qua research và challenge, tự approve.',
+  'commands.stable.xia.flag.improve': 'Copy kèm refactor cho codebase local.',
+  'commands.stable.xia.flag.port': 'Viết lại idiomatic cho stack local (mặc định).',
+  // Phase 4: Marketing Kit chip explanations (subcommands/args/flags)
+  'commands.mkt.ads_management.arg.campaign_type': 'Loại campaign (awareness, conversion).',
+  'commands.mkt.ads_management.arg.platform': 'Nền tảng quảng cáo (Google, Meta).',
+  'commands.mkt.affiliate_marketing.arg.program': 'Tên affiliate program.',
+  'commands.mkt.affiliate_marketing.arg.strategy': 'Chiến lược go-to-market.',
+  'commands.mkt.analyze.subcommand.report': 'Tạo báo cáo hiệu suất analytics.',
+  'commands.mkt.ask.arg.question': 'Câu hỏi hoặc topic marketing.',
+  'commands.mkt.assets_organizing.arg.asset_type': 'Loại asset để tổ chức.',
+  'commands.mkt.assets_organizing.arg.directory': 'Đường dẫn thư mục asset.',
+  'commands.mkt.brand.subcommand.update': 'Cập nhật brand guidelines.',
+  'commands.mkt.campaign.subcommand.analyze': 'Phân tích sâu sắc metrics campaign.',
+  'commands.mkt.campaign.subcommand.create': 'Khởi chạy campaign mới với setup đầy đủ.',
+  'commands.mkt.campaign.subcommand.email': 'Quản lý email campaign.',
+  'commands.mkt.campaign.subcommand.status': 'Hiển thị campaign hoạt động và tiến độ.',
+  'commands.mkt.code_review.arg.context': 'Code context để review.',
+  'commands.mkt.code_review.subcommand.codebase': 'Review toàn bộ codebase.',
+  'commands.mkt.code_review.subcommand.codebase_parallel': 'Review codebase song song.',
+  'commands.mkt.competitor.subcommand.alternatives': 'Tìm và phân tích các lựa chọn thay thế.',
+  'commands.mkt.competitor.subcommand.analyze': 'Phân tích vị trí cạnh tranh.',
+  'commands.mkt.competitor.subcommand.content': 'Review chiến lược nội dung competitor.',
+  'commands.mkt.competitor.subcommand.list': 'Xác định đối thủ trực tiếp.',
+  'commands.mkt.competitor.subcommand.seo': 'Phân tích SEO và ranking competitor.',
+  'commands.mkt.content_hub.subcommand.browse': 'Duyệt assets được tổ chức.',
+  'commands.mkt.content_hub.subcommand.open': 'Mở asset gallery.',
+  'commands.mkt.content_hub.subcommand.search': 'Tìm assets theo tag.',
+  'commands.mkt.dashboard.subcommand.check': 'Kiểm tra metrics dashboard.',
+  'commands.mkt.design.subcommand.banner': 'Banner quảng cáo kích thước chuẩn.',
+  'commands.mkt.design.subcommand.cip': 'Hệ thống thiết kế danh tính công ty.',
+  'commands.mkt.design.subcommand.icon': 'Thiết kế bộ icon.',
+  'commands.mkt.design.subcommand.logo': 'Logo và thiết kế brand identity.',
+  'commands.mkt.design.subcommand.slides': 'Thiết kế slide thuyết trình.',
+  'commands.mkt.design.subcommand.social': 'Thiết kế visual cho media xã hội.',
+  'commands.mkt.docs.subcommand.init': 'Khởi tạo tài liệu dự án.',
+  'commands.mkt.docs.subcommand.llms': 'Tạo docs thân thiện với LLM.',
+  'commands.mkt.docs.subcommand.summarize': 'Tóm tắt tài liệu nhanh.',
+  'commands.mkt.docs.subcommand.update': 'Cập nhật tài liệu hiện tại.',
+  'commands.mkt.elevenlabs.subcommand.clone': 'Clone voice cho TTS.',
+  'commands.mkt.elevenlabs.subcommand.sfx': 'Tạo hiệu ứng âm thanh.',
+  'commands.mkt.elevenlabs.subcommand.speak': 'Tạo text-to-speech.',
+  'commands.mkt.email.subcommand.flow': 'Email automation flows trigger-based.',
+  'commands.mkt.email.subcommand.sequence': 'Thiết kế và timing email sequences.',
+  'commands.mkt.form_cro.arg.form_url': 'URL form để tối ưu.',
+  'commands.mkt.free_tool_strategy.arg.niche': 'Target niche thị trường.',
+  'commands.mkt.free_tool_strategy.arg.tool_idea': 'Ý tưởng free tool.',
+  'commands.mkt.funnel.subcommand.analyze': 'Xác định các điểm thoát khỏi funnel.',
+  'commands.mkt.funnel.subcommand.design': 'Lập bản đồ các giai đoạn khách hàng.',
+  'commands.mkt.funnel.subcommand.optimize': 'Tối ưu chuyển đổi ở mỗi giai đoạn.',
+  'commands.mkt.gamification_marketing.arg.campaign': 'Campaign để gamify.',
+  'commands.mkt.gamification_marketing.arg.mechanic': 'Cơ chế gamification.',
+  'commands.mkt.git.subcommand.cm': 'Commit với message.',
+  'commands.mkt.git.subcommand.cp': 'Commit và push.',
+  'commands.mkt.git.subcommand.pr': 'Tạo pull request.',
+  'commands.mkt.hub.flag.scan': 'Quét assets mới.',
+  'commands.mkt.hub.flag.stop': 'Dừng dịch vụ dashboard.',
+  'commands.mkt.kit_builder.arg.component_type': 'Loại component để build.',
+  'commands.mkt.kit_builder.arg.name': 'Tên component.',
+  'commands.mkt.launch_strategy.arg.product': 'Sản phẩm để khởi chạy.',
+  'commands.mkt.onboarding_cro.arg.flow_url': 'URL onboarding flow.',
+  'commands.mkt.paid_ads.arg.campaign_type': 'Mục tiêu campaign (leads, sales).',
+  'commands.mkt.paid_ads.arg.platform': 'Nền tảng quảng cáo PPC.',
+  'commands.mkt.plan.subcommand.archive': 'Lưu trữ kế hoạch và viết retrospective.',
+  'commands.mkt.plan.subcommand.ci': 'Lập kế hoạch tập trung vào CI/CD.',
+  'commands.mkt.plan.subcommand.cro': 'Lập kế hoạch tối ưu hóa tỷ lệ chuyển đổi.',
+  'commands.mkt.plan.subcommand.fast': 'Kế hoạch nhanh không đào sâu.',
+  'commands.mkt.plan.subcommand.hard': 'Kế hoạch kỹ lưỡng với xác thực toàn diện.',
+  'commands.mkt.plan.subcommand.parallel': 'Lập kế hoạch đa agent với phân phối task.',
+  'commands.mkt.plan.subcommand.two': 'Lập kế hoạch hai lần với giai đoạn thách thức.',
+  'commands.mkt.plan.subcommand.validate': 'Xác thực kế hoạch với tiêu chí thành công.',
+  'commands.mkt.play.subcommand.blocked': 'Hiển thị task bị chặn.',
+  'commands.mkt.play.subcommand.create': 'Tạo playbook marketing mới.',
+  'commands.mkt.play.subcommand.gate': 'Đặt decision gates trong playbook.',
+  'commands.mkt.play.subcommand.goals': 'Định nghĩa mục tiêu thành công playbook.',
+  'commands.mkt.play.subcommand.learn': 'Học các mẫu playbook.',
+  'commands.mkt.play.subcommand.list': 'Liệt kê playbook có sẵn.',
+  'commands.mkt.play.subcommand.next': 'Gợi ý hành động playbook tiếp theo.',
+  'commands.mkt.play.subcommand.reset': 'Đặt lại trạng thái playbook.',
+  'commands.mkt.play.subcommand.status': 'Hiển thị trạng thái thực thi playbook.',
+  'commands.mkt.play.subcommand.templates': 'Duyệt mẫu playbook.',
+  'commands.mkt.preview.flag.ascii': 'Đầu ra chỉ ASCII.',
+  'commands.mkt.preview.flag.diagram': 'Tạo sơ đồ kiến trúc.',
+  'commands.mkt.preview.flag.explain': 'Tạo giải thích visual.',
+  'commands.mkt.preview.flag.slides': 'Tạo slide thuyết trình.',
+  'commands.mkt.pricing_strategy.arg.product': 'Sản phẩm để định giá.',
+  'commands.mkt.pricing_strategy.arg.tier': 'Mức tier giá.',
+  'commands.mkt.referral_program_building.arg.product': 'Sản phẩm có referral.',
+  'commands.mkt.referral_program_building.arg.program_type': 'Loại cơ chế referral.',
+  'commands.mkt.seo.subcommand.audit': 'Kiểm toán site đầy đủ với sửa ưu tiên.',
+  'commands.mkt.seo.subcommand.keywords': 'Nghiên cứu keyword mục tiêu và gaps.',
+  'commands.mkt.seo.subcommand.pseo': 'Tạo trang SEO quy mô lớn tự động.',
+  'commands.mkt.skill.subcommand.add': 'Thêm skill mới vào library.',
+  'commands.mkt.skill.subcommand.create': 'Tạo custom marketing skill.',
+  'commands.mkt.skill.subcommand.fix_logs': 'Debug và sửa skill logs.',
+  'commands.mkt.skill.subcommand.optimize': 'Tối ưu hiệu suất skill.',
+  'commands.mkt.skill.subcommand.plan': 'Lập kế hoạch phát triển skill.',
+  'commands.mkt.skill.subcommand.update': 'Cập nhật skill hiện tại.',
+  'commands.mkt.slides.arg.topic': 'Topic slide deck.',
+  'commands.mkt.slides.subcommand.create': 'Tạo slide thuyết trình.',
+  'commands.mkt.social.arg.platform': 'Nền tảng (Twitter, LinkedIn, TikTok).',
+  'commands.mkt.social.arg.type': 'Loại nội dung (video, carousel, text).',
+  'commands.mkt.social.subcommand.schedule': 'Lịch nội dung đa nền tảng.',
+  'commands.mkt.storage.subcommand.list': 'Liệt kê assets lưu trữ.',
+  'commands.mkt.storage.subcommand.sync': 'Đồng bộ local sang storage S3.',
+  'commands.mkt.storage.subcommand.upload': 'Upload assets lên storage.',
+  'commands.mkt.storage.subcommand.url': 'Lấy public URL cho asset.',
+  'commands.mkt.test.subcommand.ui': 'Kiểm tra UI/UX.',
+  'commands.mkt.test.subcommand.workflow': 'Kiểm tra tích hợp workflow.',
+  'commands.mkt.video.subcommand.create': 'Sản xuất video từ đầu đến cuối.',
+  'commands.mkt.video.subcommand.script': 'Viết script video thuyết phục.',
+  'commands.mkt.video.subcommand.storyboard': 'Tạo storyboard visual.',
+  'commands.mkt.write.subcommand.audit': 'Kiểm toán chất lượng nội dung hiện tại.',
+  'commands.mkt.write.subcommand.blog': 'Blog tối ưu SEO dạng dài.',
+  'commands.mkt.write.subcommand.cro': 'Copy tối ưu chuyển đổi với biến thể.',
+  'commands.mkt.write.subcommand.enhance': 'Cải thiện rõ ràng, tone, chuyển đổi.',
+  'commands.mkt.write.subcommand.fast': 'Bản nháp nhanh không qua review.',
+  'commands.mkt.write.subcommand.formula': 'Sử dụng công thức thuyết phục cho copy.',
+  'commands.mkt.write.subcommand.good': 'Nội dung chất lượng cao với review.',
+  'commands.mkt.write.subcommand.publish': 'Hoàn thiện và chuẩn bị xuất bản.',
+  'commands.mkt.youtube.subcommand.blog': 'Chuyển YouTube thành blog article.',
+  'commands.mkt.youtube.subcommand.infographic': 'Chuyển YouTube thành infographic.',
+  'commands.mkt.youtube.subcommand.social': 'Tái sử dụng YouTube cho social media.',
+  'commands.mkt.youtube_thumbnail_design.arg.niche': 'Niche nội dung cho thumbnail.',
+  'commands.mkt.youtube_thumbnail_design.arg.style': 'Tùy chọn visual style.',
 } as const;