@pmelab/gtd 15.10.0 → 17.0.0

package/README.md

@@ -21,12 +21,17 @@ npm install -g @pmelab/gtd
 
 Or run without installing (prefix every `gtd` below with `npx`) — see
 [Configuration](https://github.com/pmelab/gtd/blob/main/docs/configuration.md)
-for the settings most projects tune.
+for the settings most projects tune. A process setting's value is committed to
+Git history; keep secrets in an environment setting (see
+[Settings](https://github.com/pmelab/gtd/blob/main/docs/configuration.md#settings)).
 
 Also install all three skill sources the bundled workflow names in its prompts —
 none is optional. See
 [Setup](https://github.com/pmelab/gtd/blob/main/docs/setup.md) for the list, the
-install flags, and the never-install-the-plugin caveat.
+install flags, and the never-install-the-plugin caveat. Each bundled agent step
+has its own addressable `.gtdrc` `skills:` entry — see
+[Configuration](https://github.com/pmelab/gtd/blob/main/docs/configuration.md#the-skills-key)
+to repoint one to a set your own harness has instead.
 
 > **A repository's `gtd.config.ts` is code, and gtd runs it.** A custom workflow
 > is a TypeScript module, and every gtd command that looks at workflow state —
@@ -356,8 +361,11 @@ noted in steps 2, 3, and 4 below.
    users only; model `haiku`, `--model <name>` overrides) and reuses its login.
    With no `--provider`, `gtd judge run` picks jev when `TYPESAFE_API_KEY` is
    set and non-empty and no `--model` is given, else llm — never falling back
-   across them; `--model` with `--provider fixed`/`jev` is refused. jev and llm
-   exit 1 with nothing on stdout when they cannot answer every question):
+   across them; a `.gtdrc` `judge: { provider, model }` key and the
+   `GTD_JUDGE_PROVIDER` / `GTD_JUDGE_MODEL` environment variables choose the
+   judge without editing the driver (flags win over both); `--model` with
+   `--provider fixed`/`jev` is refused. jev and llm exit 1 with nothing on
+   stdout when they cannot answer every question):
    - Every red round after the first: was the failure identical, new, or
      progress?
    - Before spending a review turn on a package: does the code already satisfy