Coding Agents

Start

Run aw doctor from the meta-repository.
Read the root and child AGENTS.md files.
Work in the child repository that owns the change.
Validate every affected repository.
Use aw handoff when pausing or transferring work.

Install the skill

npx skills add https://github.com/corwinm/arashi-skills --skill arashi

The optional skill gives supported agents reusable Arashi guidance. You can also view it on skills.sh.

Keep ownership clear

Code, tests, and project docs belong in the affected child repository.
Shared plans and cross-repository coordination belong in the meta-repository.
Each repository gets its own commit and pull request.

A planning framework is optional. Repository ownership is the important contract.

Recommended `AGENTS.md`

Add a root AGENTS.md so agents know where work belongs:

# Workspace Agent Rules

This meta-repository coordinates child repositories in `repos/`.

## Core Rules

- Put implementation, tests, and project docs in `repos/<project>/`.
- Keep shared plans and cross-repository context in the meta-repository.
- Read the child repository's `AGENTS.md` before editing it.

## Multi-Repository Work

- A single Git commit cannot span multiple repositories.
- Validate each affected repository.
- Open separate, cross-linked pull requests.

## Child Instructions

- `repos/<project>/AGENTS.md`

Add smaller AGENTS.md files inside child repositories for their validation commands and editing rules.

Target the task

aw create docs/update-reference --only arashi-docs --no-launch --no-switch
aw status --only arashi-docs
aw exec --only arashi-docs -- pnpm validate

Use --only or --group for expensive or mutating work unless the task needs every repository.

Start a new T3 task in the feature workspace

Create a coordinated workspace and start a separate T3 thread in its parent checkout:

aw create feature/t3-handoff --t3 --prompt-file task.md

Write a self-contained task with the objective, accepted decisions, relevant context, and completion expectations. Your original conversation stays in its current workspace. See T3 Code for setup, model defaults, permissions, and recovery.

Hand off

aw handoff \
  --link https://github.com/example/project/pull/42 \
  --validation "pnpm validate — passed" \
  --todo "watch CI"

Only report checks that ran. Put pending work under --todo or --risk.