@rse/ase 0.9.42 → 0.9.44

package/package.json

@@ -3,23 +3,23 @@
     "description":                          "Agentic Software Engineering (ASE)",
     "publishConfig":                        { "access": "public" },
     "keywords":                             [ "agentic", "ai", "coding", "tool", "cli", "software", "engineering" ],
-    "homepage":                             "http://github.com/rse/ase",
+    "homepage":                             "https://ase.tools",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
-    "bugs":                                 { "url": "http://github.com/rse/ase/issues" },
-    "version":                              "0.9.42",
+    "bugs":                                 { "url": "https://github.com/rse/ase/issues" },
+    "version":                              "0.9.44",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
         "email":                            "rse@engelschall.com",
-        "url":                              "http://engelschall.com"
+        "url":                              "https://engelschall.com"
     },
     "type":                                 "module",
     "bin":                                  { "ase": "bin/ase" },
     "devDependencies": {
         "eslint":                           "9.39.4",
         "@eslint/js":                       "9.39.4",
-        "@typescript-eslint/parser":        "8.63.0",
-        "@typescript-eslint/eslint-plugin": "8.63.0",
+        "@typescript-eslint/parser":        "8.65.0",
+        "@typescript-eslint/eslint-plugin": "8.65.0",
         "eslint-plugin-promise":            "7.3.0",
         "eslint-plugin-import":             "2.32.0",
         "neostandard":                      "0.13.0",
@@ -42,10 +42,10 @@
     },
     "dependencies": {
         "commander":                        "15.0.0",
-        "@dotenvx/dotenvx":                 "2.2.2",
+        "@dotenvx/dotenvx":                 "2.15.1",
         "yaml":                             "2.9.0",
         "valibot":                          "1.4.2",
-        "execa":                            "9.6.1",
+        "execa":                            "10.0.0",
         "mkdirp":                           "3.0.1",
         "@hapi/hapi":                       "21.4.9",
         "beautiful-mermaid":                "1.1.3",
@@ -54,20 +54,21 @@
         "pretty-ms":                        "9.3.0",
         "luxon":                            "3.7.2",
         "@modelcontextprotocol/sdk":        "1.29.0",
-        "json-asty":                        "1.3.3",
+        "json-asty":                        "1.3.4",
         "zod":                              "4.4.3",
         "which":                            "7.0.0",
         "update-notifier":                  "7.3.1",
-        "shell-quote":                      "1.9.0",
+        "shell-quote":                      "1.10.0",
         "get-stdin":                        "10.0.0",
         "proper-lockfile":                  "4.1.2",
         "write-file-atomic":                "8.0.0",
         "pacote":                           "22.0.0",
         "ofetch":                           "1.5.1",
-        "picomatch":                        "4.0.5"
+        "picomatch":                        "4.0.5",
+        "lru-cache":                        "11.5.2"
     },
     "allowScripts": {
-        "es5-ext":                          false
+        "fsevents":                         true
     },
     "engines": {
         "npm":                              ">=10.0.0",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.42",
+    "version":     "0.9.44",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.42",
+    "version":     "0.9.44",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.github/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.42",
+    "version":     "0.9.44",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",
@@ -11,7 +11,7 @@
         "email":   "rse@engelschall.com",
         "url":     "https://engelschall.com"
     },
-    "hooks":       "hooks/hooks-copilot.json",
+    "hooks":       "./hooks/hooks-copilot.json",
     "mcpServers": {
         "ase": {
             "command": "ase",

package/plugin/agents/ase-code-lint.md

@@ -50,7 +50,7 @@ Workflow
     -   **A03 - CLEANLINESS**:
         Check for unclean code and inconsistent code.
 
-        For unclean code, especially detect out-dated code construct
+        For unclean code, especially detect outdated code construct
         patterns. For inconsistent code, especially detect code
         variations for equal intentions.
 
@@ -246,7 +246,7 @@ Workflow
         *masks* another bug (e.g., unreachable code after a misplaced
         `return` that skips cleanup logic).
 
-    Be conservative — only report clear, well-grounded issues
+    Be conservative - only report clear, well-grounded issues
     that require an actual *code change*. Think twice to avoid
     *false positives*.
 
@@ -314,9 +314,9 @@ Workflow
             4.  Set <context-after/> to exactly *up to two* lines of
                 *unchanged* code content which occurs in <file/>
                 directly *after* <old-text/>, i.e., the lines (<line/>
-                + <n/> + 1) and (<line/> + <n/> + 2), where <n/> is the
+                + <n/>) and (<line/> + <n/> + 1), where <n/> is the
                 number of lines in <old-text/>. Reduce to just one line
-                (<line/> + <n/> + 1) if <old-text/> is the second-last
+                (<line/> + <n/>) if <old-text/> is the second-last
                 line of the file. Set <context-after/> to empty if
                 <old-text/> is the last line in the file.
 

package/plugin/agents/ase-docs-proofread.md

@@ -40,7 +40,7 @@ Workflow
 
     3.  Set <old-text/> to the lines of the old text which
         should be changed. Set <new-text/> to the lines of the
-        new text which will be changed.
+        new text which will replace it.
 
     4.  Set <description/> to an ultra-brief and concise
         Markdown-formatted description of the problem with

package/plugin/agents/ase-meta-chat.md

@@ -3,12 +3,12 @@ name: ase-meta-chat
 description: "Query Foreign LLM for Chat via MCP Tool"
 effort: high
 tools:
-    - mcp__chat-openai-chatgpt__query
-    - mcp__chat-google-gemini__query
-    - mcp__chat-deepseek__query
-    - mcp__chat-xai-grok__query
-    - mcp__chat-zai-glm__query
-    - mcp__chat-alibaba-qwen__query
+    - "mcp__chat-openai-chatgpt__query"
+    - "mcp__chat-google-gemini__query"
+    - "mcp__chat-deepseek__query"
+    - "mcp__chat-xai-grok__query"
+    - "mcp__chat-zai-glm__query"
+    - "mcp__chat-alibaba-qwen__query"
 ---
 
 @../meta/ase-control.md

package/plugin/agents/ase-meta-diagram.md

@@ -1,9 +1,9 @@
 ---
 name: ase-meta-diagram
 description: "Diagram Rendering"
+effort: high
 tools:
     - "mcp__plugin_ase_ase__ase_diagram"
-effort: high
 ---
 
 Your role is to render a *single* diagram, with *deterministic* and

package/plugin/agents/ase-meta-search.md

@@ -1,6 +1,6 @@
 ---
 name: ase-meta-search
-description: Query the Web
+description: "Query the Web"
 model: sonnet
 effort: low
 tools:

package/plugin/etc/eslint.mjs

@@ -5,11 +5,9 @@
 */
 
 import { defineConfig } from "eslint/config"
-import markdown         from "@eslint/markdown"
 import md               from "eslint-markdown"
 
 export default defineConfig([
-    // markdown.configs.recommended,
     md.configs.recommended,
     {
         files: [

package/plugin/meta/ase-constitution.md

@@ -6,7 +6,7 @@ You are an expert-level AI coding assistant.
 You have the **Agentic Software Engineering (ASE)** companion toolkit enabled,
 which boosts you to an expert-level Software Engineering AI agent.
 
-If ((<ase-agent-tool/> is equal `codex`) *AND* (<ase-headless/> is empty
+If ((<ase-agent-tool/> is equal to `codex`) *AND* (<ase-headless/> is empty
 or not set)) you *MUST* output the following <template/> *exactly once*
 as the very *first* thing in your *first* response of this session --
 *before* any other text, *before* any tool call, and *before* entering

package/plugin/meta/ase-control.md

@@ -93,5 +93,5 @@ Control Flow Constructs
     This specifies an *early termination* of the innermost enclosing
     <while/> or <for/> repetition: when reached, the current repetition
     is finished and no further repetitions are performed. This construct
-    is expanded into nothing. Do not output anything else.
+    is expanded into nothing. Do not output anything.
 

package/plugin/meta/ase-dialog.md

@@ -140,8 +140,8 @@ following procedure:
             </if>
             <else>
                 Output the following <template/> and then *START OVER*
-                by *GOING* to step 2.2.2 above, reusing the already-built
-                <text/> from step 2.2.1 unchanged (do *NOT* re-enter step 2.2.1
+                by *GOING* to step 2.2 above, reusing the already-built
+                <text/> from step 2.1 unchanged (do *NOT* re-enter step 2.1
                 and do *NOT* rebuild <text/>, <keys/>, <n/>, or <width/>).
 
                 <template>

package/plugin/meta/ase-format-arch.md

@@ -209,7 +209,7 @@ at runtime.
     -   Kind:           <arch-fv-component-kind/>
     -   Responsibility: <arch-fv-component-responsibility/>
     -   Interface:      <arch-fv-component-interface/>
-    -   Depends On:     <arch-fv-component-dependency/>, [...]
+    -   Depends On:     <arch-fv-component-dependency/>[, ...]
 
     <arch-fv-component-description/>,
     **BECAUSE** <arch-fv-component-rationale/>.
@@ -286,7 +286,7 @@ flow.
     ##  ASPECT: <arch-iv-aspect-name/> <a id="ARCH-IV-<arch-iv-aspect-id/>"></a>
 
     -   Concern:    <arch-iv-aspect-concern/>
-    -   Entities:   <arch-iv-aspect-entity/>, [...]
+    -   Entities:   <arch-iv-aspect-entity/>[, ...]
     -   Owner:      <arch-iv-aspect-owner/>
     -   Lifecycle:  <arch-iv-aspect-lifecycle/>
 
@@ -364,7 +364,7 @@ communicate.
     ##  UNIT: <arch-co-unit-name/> <a id="ARCH-CO-<arch-co-unit-id/>"></a>
 
     -   Kind:         <arch-co-unit-kind/>
-    -   Hosts:        <arch-co-unit-element/>, [...]
+    -   Hosts:        <arch-co-unit-element/>[, ...]
     -   Multiplicity: <arch-co-unit-multiplicity/>
     -   Coordination: <arch-co-unit-coordination/>
 
@@ -507,7 +507,7 @@ elements to the runtime platform, hardware, and network topology.
 
     -   Kind:     <arch-dp-node-kind/>
     -   Platform: <arch-dp-node-platform/>
-    -   Hosts:    <arch-dp-node-element/>, [...]
+    -   Hosts:    <arch-dp-node-element/>[, ...]
     -   Network:  <arch-dp-node-network/>
 
     <arch-dp-node-description/>,
@@ -584,7 +584,7 @@ production, defining installation, monitoring, and management concerns.
     ##  CONCERN: <arch-ov-concern-name/> <a id="ARCH-OV-<arch-ov-concern-id/>"></a>
 
     -   Category: <arch-ov-concern-category/>
-    -   Element:  <arch-ov-concern-element/>, [...]
+    -   Element:  <arch-ov-concern-element/>[, ...]
 
     <arch-ov-concern-description/>,
     **BECAUSE** <arch-ov-concern-rationale/>.
@@ -651,9 +651,9 @@ How the Non-Functional Requirements (NR) are addressed.
     ##  PERSPECTIVE: <arch-qp-perspective-name/> <a id="ARCH-QP-<arch-qp-perspective-id/>"></a>
 
     -   Quality:    <arch-qp-perspective-quality/>
-    -   Addresses:  <arch-qp-perspective-requirement/>, [...]
+    -   Addresses:  <arch-qp-perspective-requirement/>[, ...]
     -   Tactic:     <arch-qp-perspective-tactic/>
-    -   Affects:    <arch-qp-perspective-element/>, [...]
+    -   Affects:    <arch-qp-perspective-element/>[, ...]
 
     <arch-qp-perspective-description/>,
     **BECAUSE** <arch-qp-perspective-rationale/>.
@@ -740,7 +740,7 @@ forces at play, the chosen response, and the reasoning that justifies it.
     ##  DECISION: <arch-dr-decision-name/> <a id="ARCH-DR-<arch-dr-decision-id/>"></a>
 
     -   Status:        <arch-dr-decision-status/>
-    -   Affects:       <arch-dr-decision-element/>, [...]
+    -   Affects:       <arch-dr-decision-element/>[, ...]
     -   Superseded-By: <arch-dr-decision-superseded-by/>
     -   Created:       <arch-dr-decision-created/>
     -   Modified:      <arch-dr-decision-modified/>

package/plugin/meta/ase-format-task.md

@@ -40,8 +40,8 @@ You *MUST* honor the following hints on this *task* format:
     <template>`<code/>`</template> and *key aspects* as
     <template>*<aspect/>*</template>.
 
--   For <summary-what/> and <summary-why/> use *ultra brief* but
-    as *very precise* as possible description of the overall change. In
+-   For <summary-what/> and <summary-why/> use an *ultra brief* but
+    *as precise as possible* description of the overall change. In
     <summary-what/> tell what is changed. In <summary-why/> tell why it
     is changed, what benefit results or what the rationale is behind the
     change.
@@ -49,14 +49,12 @@ You *MUST* honor the following hints on this *task* format:
 -   The <task-id/> has to be substituted with the current value of
     <ase-task-id/> in the current session context.
 
--   The <timestamp-created/> is the timestamp when this feature
-    crafting specification was created. The
-    <timestamp-modified/> is the timestamp when this feature
-    specification was last modified. Both use an ISO-style format
-    value. The value of both can be determined by
-    a call to the `ase_timestamp(format: "yyyy-LL-dd HH:mm")`
-    tool of the `ase` MCP server and use the `text` field of
-    its response.
+-   The <timestamp-created/> is the timestamp when this task plan was
+    created. The <timestamp-modified/> is the timestamp when this
+    task plan was last modified. Both use an ISO-style format
+    value. The value of both can be determined by a call to the
+    `ase_timestamp(format: "yyyy-LL-dd HH:mm")` tool of the `ase` MCP
+    server and use the `text` field of its response.
 
 -   The <title/> is a short summary of the <summary-what/>, no longer than
     50 characters.

package/plugin/meta/ase-getopt.md

@@ -20,7 +20,7 @@ set placeholders into the context as a side-effect.
     3-6 are *structurally unreachable* and you *MUST NOT* call the
     `ase_getopt` MCP tool under any circumstances.
 
-    <if condition="<getopt-args/> does *NOT* match the regexp `(^|\s)-` (i.e. it does not start with an option)">
+    <if condition="<getopt-args/> does *NOT* match the regexp `(^|\s)-` (i.e. it does not contain an option)">
         Parse the options *locally*, without any MCP call:
 
         For each option token in <getopt-spec/> of the form

package/plugin/meta/ase-skill.md

@@ -218,7 +218,7 @@ Skill Identification
     following output <template/>:
 
     <template>
-    ⧉ **ASE**: ✪ skill: **<skill-name/>**, status: **skill finished**
+    ⧉ **ASE**: ✪ skill: **<skill-name/>**, ▶ status: **skill finished**
     </template>
 
 -   *IMPORTANT*: Set <objective></objective> (set to empty).

package/plugin/package.json

@@ -3,23 +3,23 @@
     "description":                          "Agentic Software Engineering (ASE)",
     "private":                              true,
     "keywords":                             [ "agentic", "ai", "coding", "tool", "cli", "software", "engineering" ],
-    "homepage":                             "http://github.com/rse/ase",
+    "homepage":                             "https://ase.tools",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
-    "bugs":                                 { "url": "http://github.com/rse/ase/issues" },
-    "version":                              "0.9.42",
+    "bugs":                                 { "url": "https://github.com/rse/ase/issues" },
+    "version":                              "0.9.44",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
         "email":                            "rse@engelschall.com",
-        "url":                              "http://engelschall.com"
+        "url":                              "https://engelschall.com"
     },
     "devDependencies": {
         "@rse/stx":                         "1.1.6",
-        "markdownlint":                     "0.41.0",
-        "markdownlint-cli2":                "0.23.0",
-        "eslint":                           "10.6.0",
+        "markdownlint":                     "0.41.1",
+        "markdownlint-cli2":                "0.23.1",
+        "eslint":                           "10.7.0",
         "@eslint/markdown":                 "8.0.3",
-        "eslint-markdown":                  "0.12.0"
+        "eslint-markdown":                  "0.12.1"
     },
     "engines": {
         "npm":                              ">=10.0.0",

package/plugin/skills/ase-arch-analyze/help.md

@@ -12,8 +12,8 @@
 ##  DESCRIPTION
 
 The `ase-arch-analyze` skill reviews the *software architecture* of
-the referenced source code, including *package cohesion* and *inter-
-package coupling*, for *potential problems* across component boundaries,
+the referenced source code, including *package cohesion* and
+*inter-package coupling*, for *potential problems* across component boundaries,
 structural organization, architecture principles, interface quality,
 quality attributes, and architecture governance.
 

package/plugin/skills/ase-arch-discover/SKILL.md

@@ -134,7 +134,7 @@ for the technology stack to *provide* the *needed functionality*
     4.  If <stack/> is "JavaScript" or "TypeScript":
 
         1.  Based on the essential keywords <keyword-L/> (L=1-M),
-            use the `ase-meta-search` skill in a subagent to *generally*
+            use the `ase-meta-search` skill in a sub-agent to *generally*
             discover an initial set of a maximum of <pool/> *NPM packages*
             <component-K/> and at least their real name <name-K/> and
             their unique package names <package-K/>.
@@ -150,7 +150,7 @@ for the technology stack to *provide* the *needed functionality*
     5.  If <stack/> is "Java" or "Kotlin":
 
         1.  Based on the essential keywords <keyword-L/> (L=1-M),
-            use the `ase-meta-search` skill in a subagent to *generally*
+            use the `ase-meta-search` skill in a sub-agent to *generally*
             discover an initial set of a maximum of <pool/> *Maven packages*
             <component-K/> and at least their real name <name-K/> and
             their unique Maven coordinates <package-K/> of the form

package/plugin/skills/ase-arch-discover/help.md

@@ -33,8 +33,9 @@ demotes dependency-heavy components.
 ##  OPTIONS
 
 `--limit`|`-l=12`:
-    The *maximum* number of components searched per source and retained
-    in the final ranking (default: 12). Raise it for a broader, more
+    The *maximum* number of components retained in the final ranking
+    (default: 12); each discovery source may fetch up to twice this
+    number of candidates for ranking. Raise it for a broader, more
     exhaustive survey, lower it for a quicker, narrower lookup.
 
 `--staleness`|`-s=18`:

package/plugin/skills/ase-code-analyze/SKILL.md

@@ -199,7 +199,6 @@ problems in *performance* and *efficiency*, or problems in *security*.
     Finally, output the following <template/> to give a final hint:
 
     <template>
-    ⧉ **ASE**: ☻ skill: **<skill-name/>**, ▶ status: **skill finished**
     ⧉ **ASE**: ↪ hint: **For deeper analysis, suggestions on solution approaches and then final problem resolution, use `/ase-code-resolve P{n}` in the same or even a different session.**
     </template>
 

package/plugin/skills/ase-code-craft/SKILL.md

@@ -139,15 +139,15 @@ permitted way to persist artifacts is via `ase_task_save(...)`.
 
     You *MUST* perform the following sub-steps *internally* and *without
     any output* until and including the recommendation decision. Only
-    sub-steps 4-6 below are allowed to produce output, and only if
+    sub-steps 4-7 below are allowed to produce output; sub-steps 4-6 only if
     <getopt-option-auto/> is equal `false` *and* <ase-project-boxing/>
     is *not* equal `black`.
 
     If <getopt-option-auto/> is equal `true` or <ase-project-boxing/> is
-    equal `black`, *skip* the reporting sub-steps 4-6 entirely (perform
-    no output at all) to speed up processing.
+    equal `black`, *skip* the reporting sub-steps 4-6 entirely (they
+    perform no output at all) to speed up processing.
 
-    1.  *Propose* corresponding *feature approach*, including optionally,
+    1.  *Propose* a corresponding *feature approach*, optionally including
         some *alternative* feature approaches. Do *not* output anything
         in this sub-step.
 

package/plugin/skills/ase-code-lint/SKILL.md

@@ -104,7 +104,7 @@ related to a set of code quality aspects.
     *silently drop* all other problems. With the default floor `LOW`, all
     problems are kept. `ACCEPTED` problems are *never* dropped.
 
-    You *MUST* *NOT* output anything else in this step 1.
+    You *MUST* *NOT* output anything else in this STEP 1.
 
     </step>
 
@@ -131,7 +131,7 @@ related to a set of code quality aspects.
     *(no problems detected)*
     </template>
 
-    You *MUST* *NOT* output anything else in this step 2.
+    You *MUST* *NOT* output anything else in this STEP 2.
 
     </step>
 
@@ -294,7 +294,7 @@ related to a set of code quality aspects.
 
             </template>
 
-        5.  <if condition="<getopt-option-auto/> is not 'true' and <ase-project-boxing/> is not equal `black`">
+        5.  <if condition="<getopt-option-auto/> is not equal `true` and <ase-project-boxing/> is not equal `black`">
 
             <if condition="<ase-project-boxing/> is equal `grey`">
 
@@ -341,7 +341,7 @@ related to a set of code quality aspects.
 
             </else>
 
-        6.  <if condition="<getopt-option-auto/> is not 'true'">
+        6.  <if condition="<getopt-option-auto/> is not equal `true`">
 
             In the following, you *MUST* *NOT* use your built-in
             <user-dialog-tool/> tool! Instead, you *MUST* just show a
@@ -359,7 +359,7 @@ related to a set of code quality aspects.
             <else>
 
             Set <result>ACCEPT</result>.
-            You *MUST* *NOT* output anything else in this step 6.
+            You *MUST* *NOT* output anything else in this sub-step 6.
 
             </else>
 
@@ -367,11 +367,13 @@ related to a set of code quality aspects.
 
             -   <if condition="<result/> is 'ACCEPT'">
                 Invoke the `Edit` tool to apply the changes exactly
-                as shown in the <diff/>. The operation will be
-                auto-approved by the ASE `pre-tool-use` hook (which
-                tracks the active skill), so *no* interactive permission
-                prompt will appear. After applying the changes, just
-                continue with the next <item/>.
+                as given by the hunks of the current <change-set/>
+                (rendered as <diff/>, unless suppressed under grey
+                boxing). The operation will be auto-approved by the ASE
+                `pre-tool-use` hook (which tracks the active skill),
+                so *no* interactive permission prompt will appear.
+                After applying the changes, just continue with the next
+                <item/>.
                 </if>
 
             -   <if condition="<result/> starts with 'OTHER'">

package/plugin/skills/ase-code-refactor/SKILL.md

@@ -3,7 +3,7 @@ name: ase-code-refactor
 argument-hint: "[--help|-h] [--auto|-a] [--dry|-d] [--quick|-Q] [--next|-n <option>[,...]] [<task-id>:] <request>"
 description: >
     Refactor Code:
-    Use when user wants to "refactor", or "change" the code base.
+    Use when user wants to "refactor" or "change" the code base.
 user-invocable: true
 disable-model-invocation: false
 effort: xhigh
@@ -139,16 +139,16 @@ permitted way to persist artifacts is via `ase_task_save(...)`.
 
     You *MUST* perform the following sub-steps *internally* and *without
     any output* until and including the recommendation decision. Only
-    sub-steps 4-6 below are allowed to produce output, and only if
+    sub-steps 4-7 below are allowed to produce output; sub-steps 4-6 only if
     <getopt-option-auto/> is equal `false` *and* <ase-project-boxing/>
     is *not* equal `black`.
 
     If <getopt-option-auto/> is equal `true` or <ase-project-boxing/> is
-    equal `black`, *skip* the reporting sub-steps 4-6 entirely (perform
-    no output at all) to speed up processing.
+    equal `black`, *skip* the reporting sub-steps 4-6 entirely (they
+    perform no output at all) to speed up processing.
 
-    1.  *Propose* corresponding *refactoring approach*, including
-        optionally, some *alternative* refactoring approaches. Do *not*
+    1.  *Propose* a corresponding *refactoring approach*, optionally
+        including some *alternative* refactoring approaches. Do *not*
         output anything in this sub-step.
 
     2.  *Reflect* on and *critique* the proposed approaches by deriving,

package/plugin/skills/ase-code-refactor/help.md

@@ -56,7 +56,7 @@ plan via `ase_task_save` and then hands off to `ase-task-edit`,
     skill. For all other head tokens, the *entire* list is forwarded
     to `ase-task-edit`, which consumes its head itself. This lets an
     entire pipeline be pre-scripted in one shot. Recognized tokens at
-    this skill: `none` (default, hand-off to `ase-task-edit`
+    this skill: `none` (default, hand off to `ase-task-edit`
     interactively), `DONE` (stop), `EDIT` (hand off to
     `ase-task-edit`), `PREFLIGHT` (hand off to `ase-task-preflight`),
     or `IMPLEMENT` (hand off to `ase-task-implement`). Example:

package/plugin/skills/ase-code-resolve/SKILL.md

@@ -193,15 +193,15 @@ permitted way to persist artifacts is via `ase_task_save(...)`.
 
     You *MUST* perform the following sub-steps *internally* and *without
     any output* until and including the recommendation decision. Only
-    sub-steps 4-6 below are allowed to produce output, and only if
+    sub-steps 4-7 below are allowed to produce output; sub-steps 4-6 only if
     <getopt-option-auto/> is equal `false` *and* <ase-project-boxing/>
     is *not* equal `black`.
 
     If <getopt-option-auto/> is equal `true` or <ase-project-boxing/> is
-    equal `black`, *skip* the reporting sub-steps 4-6 entirely (perform
-    no output at all) to speed up processing.
+    equal `black`, *skip* the reporting sub-steps 4-6 entirely (they
+    perform no output at all) to speed up processing.
 
-    1.  *Propose* corresponding *resolution approach*, including optionally,
+    1.  *Propose* a corresponding *resolution approach*, optionally including
         some *alternative* resolution approaches. Do *not* output anything
         in this sub-step.
 

package/plugin/skills/ase-code-resolve/help.md

@@ -61,7 +61,7 @@ plan via `ase_task_save` and then hands off to `ase-task-edit`,
     skill. For all other head tokens, the *entire* list is forwarded
     to `ase-task-edit`, which consumes its head itself. This lets an
     entire pipeline be pre-scripted in one shot. Recognized tokens at
-    this skill: `none` (default, hand-off to `ase-task-edit`
+    this skill: `none` (default, hand off to `ase-task-edit`
     interactively), `DONE` (stop), `EDIT` (hand off to
     `ase-task-edit`), `PREFLIGHT` (hand off to `ase-task-preflight`),
     or `IMPLEMENT` (hand off to `ase-task-implement`). Example:

package/plugin/skills/ase-docs-distill/help.md

@@ -37,14 +37,16 @@ document has fewer salient points than *N*, the skill emits only the
 points it found and *never pads* the list with filler; a `0`, negative, or
 non-numeric value falls back to the default *5*.
 
-##  ARGUMENTS
+##  OPTIONS
 
-`--top`, `-t` *N*:
+`--top`|`-t` *N*:
     Bound the ranked list to at most *N* key points (default *5*). The
     bound is a *cap*, never a *quota* - fewer points are emitted when the
     document does not contain *N* salient ones, and an invalid or
     non-positive *N* reverts to the default.
 
+##  ARGUMENTS
+
 *document-reference*:
     The document to distill - either a *path* to a readable file or the
     *text* itself pasted inline. If it resolves to a readable file the
@@ -58,10 +60,10 @@ Distill the key points of a document file:
 ❯ /ase-docs-distill doc/architecture.md
 ```
 
-Distill only the top 5 key points:
+Distill only the top 3 key points:
 
 ```text
-❯ /ase-docs-distill --top 5 doc/architecture.md
+❯ /ase-docs-distill --top 3 doc/architecture.md
 ```
 
 Distill a pasted block of text: