jobs

1# agy jobs
2 
3Manage background staffer/research/review/implement jobs. State is per repository in `.agy-staff/` (git-excluded via `.git/info/exclude`). Always invoke the companion from the target repository so AGY attaches that repository as its workspace; `.agy-staff/` is companion state rather than a repository source modification, so do not relocate companion calls to `/tmp` or delete `.agy-staff/`. Only ask runs synchronously.
4 
5This file lives at `<plugin-root>/skills/jobs/SKILL.md`:
6 
7```bash
8node "<skill-dir>/../../companion/agy-companion.mjs" <command> [args]
9```
10 
11## Collect the result
12 
13Default flow: prepare the prompt → dispatch → wait for the final result → validate as needed. While a job is running, do not proactively call `observe`/`status`, read logs or inspect intermediate artifacts. Do not query progress for routine updates or create sleep/observe loops. Observe only when the user explicitly asks for progress; diagnose after receiving a failure or a result requiring intervention.
14 
151. Keep the returned job id. Run `wait <id> --timeout 10m` using the same unsandboxed context as launch (in the background when the host supports background sessions or completion delivery, or directly in the foreground when the host only provides a synchronous shell tool). Use a separate wait for each job; never wait for several jobs serially in one shell.
162. For **wait**, branch on the exit code:
17 
18| Code | Meaning | Next action |
19| --- | --- | --- |
20…