@agent-native/core 0.42.0 → 0.44.0

package/dist/cli/skills.js

@@ -16,7 +16,7 @@ const HELP = `agent-native skills
 
 Usage:
   agent-native skills list
-  agent-native skills add assets|design-exploration|visual-plan|visual-recap|visual-questions|ui-plan|prototype-plan|plan-design|context-xray [--client codex|claude-code|claude-code-cli|cowork|all] [--scope user|project] [--mcp-url <url>] [--no-connect] [--with-github-action] [--yes] [--dry-run] [--json]
+  agent-native skills add assets|design-exploration|visual-plan|visual-recap|context-xray [--client codex|claude-code|claude-code-cli|cowork|all] [--scope user|project] [--mcp-url <url>] [--no-connect] [--with-github-action] [--yes] [--dry-run] [--json]
   agent-native skills add <manifest-or-app-dir> [--client ...] [--yes]
 
 Examples:
@@ -583,7 +583,7 @@ only for tiny previews or genuinely linear step flows. Repeat a wireframe in the
 for a genuinely new detail view or comparison. Skip the visual surface entirely
 for non-visual work and write a clean rich document. For a simple binary UI
 visual choice, show the two directions in the canvas only; do not repeat the
-same options as body wireframes, a \`decision\` block, or prose. Put the actual
+same options as body wireframes or prose. Put the actual
 choice in the bottom "Open Questions" form.
 
 **Use the right block, and make it carry substance.** For the authoritative,
@@ -606,14 +606,14 @@ so you never emit a block the editor cannot render or round-trip:
   the exact code is unknown, show the smallest plausible planned shape or a
   commented stub naming what to fill in. (\`code-tabs\` and \`implementation-map\`
   are legacy: their renderers stay for old plans, but do not author new ones.)
-- \`decision\` ONLY for a genuinely-open either/or the reviewer must still pick
-  between — two or three option cards with real consequences. If you have already
-  committed to an approach, state it as settled prose or a \`callout\`, NOT a
-  \`decision\` block; a decision card for a question you have already answered just
-  reads as a confusing mid-document form. Never duplicate the same choice across a
-  \`decision\` block and the bottom Open Questions \`question-form\` — pick one home
-  for it. These are static records; do not style them like clickable tabs or chips
-  unless the renderer truly supports changing the selection.
+- For a decision: if the reviewer must still pick between a genuinely-open
+  either/or, put it in the bottom Open Questions \`question-form\` as a \`single\`
+  question — one option per real alternative, each with a short detail and
+  \`recommended: true\` on the one you would choose; do not also restate the same
+  choice elsewhere. If you have already committed to an approach, state it as
+  settled prose or a \`callout\` with \`tone="decision"\`, optionally with a
+  \`columns\` block for a side-by-side comparison of the options you weighed — not
+  as a confusing mid-document form for a question you have already answered.
 - \`columns\` for side-by-side before/after or current/target comparisons where
   each side needs real nested blocks; label the columns clearly and avoid
   stacking comparison blocks vertically when parallel reading is the point.
@@ -642,6 +642,11 @@ so you never emit a block the editor cannot render or round-trip:
 **Open questions live at the bottom as a form when answers would change the
 plan.** Surface answerable unresolved decisions in a final \`question-form\`
 block titled "Open Questions" so the renderer presents it as a distinct section.
+That bottom form is the ONLY place that enumerates the open questions: never add
+a second "Open Questions" heading, list, or recap of the same questions earlier
+in the document. A one-line pointer in the overview prose ("a few decisions are
+still open — see Open Questions below") is fine, but do not reproduce the
+question list or a parallel questions/decisions section above it.
 Use \`single\` or \`multi\` for clear choices, \`freeform\` for constraints,
 \`recommended: true\` for the default you would pick, and option \`wireframe\` /
 \`diagram\` previews only when the options are not already visible in the top
@@ -650,8 +655,7 @@ reviewer can answer with a custom option — never add an explicit "Other" optio
 yourself; set \`allowOther: false\` only when a free-text answer makes no sense.
 Keep non-answerable assumptions or risks as concise \`callout\` blocks in
 the relevant section. Never bury a questions/decisions wall inside the plan
-narrative, and never ask the same question in both a \`decision\` block and a
-\`question-form\`.
+narrative, and never ask the same question twice.
 
 **\`custom-html\` is a bounded escape hatch only** — a single complete fragment
 inside a block, never \`html\`/\`head\`/\`body\`/\`script\` tags, never a generic
@@ -680,8 +684,9 @@ correct desktop footprint, theme, and one subtle whole-frame wobble. Plain-text
 designer notes sit spaced off the frame, pointing only at the controls that need
 explanation. Below it, a Claude/Codex-grade document: objective and
 done-criteria, a few \`code\` blocks (grouped in a vertical \`tabs\` block when
-more than one) showing the real shape of the load-bearing files, a \`decision\`
-card weighing two real approaches,
+more than one) showing the real shape of the load-bearing files, a \`callout\`
+with \`tone="decision"\` stating the chosen approach with a \`columns\` block
+weighing the two real options behind it,
 and a validation step — none of it repeating the canvas. If the task also
 changes a multi-step completion flow, the same top area includes a Prototype tab
 whose screens use the same labels and states as the canvas artboards, with
@@ -1980,16 +1985,12 @@ export const BUILT_IN_APP_SKILLS = {
         skillName: "visual-plan",
         extraSkills: {
             "visual-recap": VISUAL_RECAP_SKILL_MD,
-            "visual-questions": VISUAL_QUESTIONS_SKILL_MD,
-            "ui-plan": UI_PLAN_SKILL_MD,
-            "prototype-plan": PROTOTYPE_PLAN_SKILL_MD,
-            "plan-design": PLAN_DESIGN_SKILL_MD,
         },
         manifest: normalizeAppSkillManifest({
             schemaVersion: 1,
             id: "visual-plans",
             displayName: "Agent-Native Plan",
-            description: "Generate and review coding-agent plans as structured documents with inline diagrams, implementation maps, optional UI wireframes/prototypes, annotations, feedback, and HTML export.",
+            description: "Generate and review coding-agent plans as structured documents with inline diagrams, implementation maps, annotations, feedback, and HTML export.",
             hosted: {
                 url: "https://plan.agent-native.com",
                 mcpUrl: "https://plan.agent-native.com/_agent-native/mcp",
@@ -1997,7 +1998,7 @@ export const BUILT_IN_APP_SKILLS = {
             mcp: { serverName: "agent-native-plans" },
             auth: {
                 mode: "oauth",
-                setup: "Install with the Agent-Native CLI to add the /visual-plan, /visual-recap, /ui-plan, /prototype-plan, /plan-design, and /visual-questions skills plus the Plan MCP connector. Authenticate only for hosted/account-backed sharing.",
+                setup: "Install with the Agent-Native CLI to add the /visual-plan and /visual-recap skills plus the Plan MCP connector. Authenticate only for hosted/account-backed sharing.",
             },
             surfaces: [
                 {
@@ -2012,30 +2013,6 @@ export const BUILT_IN_APP_SKILLS = {
                     path: "/plans",
                     description: "Create a visual recap plan from a PR, commit, branch, or git diff for high-altitude review.",
                 },
-                {
-                    id: "visual-questions",
-                    action: "create-visual-questions",
-                    path: "/plans",
-                    description: "Create a visual intake questionnaire before generating or updating an Agent-Native plan.",
-                },
-                {
-                    id: "ui-plan",
-                    action: "create-ui-plan",
-                    path: "/plans",
-                    description: "Create a UI-first Agent-Native plan with an optional top pan/zoom wireframe canvas and a refined rich document below.",
-                },
-                {
-                    id: "prototype-plan",
-                    action: "create-prototype-plan",
-                    path: "/plans",
-                    description: "Create a prototype-first Agent-Native plan with a functional live prototype above the document.",
-                },
-                {
-                    id: "plan-design",
-                    action: "create-plan-design",
-                    path: "/plans",
-                    description: "Create a full-fidelity Agent-Native design plan with a Design canvas tab and optional matching Prototype tab.",
-                },
             ],
             skills: [
                 {
@@ -2048,26 +2025,6 @@ export const BUILT_IN_APP_SKILLS = {
                     visibility: "exported",
                     exportAs: "visual-recap",
                 },
-                {
-                    path: "skills/visual-questions",
-                    visibility: "exported",
-                    exportAs: "visual-questions",
-                },
-                {
-                    path: "skills/ui-plan",
-                    visibility: "exported",
-                    exportAs: "ui-plan",
-                },
-                {
-                    path: "skills/prototype-plan",
-                    visibility: "exported",
-                    exportAs: "prototype-plan",
-                },
-                {
-                    path: "skills/plan-design",
-                    visibility: "exported",
-                    exportAs: "plan-design",
-                },
             ],
             hostAdapters: [
                 "codex-plugin",
@@ -2135,17 +2092,6 @@ const BUILT_IN_APP_SKILL_ALIASES = {
     "visual-recaps": "visual-plans",
     "code-review-recap": "visual-plans",
     "code-review-recaps": "visual-plans",
-    "visual-questions": "visual-plans",
-    "visual-question": "visual-plans",
-    "ui-plan": "visual-plans",
-    "ui-plans": "visual-plans",
-    "prototype-plan": "visual-plans",
-    "prototype-plans": "visual-plans",
-    "plan-design": "visual-plans",
-    "plan-designs": "visual-plans",
-    "design-plan": "visual-plans",
-    "design-plans": "visual-plans",
-    prototype: "visual-plans",
     "html-plan": "visual-plans",
     "plan-mode": "visual-plans",
     plannotate: "visual-plans",
@@ -2169,10 +2115,6 @@ const BUILT_IN_APP_SKILL_DISPLAY_ALIASES = {
         "visual-plan",
         "visual-recap",
         "code-review-recap",
-        "visual-questions",
-        "ui-plan",
-        "prototype-plan",
-        "plan-design",
         "html-plan",
         "plannotate",
     ],