Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs: add alias suggestion guidance to triage workflow (#1728)

worktrunk-bot5d558d54126b
diff --git a/.claude/skills/running-tend/SKILL.md b/.claude/skills/running-tend/SKILL.md
index 7e3db57e9..61c1df7fa 100644
--- a/.claude/skills/running-tend/SKILL.md
+++ b/.claude/skills/running-tend/SKILL.md
@@ -60,6 +60,41 @@ If surrounding lines also need updating, note that in your reply.
When a bug may already be fixed, ask the reporter: `wt --version`
+### Feature requests addressable with aliases
+
+When triaging a feature request, check whether the requested behavior can be
+composed from existing commands using a `wt step` alias or a shell
+function/alias. Worktrunk intentionally keeps its flag surface small — aliases
+let users test workflows before features are added natively.
+
+If the feature can be addressed with an alias:
+
+1. **Draft the alias** — Write a `wt step` alias (in `[aliases]` config) or
+ shell function that achieves the requested behavior.
+2. **Test it** — Set up a temporary repo, configure the alias, and verify it
+ works for both the happy path and edge cases (e.g., branch exists vs.
+ doesn't exist).
+3. **Post the alias in your comment** — Include both the config snippet and
+ usage example. Link to the [aliases documentation](https://worktrunk.dev/step/#aliases)
+ so the user can learn more.
+4. **Mention the shell alternative** — A shell function is often more ergonomic
+ for commands that need positional arguments (aliases use `--var name=value`).
+
+Example comment structure:
+
+> This can be done today with a `wt step` alias. Add to `~/.config/worktrunk/config.toml`:
+>
+> ```toml
+> [aliases]
+> sw = "wt switch -c {{ name }} 2>/dev/null || wt switch {{ name }}"
+> ```
+>
+> Then: `wt step sw --var name=my-branch`
+>
+> Or as a shell function: `wts() { wt switch -c "$1" 2>/dev/null || wt switch "$1"; }`
+>
+> See [Aliases](https://worktrunk.dev/step/#aliases) for more details.
+
## Per-Workflow References
- **PR review**: `@references/review-pr.md` — Rust idioms, documentation accuracy, duplication search