# Arashi

> Arashi is a Git worktree manager for meta-repositories. It keeps related repositories aligned while agents and humans work on a feature branch across a shared workspace.

## Agent Guidance

- Start by inspecting workspace state with `arashi status`.
- Use the meta-repo for shared context, OpenSpec proposals, planning, and cross-repo coordination.
- Put implementation, tests, and repo-specific docs in the owning child repository under `repos/<project>/`.
- Prefer machine-readable command output such as `arashi status --json` when automating decisions.
- Use `arashi exec --json -- <command>` for repeated multi-repo inspection or validation commands, with explicit `--only` filters for mutating or expensive commands.
- Validate every affected repository before handing work back for review.
- Use focused PRs and cross-link related PRs when work spans multiple repositories.

## Core Docs

- [Agents workflow](https://arashi.haphazard.dev/workflows/agents-and-specs/) - bootstrap guidance for coding agents in Arashi meta-repos.
- [JSON automation](https://arashi.haphazard.dev/workflows/json-automation/) - machine-readable output contract, examples, and command support matrix.
- [Getting started](https://arashi.haphazard.dev/getting-started/) - install and first-workspace flow.
- [Commands](https://arashi.haphazard.dev/commands/) - command reference.
- [Contributing](https://arashi.haphazard.dev/contributing/) - contribution flow for Arashi projects.
- [Full Markdown export](https://arashi.haphazard.dev/llms-full.txt) - consolidated public docs context.

## Useful Markdown Routes

- [Agents workflow Markdown](https://arashi.haphazard.dev/workflows/agents-and-specs.md)
- [JSON automation Markdown](https://arashi.haphazard.dev/workflows/json-automation.md)
- [Getting started Markdown](https://arashi.haphazard.dev/getting-started.md)
- [Status command Markdown](https://arashi.haphazard.dev/commands/status.md)
- [Create command Markdown](https://arashi.haphazard.dev/commands/create.md)
- [Exec command Markdown](https://arashi.haphazard.dev/commands/exec.md)
- [Contributing Markdown](https://arashi.haphazard.dev/contributing.md)

## Optional

- [Configuration workflow](https://arashi.haphazard.dev/workflows/config/)
- [Hooks workflow](https://arashi.haphazard.dev/workflows/hooks/)
- [VS Code workflow](https://arashi.haphazard.dev/workflows/vscode/)
- [tmux and sesh workflow](https://arashi.haphazard.dev/workflows/tmux-and-sesh/)