From cc7aa85a8e8edbf4281a9a408620fc634852e809 Mon Sep 17 00:00:00 2001 From: Altay Date: Sun, 22 Nov 2026 17:24:43 +0300 Subject: [PATCH] docs: trim agent guide and docs --- .agents/skills/verify-putio-cli/SKILL.md | 4 +-- .../verify-putio-cli/features/README.md | 29 ++++--------------- .../features/account-reads.md | 16 +--------- .../verify-putio-cli/features/auth-login.md | 19 ------------ .../verify-putio-cli/features/sdk-call.md | 11 ------- .../features/transfers-watch.md | 10 ------- 6 files changed, 9 insertions(+), 80 deletions(-) diff --git a/.agents/skills/verify-putio-cli/SKILL.md b/.agents/skills/verify-putio-cli/SKILL.md index e22fcc8..425f973 100644 --- a/.agents/skills/verify-putio-cli/SKILL.md +++ b/.agents/skills/verify-putio-cli/SKILL.md @@ -48,5 +48,5 @@ Report the run id, the revision from `run.txt`, and the step directories that ca - The fixture's device poll counter lives for the whole run: the second device login in one run gets the token on its first poll. - Never press `o` during device login and never pass `--open`: both call the OS browser opener (on a loopback URL, but still a real window on the user's desktop). -- The sandbox proves CLI behavior against put.io's contract as the fixture models it, not against the live API. Say so when you report. -- tmux sessions are 120×40; terminal boxes wider than that wrap in captures. +- The sandbox proves CLI behavior against the fixture's model of put.io's contract; the live API stays unproven. Say so when you report. +- tmux sessions are 120×40; terminal boxes wider than that wrap in captures, so match on labels. diff --git a/.agents/skills/verify-putio-cli/features/README.md b/.agents/skills/verify-putio-cli/features/README.md index d19118f..1787933 100644 --- a/.agents/skills/verify-putio-cli/features/README.md +++ b/.agents/skills/verify-putio-cli/features/README.md @@ -1,30 +1,11 @@ # putio-cli verification map -The maintained source for proving user-facing behavior of the `putio` binary. Read this index, then use the matching feature file as the recipe. +Each feature file is a recipe for [SKILL.md](../SKILL.md)'s `verify.sh`: `.agents/skills/verify-putio-cli/scripts/verify.sh`, run from the repo root. Every recipe starts from a fresh run: `pnpm exec vp run build` after the last source change, `verify.sh start`, and `verify.sh doctor` printing only `ok` lines. -## Baseline preconditions - -- `pnpm exec vp run build` ran after the last source change. -- `verify.sh start` created the run and `verify.sh doctor` prints only `ok` lines. -- The scratch config is empty unless a recipe's preconditions say otherwise. -- `verify.sh` means `.agents/skills/verify-putio-cli/scripts/verify.sh`, run from the repo root. - -## Driving conventions - -- Pipes (`verify.sh cli`) are the agent path; JSON is the default there. The PTY (`verify.sh pty`) is the human path. -- Name each step after the sub-feature ID, so evidence directories map back to this file. - Commands are literal. Keep flags and quoting unchanged. - -## Proof and skip reporting - -- Pipe proof: `command.txt`, `stdout.txt`, `stderr.txt`, `exit.txt` from the step directory. -- PTY proof: `screen-