Update agent feature documentation

README.md

@@ -15,7 +15,19 @@ the Metal kernels and small native integration layers are adapted from
 - **Local coding tools.** The agent can read, search, list, write, and edit
   project files; run and monitor asynchronous shell commands; search Google;
   and visit rendered web pages. File access is confined to the project, output
-  is bounded, and risky shell or visible-browser actions require approval.
+  is bounded, risky shell or visible-browser actions require approval, and
+  tool calls are validated against the same typed schemas shown to the model.
+- **Fresh-agent Ralph loops.** For a bounded coding objective, the agent can
+  run foreground rounds in fresh model contexts while preserving workspace
+  changes between rounds. A validated structured report is the only
+  conversational handoff to the next worker; the loop stops on reported
+  completion, a blocker, failure, cancellation, or its configurable round
+  limit.
+- **Workspace instructions and reusable skills.** A global `AGENTS.md` plus
+  project and nested `AGENTS.md`/`AGENTS.local.md` files provide hierarchical
+  guidance that is reconciled as the agent enters or changes a workspace area.
+  Standard `~/.agents/skills/<name>/SKILL.md` packages are advertised by
+  metadata and loaded in full only when a task matches.
 - **Project-backed Dev Brain.** An optional managed Obsidian vault provides
   source-verified wiki pages, ranked search, and on-demand skills. Each session
   receives the verified skill names, descriptions, and paths, then loads full
@@ -93,18 +105,24 @@ make bundle
 open target/release/DS4Server.app
 ```
 
+Tagged versions are also published as Apple Silicon DMG files on the
+[repository releases page](https://git.rfc1437.de/hugo/DS4Server/releases).
+
 ## Application data
 
 ```text
 ~/Library/Application Support/de.rfc1437.ds4server/data.sqlite3
 ~/Library/Application Support/de.rfc1437.ds4server/config.yaml
+~/Library/Application Support/de.rfc1437.ds4server/AGENTS.md
 ~/Library/Application Support/de.rfc1437.ds4server/models/
 ~/Library/Application Support/de.rfc1437.ds4server/kv-cache/
 ```
 
 Deleting a project or session removes DS4Server metadata and its associated
-checkpoint; it never deletes the referenced project directory. See
-[PLAN.md](PLAN.md) for the remaining implementation work.
+checkpoint; it never deletes the referenced project directory. Standard agent
+skills live separately under `~/.agents/skills/`. See the
+[issue tracker](https://git.rfc1437.de/hugo/DS4Server/issues) for remaining
+implementation work.
 
 The adapted Metal and browser sources retain their upstream notices in
 [`native/metal/LICENSE`](native/metal/LICENSE) and