@rse/ase 0.9.51 → 0.9.53

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

@@ -0,0 +1,121 @@
+
+##  NAME
+
+`ase-code-dissect` - Dissect a Change Set
+
+##  SYNOPSIS
+
+`ase-code-dissect`
+    [`--help`|`-h`]
+    [`--max-parts`|`-m` *count*]
+    [`--staged`|`-s`]
+    [`--dry`|`-d`]
+    [`--force`|`-f`]
+    [*dissect-hint*]
+
+##  DESCRIPTION
+
+The `ase-code-dissect` skill treats the current Git change set as an
+*epic* and *dissects* it domain-wise and logically into *cohesive
+parts*. Each part is a self-contained unit of change with a single
+coherent purpose, so it can be reviewed and committed *atomically* and
+*independently* of the others.
+
+The change set is captured from the working copy (`git diff`), with
+untracked files folded in *read-only*, or -- under `--staged`/`-s` --
+from the Git index (`git diff --cached HEAD`). The dissection follows a
+strict ruleset: at least *2* and at most *count* parts are derived,
+*every* hunk is assigned to *exactly one* part, mutually dependent hunks
+are kept together, all hunks of one file normally stay in the same part,
+and nothing beyond the actual change set is invented. The cut follows
+the *semantics* of the change, not its technical structure -- a split by
+file, directory, or technical layer is usually *not* the intended one.
+If the change set carries only a single cohesive purpose, it is reported
+as *not dissectable* and nothing is created.
+
+An optional *dissect-hint* steers *how* the change set is split -- which
+changes belong together, along which axis to cut, or how many parts to
+aim at. It is especially useful after a `--dry` run showed an unintended
+dissection. The hint overrides the default grouping, but never the
+ruleset itself.
+
+The derived parts are first reported as a *dissection table* (part
+number, worktree id, scope, and rationale). Then -- unless `--dry` is
+given -- each part's patch is written to a temporary file and applied
+inside a *fresh Git WorkTree* `.ase/worktree/<project-id>-<feature-slug>`,
+whose branch carries the same name and is created from `HEAD`. If a
+`CHANGELOG.md` file exists, a matching entry summarizing that part is
+added *inside* the worktree.
+
+Every part stays *uncommitted*, a failing `git apply` is reported for
+that part while the remaining parts continue, and the *original working
+copy is never mutated*.
+
+Note that the working-copy patch (without `--staged`) is taken relative
+to the Git *index* while the worktrees are created from `HEAD`. So if
+changes are *also* staged, the affected part patches may not apply
+cleanly and are then reported as failed; stage everything and use
+`--staged` in that situation.
+
+##  OPTIONS
+
+`--max-parts`|`-m` *count*:
+    Upper bound for the number of derived parts (default: `8`). The
+    lower bound is always `2`, because fewer parts are no dissection.
+
+`--staged`|`-s`:
+    Dissect the *staged* changes (the Git index against `HEAD`) instead
+    of the working copy changes. Untracked files are then *not* folded
+    in, because they are by definition not part of the index.
+
+`--dry`|`-d`:
+    *Report only* -- print the dissection table but create *no*
+    artifacts at all, so the decision stays fully reversible. Note that
+    this meaning differs from `--dry`/`-d` in `ase-code-craft`, where it
+    instead omits the `##  VERIFICATION` section of the composed plan.
+
+`--force`|`-f`:
+    Remove and re-create already existing worktrees and branches of the
+    derived names. Without this option, the skill detects colliding
+    targets *before* writing anything, reports them, and stops with
+    status *targets exist*.
+
+##  ARGUMENTS
+
+*dissect-hint*:
+    A free-text hint telling *how* the change set should be split. If
+    omitted, the parts are derived from the change set alone.
+
+The worktree names are *not* argument-driven: they are always derived
+from the *current* project id and the per-part feature slug.
+
+##  EXAMPLES
+
+Dissect the current working copy changes:
+
+```text
+❯ /ase-code-dissect
+```
+
+Preview the dissection of the staged changes into at most four parts:
+
+```text
+❯ /ase-code-dissect --staged --dry --max-parts 4
+```
+
+Re-dissect the changes, re-creating the previously created worktrees:
+
+```text
+❯ /ase-code-dissect --force
+```
+
+Dissect the changes along an explicitly given axis:
+
+```text
+❯ /ase-code-dissect keep the plugin and tool changes in separate parts
+```
+
+##  SEE ALSO
+
+[`ase-task-dissect`](../ase-task-dissect/help.md), [`ase-meta-diff`](../ase-meta-diff/help.md), [`ase-meta-review`](../ase-meta-review/help.md),
+[`ase-meta-changelog`](../ase-meta-changelog/help.md), [`ase-meta-commit`](../ase-meta-commit/help.md).

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

@@ -15,9 +15,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-explain">
+<purpose name="ase-code-explain">
 Explain Source Code
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-code-explain">
     $ARGUMENTS

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

@@ -20,9 +20,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-insight">
+<purpose name="ase-code-insight">
 Project Insight
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-code-insight">
     $ARGUMENTS

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

@@ -14,9 +14,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-lint">
+<purpose name="ase-code-lint">
 Lint Source Code
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-code-lint"

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

@@ -17,9 +17,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-refactor">
+<purpose name="ase-code-refactor">
 Refactor Source Code
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-code-refactor"

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

@@ -17,9 +17,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-code-resolve">
+<purpose name="ase-code-resolve">
 Resolve Problem
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-code-resolve"

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

@@ -16,9 +16,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-docs-distill">
+<purpose name="ase-docs-distill">
 Distill Key Points
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-docs-distill"

package/plugin/skills/ase-docs-proofread/SKILL.md

@@ -14,9 +14,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-docs-proofread">
+<purpose name="ase-docs-proofread">
 Analyze documents for spelling, punctuation, or grammar errors
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-docs-proofread"

package/plugin/skills/ase-help-intent/SKILL.md

@@ -20,9 +20,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-help-intent">
+<purpose name="ase-help-intent">
 Match an Intent to an ASE Command
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-help-intent"

package/plugin/skills/ase-help-skill/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-help-skill">
+<purpose name="ase-help-skill">
 Show the Manual Page of an ASE Skill
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-help-skill"

package/plugin/skills/ase-help-skill/catalog.md

@@ -41,6 +41,7 @@
 ○   `ase-meta-commit`:     Git Commit Message
 ○   `ase-meta-diff`:       Summarize Diff
 ○   `ase-meta-review`:     Review Staged Changes
+○   `ase-code-dissect`:    Dissect a Change Set
 
 ⎈   **TASK MANAGEMENT**
 ○   `ase-task-id`:         Configure Task Id
@@ -49,6 +50,7 @@
 ○   `ase-task-edit`:       Iteratively Edit a Task Plan
 ○   `ase-task-grill`:      Iteratively Grill a Task Plan
 ○   `ase-task-condense`:   Condense a Task Plan
+○   `ase-task-dissect`:    Dissect a Task Plan
 ○   `ase-task-reboot`:     Reboot a Task Plan
 ○   `ase-task-preflight`:  Preflight a Task Plan
 ○   `ase-task-implement`:  Implement a Task Plan
@@ -56,6 +58,7 @@
 ○   `ase-task-delete`:     Delete a Task Plan
 
 ⎈   **OTHER SKILLS**
+○   `ase-meta-workflow`:   Generate a Workflow Skill
 ○   `ase-meta-config`:     Configuration Management
 ○   `ase-meta-compat`:     Self-Test ASE Compatibility
 

package/plugin/skills/ase-meta-brainstorm/SKILL.md

@@ -17,9 +17,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-brainstorm">
+<purpose name="ase-meta-brainstorm">
 Collaboratively Brainstorm a Topic
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-brainstorm"

package/plugin/skills/ase-meta-changelog/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-changelog">
+<purpose name="ase-meta-changelog">
 Update ChangeLog Entries
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-changelog">
     $ARGUMENTS

package/plugin/skills/ase-meta-chat/SKILL.md

@@ -16,9 +16,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-chat">
+<purpose name="ase-meta-chat">
 Query Foreign LLM for Chat
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-chat">
     $ARGUMENTS

package/plugin/skills/ase-meta-commit/SKILL.md

@@ -14,9 +14,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-commit">
+<purpose name="ase-meta-commit">
 Git Commit
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-commit">
     $ARGUMENTS

package/plugin/skills/ase-meta-config/SKILL.md

@@ -16,9 +16,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-config">
+<purpose name="ase-meta-config">
 Configuration Management
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-config"

package/plugin/skills/ase-meta-diaboli/SKILL.md

@@ -14,9 +14,9 @@ effort: xhigh
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-diaboli">
+<purpose name="ase-meta-diaboli">
 Play "Devil's Advocate"
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-diaboli"

package/plugin/skills/ase-meta-diff/SKILL.md

@@ -21,9 +21,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-diff">
+<purpose name="ase-meta-diff">
 Summarize Diff
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-diff"

package/plugin/skills/ase-meta-eli5/SKILL.md

@@ -17,9 +17,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-eli5">
+<purpose name="ase-meta-eli5">
 Explain a Topic Like I'm 5
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-eli5"

package/plugin/skills/ase-meta-evaluate/SKILL.md

@@ -15,9 +15,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-evaluate">
+<purpose name="ase-meta-evaluate">
 Evaluate Alternatives
-</skill>
+</purpose>
 
 <expand name="getopt" arg1="ase-meta-evaluate">
     $ARGUMENTS

package/plugin/skills/ase-meta-proximity/SKILL.md

@@ -20,9 +20,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-dialog.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-proximity">
+<purpose name="ase-meta-proximity">
 Determine the Conceptual Proximity of a Topic
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-proximity"

package/plugin/skills/ase-meta-quorum/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-quorum">
+<purpose name="ase-meta-quorum">
 Query Multiple AIs for Quorum Answer
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-quorum"

package/plugin/skills/ase-meta-quotes/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-quotes">
+<purpose name="ase-meta-quotes">
 Find Quotes on a Topic
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-quotes"

package/plugin/skills/ase-meta-review/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-review">
+<purpose name="ase-meta-review">
 Review Staged Changes
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-review"

package/plugin/skills/ase-meta-search/SKILL.md

@@ -19,9 +19,9 @@ allowed-tools:
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-search">
+<purpose name="ase-meta-search">
 Search the Internet/Web
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-search"

package/plugin/skills/ase-meta-steelman/SKILL.md

@@ -14,9 +14,9 @@ effort: xhigh
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-steelman">
+<purpose name="ase-meta-steelman">
 Build the "Steelman" Argument
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-steelman"

package/plugin/skills/ase-meta-why/SKILL.md

@@ -12,9 +12,9 @@ effort: high
 @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md
 @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md
 
-<skill name="ase-meta-why">
+<purpose name="ase-meta-why">
 Five-Whys Root-Cause Analysis
-</skill>
+</purpose>
 
 <expand name="getopt"
     arg1="ase-meta-why"