Repository Layout

A minimal AYNIG repository typically includes:

.aynig/
  command/
    <state>
  roles/
    <role>/
      command/
        <state>
  COMMANDS.md   # optional, documents available states
.worktrees/     # ephemeral; created/cleaned by AYNIG

The dwp-state trailer selects which command runs. When ROLE (or --role) is set, AYNIG checks .aynig/roles/<role>/command/<state> first.

.worktrees/

AYNIG runs each command inside a dedicated Git worktree. Worktrees are created under this directory and reused across runs when possible. This directory is ignored via .gitignore.

.aynig/logs/

Command stdout/stderr logs are written here as <commit-hash>.stdout.log and <commit-hash>.stderr.log. This directory is ignored via .gitignore. Keep .worktrees/ ignored. Commands should not create/manage worktrees manually.