@rse/ase 0.9.7 → 0.9.8

package/plugin/skills/ase-task-edit/SKILL.md

@@ -23,7 +23,7 @@ Iteratively Edit a Task Plan
 
 <expand name="getopt"
     arg1="ase-task-edit"
-    arg2="--plan|-p=(none|OVERWRITE|REFINE|PRESERVE) --dry|-d --next|-n=(none|DONE|GRILL|PREFLIGHT|IMPLEMENT)...">
+    arg2="--plan|-p=(none|OVERWRITE|REFINE|PRESERVE) --dry|-d --next|-n=(none|DONE|GRILL|PREFLIGHT|IMPLEMENT)... --int-reuse-task">
     $ARGUMENTS
 </expand>
 
@@ -67,7 +67,7 @@ the <instruction/> and all decisions you derived from the
 
 If a `CHANGELOG.md` file exists in the project (or in any
 affected sub-package), the plan *MUST* include, as part of
-its `## ※ CHANGES` section, an explicit bullet point
+its `##  CHANGES` section, an explicit bullet point
 describing the addition of a corresponding new entry to
 that `CHANGELOG.md` file, aligned with its existing style
 and conventions.
@@ -111,7 +111,7 @@ Set <content-dirty>true</content-dirty>.
             </template>
             </if>
 
-        2.  else <if condition="
+        2.  <elseif condition="
                 <instruction/> has the format `<id/>: <text/>` where
                 <id/> matches the regexp `^[a-zA-Z][a-zA-Z0-9_-]*$` and
                 <text/> is *empty*
@@ -126,9 +126,9 @@ Set <content-dirty>true</content-dirty>.
             <template>
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **task given**
             </template>
-            </if>
+            </elseif>
 
-        3.  else <if condition="
+        3.  <elseif condition="
                 <instruction/> has the format `<id/>: <text/>` where
                 <id/> matches the regexp `^[a-zA-Z][a-zA-Z0-9_-]*$` and
                 <text/> is *not empty*
@@ -144,9 +144,9 @@ Set <content-dirty>true</content-dirty>.
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **task given**
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ⇌ instruction: **<instruction/>**, ▶ status: **instruction given**
             </template>
-            </if>
+            </elseif>
 
-        4.  else <if condition="
+        4.  <elseif condition="
                 <instruction/> is not empty
             ">
             Only output the following <template/>:
@@ -155,9 +155,9 @@ Set <content-dirty>true</content-dirty>.
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **task inherited**
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ⇌ instruction: **<instruction/>**, ▶ status: **instruction given**
             </template>
-            </if>
+            </elseif>
 
-        5.  else <if condition="
+        5.  <elseif condition="
                 <instruction/> is empty
             ">
             Only output the following <template/>:
@@ -165,14 +165,26 @@ Set <content-dirty>true</content-dirty>.
             <template>
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **task inherited**
             </template>
-            </if>
+            </elseif>
 
 2.  **Determine Plan:**
 
-    1.  Call the `ase_task_load(id: "<ase-task-id/>")` tool of the `ase` MCP
-        server to load any existing plan content and set <text/> to
-        the `text` output field of this `ase_task_load` tool call.
-        Do not output anything related to this MCP tool call.
+    1.  Determine any existing plan content:
+
+        <if condition="<getopt-option-int-reuse-task/> is equal `true`">
+            Set <text/> to the `text` argument of the most recent
+            `ase_task_save(id: '<ase-task-id/>', ...)` tool call,
+            *without* calling `ase_task_load` again. Set <status>plan
+            reused</status>. Do not output anything.
+        </if>
+        <else>
+            Call the `ase_task_load(id: "<ase-task-id/>")` tool of the
+            `ase` MCP server to load any existing plan content and set
+            <text/> to the `text` output field of this `ase_task_load`
+            tool call. Do not output anything related to this MCP tool
+            call. Set <status>plan loaded</status>.
+        </else>
+
         Set <content-dirty>false</content-dirty>.
 
         -   If <text/> starts with `ERROR:`:
@@ -187,7 +199,7 @@ Set <content-dirty>true</content-dirty>.
             Only output the following <template/>:
 
             <template>
-            ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan loaded**
+            ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **<status/>**
             </template>
 
     2.  <if condition="<content/> is empty AND <instruction/> is empty">
@@ -271,7 +283,7 @@ Set <content-dirty>true</content-dirty>.
             </template>
         </if>
 
-    4.  <if condition="<content/> does not contain '# ✪ TASK' AND <instruction/> is empty">
+    4.  <if condition="<content/> does not contain '#   TASK' AND <instruction/> is empty">
         Set <instruction><content/></instruction> (set instruction to content).
         Set <content></content> (set content to empty).
         Set <content-dirty>true</content-dirty>.
@@ -296,12 +308,12 @@ Set <content-dirty>true</content-dirty>.
     `PREFLIGHT`, or declines/cancels in the dialog of step 3.4:
 
     1.  *Update timestamp*:
-        <if condition="<content/> contains '✎ modified:' AND <content-dirty/> is 'true'">
+        <if condition="<content/> contains '⚙   Modified:' AND <content-dirty/> is 'true'">
         Update <timestamp-modified/> with the current time in
         ISO-style format, which has to be determined by calling the
         `ase_timestamp(format: "yyyy-LL-dd HH:mm")` tool of the `ase`
         MCP server and use the `text` field of its response. Update
-        <content/> with the new `✎ modified: **<timestamp-modified/>**`.
+        <content/> with the new `Modified: <timestamp-modified/>`.
         Do not output anything.
         </if>
 
@@ -350,8 +362,8 @@ Set <content-dirty>true</content-dirty>.
                 Set <instruction></instruction> (clear the instruction, as
                 any instruction carried in via the arguments was already
                 applied to the plan in step 2 before this loop), so that a
-                pre-selected `REFINE` correctly asks the user for a *fresh*
-                refinement instruction below.
+                later `OTHER: <text/>` refinement correctly starts from a
+                *fresh* refinement instruction below.
 
             -   else:
                 Only output the following <template/> and then immediately
@@ -385,13 +397,16 @@ Set <content-dirty>true</content-dirty>.
 
         -   If <result/> is `GRILL`:
 
-            *Break* out of the *loop*. Set <args></args> (empty).
+            *Break* out of the *loop*.
+            Set <args></args> (set args to empty).
+            <if condition="the plan was saved via `ase_task_save` in step 3.2">
+                Set <args>--int-reuse-task</args>.
+            </if>
             <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
+                Set <args><args/> --next <getopt-option-next/></args>
             </if>
             Only output the following <template/> and then call the
-            `Skill(skill: "ase:ase-task-grill", args: <args/>)` tool
+            `Skill(skill: "ase:ase-task-grill", args: "<args/>")` tool
             to *grill* the finalized plan.
 
             <template>
@@ -400,13 +415,16 @@ Set <content-dirty>true</content-dirty>.
 
         -   If <result/> is `PREFLIGHT`:
 
-            *Break* out of the *loop*. Set <args></args> (empty).
+            *Break* out of the *loop*.
+            Set <args></args> (set args to empty).
+            <if condition="the plan was saved via `ase_task_save` in step 3.2">
+                Set <args>--int-reuse-task</args>.
+            </if>
             <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
+                Set <args><args/> --next <getopt-option-next/></args>
             </if>
             Only output the following <template/> and then call the
-            `Skill(skill: "ase:ase-task-preflight", args: <args/>)` tool
+            `Skill(skill: "ase:ase-task-preflight", args: "<args/>")` tool
             to *apply* the finalized plan.
 
             <template>
@@ -415,13 +433,16 @@ Set <content-dirty>true</content-dirty>.
 
         -   If <result/> is `IMPLEMENT`:
 
-            *Break* out of the *loop*. Set <args></args> (empty).
+            *Break* out of the *loop*.
+            Set <args></args> (set args to empty).
+            <if condition="the plan was saved via `ase_task_save` in step 3.2">
+                Set <args>--int-reuse-task</args>.
+            </if>
             <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
+                Set <args><args/> --next <getopt-option-next/></args>
             </if>
             Only output the following <template/> and then call the
-            `Skill(skill: "ase:ase-task-implement", args: <args/>)` tool
+            `Skill(skill: "ase:ase-task-implement", args: "<args/>")` tool
             to *apply* the finalized plan.
 
             <template>

package/plugin/skills/ase-task-edit/help.md

@@ -48,8 +48,8 @@ hand-off to implementation or preflight.
     `none` (default, interactive answer required), `DONE` (no next
     step), `GRILL` (hand-over to `ase-task-grill`), `PREFLIGHT`
     (hand-over to `ase-task-preflight`), or `IMPLEMENT` (hand-over to
-    `ase-task-implement`). Example: `--next GRILL,DONE` first refines
-    once, then exits the loop without asking.
+    `ase-task-implement`). Example: `--next GRILL,DONE` hands the plan
+    off to grilling and forwards `DONE` so grilling exits without asking.
 
 ##  ARGUMENTS
 

package/plugin/skills/ase-task-grill/SKILL.md

@@ -22,7 +22,7 @@ Iteratively Grill a Task Plan
 
 <expand name="getopt"
     arg1="ase-task-grill"
-    arg2="--next|-n=(none|DONE|EDIT)...">
+    arg2="--next|-n=(none|DONE|EDIT|IMPLEMENT|PREFLIGHT)... --int-reuse-task">
     $ARGUMENTS
 </expand>
 
@@ -36,9 +36,15 @@ task plan until reaching a shared understanding.
 Procedure
 ---------
 
+You *MUST* follow the following numbered items *strictly* *sequentially*!
+You *MUST* not skip any numbered item during processing!
+
+You *MUST* *NOT* output anything in this entire procedure, *except* when
+explicitly requested by this procedure via outputs based on a <template/>!
+
 1.  **Determine Task:**
 
-    1.  Set <id>$ARGUMENTS</id> initially.
+    1.  Set <id><getopt-arguments/></id> initially.
         Inherit the always existing <ase-task-id/> from the current context.
         Inherit the always existing <ase-session-id/> from the current context.
         Do not output anything.
@@ -59,22 +65,34 @@ Procedure
             </template>
             </if>
 
-        2.  else <if condition="<id/> is NOT empty">
+        2.  <elseif condition="<id/> is NOT empty">
             The argument is neither empty nor a valid task id. As this
             skill only accepts an optional `[<id>]` argument and *never*
             a free-text instruction, only output the following <template/>
             and then immediately *STOP* processing the entire current skill:
 
             <template>
-            ⧉ **ASE**: ☻ skill: **ase-task-grill**, ▶ **ERROR**: expected single `[<id>]` argument
+            ⧉ **ASE**: ☻ skill: **ase-task-grill**, ▶ ERROR: expected single `[<id>]` argument
             </template>
-            </if>
+            </elseif>
 
 2.  **Determine Task Plan:**
 
-    1.  Call the `ase_task_load(id: "<ase-task-id/>")` tool of the `ase` MCP
-        server to load the current task plan content and set <text/> to
-        the `text` output field of the `ase_task_load` tool call.
+    1.  Determine the current task plan content:
+
+        <if condition="<getopt-option-int-reuse-task/> is equal `true`">
+            Set <text/> to the `text` argument of the most recent
+            `ase_task_save(id: '<ase-task-id/>', ...)` tool call,
+            *without* calling `ase_task_load` again. Set <status>plan
+            reused</status>. Do not output anything.
+        </if>
+        <else>
+            Call the `ase_task_load(id: "<ase-task-id/>")` tool of the
+            `ase` MCP server to load the current task plan content and
+            set <text/> to the `text` output field of this `ase_task_load`
+            tool call. Do not output anything related to this MCP tool
+            call. Set <status>plan loaded</status>.
+        </else>
 
         -   If <text/> starts with `ERROR:` or `WARNING:`:
             Output the following <template/> and then immediately *STOP*
@@ -91,7 +109,7 @@ Procedure
         Output the following <template/>:
 
         <template>
-        ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan loaded**
+        ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **<status/>**
         </template>
 
     2.  <if condition="<plan/> is empty">
@@ -107,7 +125,7 @@ Procedure
     *essential aspect* of the task plan in <plan/> *until* reaching a
     shared understanding and no decisions/questions are left open.
 
-    This especially means, you *MUST* clarify as much aspects as
+    This especially means, you *MUST* clarify as many aspects as
     necessary to ensure that for at least the most important decisions,
     during a subsequent implementation, no essential freedom of choices
     exist any longer.
@@ -143,7 +161,7 @@ Procedure
     decisions one-by-one. Ask the questions <question-N/> and determine
     corresponding answer <answer-N/>, one at a time.
 
-    1.  For each question <question-N/> in the iteration circle <N/>:
+    1.  For each question <question-N/> in the iteration cycle <N/>:
 
         1.  Output the following <template/>:
 
@@ -172,7 +190,12 @@ Procedure
                 <ase-tpl-bullet-normal/> ASPECT <N/>/<n/>: **<aspect-N/>**, ANSWER: **<answer-N/>**
                 </template>
 
-    3.  Finally, update the plan in <plan/> based on all answers <answer-N/>.
+    2.  Finally, update the plan in <plan/> based on all answers <answer-N/>.
+
+    3.  <if condition="<plan/> contains 'Created:  <text/>'">
+        Set <timestamp-created><text/></timestamp-created> (set
+        timestamp-created to extracted text)
+        </if>
 
     4.  Call the `ase_timestamp(format: "yyyy-LL-dd HH:mm")` tool of the
         `ase` MCP server and use the `text` field of its response for
@@ -237,13 +260,12 @@ Procedure
             </template>
 
         -   If <result/> is `EDIT`:
-            Set <args></args> (empty).
+            Set <args>--int-reuse-task</args>.
             <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
+                Set <args><args/> --next <getopt-option-next/></args>
             </if>
             Only output the following <template/> and then call the
-            tool `Skill(skill: "ase:ase-task-edit", args: <args/>)`
+            tool `Skill(skill: "ase:ase-task-edit", args: "<args/>")`
             to invoke the `ase:ase-task-edit` skill in order to *edit*
             the updated plan. Immediately stop processing the current
             skill once the `Skill` tool was used.
@@ -253,13 +275,12 @@ Procedure
             </template>
 
         -   If <result/> is `PREFLIGHT`:
-            Set <args></args> (empty).
+            Set <args>--int-reuse-task</args>.
             <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
+                Set <args><args/> --next <getopt-option-next/></args>
             </if>
             Only output the following <template/> and then call the
-            `Skill(skill: "ase:ase-task-preflight", args: <args/>)` tool
+            `Skill(skill: "ase:ase-task-preflight", args: "<args/>")` tool
             to *apply* the plan.
 
             <template>
@@ -267,15 +288,23 @@ Procedure
             </template>
 
         -   If <result/> is `IMPLEMENT`:
-            Set <args></args> (empty).
+            Set <args>--int-reuse-task</args>.
             <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
+                Set <args><args/> --next <getopt-option-next/></args>
             </if>
             Only output the following <template/> and then call the
-            `Skill(skill: "ase:ase-task-implement", args: <args/>)` tool
+            `Skill(skill: "ase:ase-task-implement", args: "<args/>")` tool
             to *apply* the plan.
 
             <template>
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan updated -- hand-off to implementation**
             </template>
+
+        -   If <result/> matches `OTHER: <text/>` or is any other
+            unrecognized value:
+            Treat it as `DONE` (the updated plan is already saved):
+            only output the following <template/> and then *STOP*.
+
+            <template>
+            ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan updated -- done**
+            </template>

package/plugin/skills/ase-task-id/SKILL.md

@@ -24,7 +24,16 @@ Configure Task Id
 1.  Determine request:
     <request>$ARGUMENTS</request>
 
-2.  <if condition="<request/> is empty">
+2.  <if condition="<request/> is NOT empty AND <request/> does NOT match the regexp `^[a-zA-Z][a-zA-Z0-9_-]*$`">
+    Only output the following <template/> and then immediately
+    *STOP* processing the entire current skill:
+
+    <template>
+    ⧉ **ASE**: ☻ skill: **ase-task-id**, ▶ ERROR: given task id `<request/>` is not a valid id
+    </template>
+    </if>
+
+3.  <if condition="<request/> is empty">
     -   Call the `ase_task_id(session: "<ase-session-id/>")`
         tool from the `ase` MCP server and set
         <ase-task-id/> to its `text` output.
@@ -35,7 +44,7 @@ Configure Task Id
         </template>
     </if>
 
-3.  <if condition="<request/> is NOT empty">
+4.  <if condition="<request/> is NOT empty">
     -   Set <ase-task-id><request/></ase-task-id> and
         call the `ase_task_id(id: "<ase-task-id/>", session: "<ase-session-id/>")`
         tool from the `ase` MCP server.

package/plugin/skills/ase-task-implement/SKILL.md

@@ -21,7 +21,7 @@ Implement a Task Plan
 
 <expand name="getopt"
     arg1="ase-task-implement"
-    arg2="--next|-n=(none|DONE|DELETE)...">
+    arg2="--next|-n=(none|DONE|DELETE)... --int-reuse-task">
     $ARGUMENTS
 </expand>
 
@@ -65,7 +65,7 @@ explicitly requested by this procedure via outputs based on a <template/>!
             </template>
             </if>
 
-        2.  else <if condition="
+        2.  <elseif condition="
                 <instruction/> has the format `<id/>: <text/>` where
                 <id/> matches the regexp `^[a-zA-Z][a-zA-Z0-9_-]*$` and
                 <text/> is *empty*
@@ -80,9 +80,9 @@ explicitly requested by this procedure via outputs based on a <template/>!
             <template>
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ status: **task given**
             </template>
-            </if>
+            </elseif>
 
-        3.  else <if condition="<instruction/> is NOT empty">
+        3.  <elseif condition="<instruction/> is NOT empty">
             The argument is neither empty nor a valid task id. As this
             skill only accepts an optional `[<id>]` argument and *never*
             a free-text instruction, only output the following <template/>
@@ -91,13 +91,25 @@ explicitly requested by this procedure via outputs based on a <template/>!
             <template>
             ⧉ **ASE**: ☻ skill: **ase-task-implement**, ▶ ERROR: expected single `[<id>]` argument
             </template>
-            </if>
+            </elseif>
 
 2.  **Determine Operation**:
 
-    1.  Call the `ase_task_load(id: "<ase-task-id/>")` tool of the `ase` MCP
-        server to load the current task plan content and set <text/> to
-        the `text` output field of the `ase_task_load` tool call.
+    1.  Determine the current task plan content:
+
+        <if condition="<getopt-option-int-reuse-task/> is equal `true`">
+            Set <text/> to the `text` argument of the most recent
+            `ase_task_save(id: '<ase-task-id/>', ...)` tool call,
+            *without* calling `ase_task_load` again. Set <status>plan
+            reused</status>. Do not output anything.
+        </if>
+        <else>
+            Call the `ase_task_load(id: "<ase-task-id/>")` tool of the
+            `ase` MCP server to load the current task plan content and
+            set <text/> to the `text` output field of this `ase_task_load`
+            tool call. Do not output anything related to this MCP tool
+            call. Set <status>plan loaded</status>.
+        </else>
 
         -   If <text/> starts with `ERROR:` or `WARNING:`:
             Set <content></content> (set content to empty).
@@ -110,12 +122,13 @@ explicitly requested by this procedure via outputs based on a <template/>!
         Only output the following <template/>:
 
         <template>
-        ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan loaded**
+        ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **<status/>**
         </template>
 
     2.  If the <content/> is still empty, complain and tell the user to
         use the `ase-code-resolve`, `ase-code-refactor`, `ase-code-craft`,
-        or `ase-task-edit` skills first to create a task plan.
+        or `ase-task-edit` skills first to create a task plan. Then
+        immediately stop processing this skill.
 
 3.  **Create Implementation:**
 
@@ -189,11 +202,10 @@ explicitly requested by this procedure via outputs based on a <template/>!
             </template>
 
         -   If <result/> is `DELETE`:
-            Set <args></args> (empty).
-            <if condition="<getopt-option-next/> is not equal `none`">
-            Set <args>--next <getopt-option-next/></args> (forward
-            remaining list tokens to the downstream skill).
-            </if>
+            Set <args></args> (empty). Do *not* forward any remaining
+            `--next` list tokens, because the `ase:ase-task-delete`
+            skill accepts only an optional `[<id>]` argument and no
+            `--next` option; remaining tokens are intentionally discarded.
             Only output the following <template/> and then call the
             tool `Skill(skill: "ase:ase-task-delete", args: <args/>)`
             to invoke the `ase:ase-task-delete` skill in order to
@@ -204,3 +216,12 @@ explicitly requested by this procedure via outputs based on a <template/>!
             ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan implemented -- hand-off to delete task**
             </template>
 
+        -   If <result/> matches `OTHER: <text/>` or is any other
+            unrecognized value:
+            Treat it as `DONE` (the plan is already implemented):
+            only output the following <template/> and then *STOP*.
+
+            <template>
+            ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ✪ plan: **<words/>** words, ▶ status: **plan implemented -- done**
+            </template>
+

package/plugin/skills/ase-task-list/SKILL.md

@@ -27,7 +27,7 @@ List Task Plans
 *List* all available *task plans* of the current project.
 </objective>
 
-1.  Call the `ase_task_list(verbose: "<getopt-option-verbose/>")` tool from
+1.  Call the `ase_task_list(verbose: <getopt-option-verbose/>)` tool from
     the `ase` MCP server. The result is a structured object with a
     `tasks` array where each entry has an `id` field, and -- if
     <getopt-option-verbose/> is `true` -- additionally an `mtime` field