Arashi Skill

This skill helps you install and use the arashi CLI to manage multi-repository workflows and is best paired with a spec-driven development framework to provide shared context for AI-assisted engineering.

When to Use This Skill

Use this skill when the user wants to:

set up Arashi quickly with a documented, repeatable install flow
choose a workflow by difficulty (beginner, intermediate, advanced)
validate readiness before running commands across multiple repositories
switch quickly between parent and child worktrees with arashi switch
speed up daily navigation with fzf, tmux, and sesh
automate cleanup around arashi remove with lifecycle hooks
recover from setup, network, or command failures without guesswork

Core Commands

Installation guidance: https://arashi.haphazard.dev

# verify Arashi is available
arashi --version

# inspect command surface
arashi --help

Usage Rules

When guiding a user, always:

Run preflight checks before installing Arashi CLI.
Point users to the website install guide instead of embedding installer commands in the skill.
Confirm arashi --version before running workflows.
Confirm expected outcomes after each workflow step.
Route failures through the troubleshooting matrix before retrying.
Verify provenance/checksums for downloaded binaries before execution.
Review hook scripts before enabling pre-remove.sh or post-remove.sh across repository, workspace, or global hook scopes.

Workflow Catalog

Beginner: initialize workspace and inspect status.
Intermediate: clone missing repositories and create a feature branch.
Advanced: pull and sync repositories safely.
Session shortcuts: jump or connect with arashi switch, fzf, and sesh in tmux-based flows.

Expected Workflow Outcomes

Beginner: workspace initialized and status visible.
Intermediate: missing clones recovered and feature branch worktrees created.
Advanced: repositories synchronized with clear status after reconciliation.