bkper 5.7.3 → 5.8.1

package/README.md

@@ -215,6 +215,31 @@ Run `/reload` in an open session after adding or removing a server, and use `/mc
 
 MCP tools run with your permissions. Add only servers you trust.
 
+### Your agent context
+
+Your procedures and skills (an `AGENTS.md` and `.agents/skills/<name>/SKILL.md`) can be shared by all your agents: the Bkper CLI Agent, Bkper Agent on the web, and any agent that reads those standards. They live in a Git clone at `~/.bkper/user`, which the agent loads at every start and `/reload`, and updates in the background.
+
+```bash
+bkper context pull   # clone or update ~/.bkper/user now
+```
+
+To publish a change, commit and `git push` from that folder; it reaches all your agents. Unpushed changes are never overwritten. Never put Book data in it.
+
+### Your company's agent context
+
+If your Bkper account belongs to a company domain, the company can share procedures and skills with everyone in it: report layout, naming conventions, approval habits. `bkper context pull` also keeps them in `~/.bkper/domain`, and the agent loads them before yours: your `AGENTS.md` comes after the company's, and your skills win over the company's of the same name. Everyone in the domain reads it; only the domain's admin publishes, with a commit and `git push` from that folder. Accounts without a company domain have none.
+
+### A Book's agent context
+
+A Book can have its own procedures and skills, shared by everyone who can view it: the meaning of its accounts, its month-end close, its import quirks. Start the agent on a Book to load them beside yours:
+
+```bash
+bkper agent -b <bookId>              # loads it; pulled in the background, newer pushes load at /reload
+bkper context pull -b <bookId>       # pull yours (and your company's) and the Book's now, into ~/.bkper/books/<bookId>
+```
+
+The Book's `AGENTS.md` comes after yours, and its skills win over yours of the same name. Editors of the Book publish with a commit and `git push` from its folder, which reaches everyone who can view it. Unpushed changes are never overwritten. Never put Book data in it.
+
 ---
 
 ## Data Management