AGENTS.md@skills/servosity ยท diff
git:20260526.4932a85 to git:20260606.f01c33b
7 added, 9 removed. Audit A to A.
- # Servosity Skill Agent Guide
+ # Servosity Printed CLI Agent Guide
- This directory ships a `servosity-cli` binary and an MCP server (`servosity-mcp`) for use by Claude Code, Codex, Claude Desktop, and ChatGPT Desktop. This file gives the agent invariant local guidance; the longer command reference is in `guide.md`.
+ This directory is a generated `servosity-cli` printed CLI. It was produced by [CLI Printing Press](https://github.com/mvanhorn/cli-printing-press), so treat systemic fixes as upstream Printing Press fixes first. Keep local edits narrow and document why a generated-tree patch belongs here.
## Local Operating Contract
- Start by asking the CLI for current runtime truth:
+ Start by asking the generated CLI for current runtime truth:
```bash
servosity-cli doctor --json
servosity-cli agent-context --pretty
```
Use runtime discovery instead of relying on a copied command list:
```bash
servosity-cli which "<capability>" --json
servosity-cli <command> --help
```
Add `--agent` to command invocations for JSON, compact output, non-interactive defaults, no color, and confirmation-safe scripting:
```bash
servosity-cli <command> --agent
```
Before running an unfamiliar command that may mutate remote state, inspect its help and prefer a dry run:
```bash
servosity-cli <command> --help
servosity-cli <command> --dry-run --agent
```
Use `--yes --no-input` only after the target, arguments, and side effects are clear.
- For install, auth, examples, and longer product guidance, read `README.md` for the short path and `guide.md` for the full command reference. `SKILL.md` is the Claude Code skill entry point; if you are Claude Code or Codex, that is the file you load on `use servosity` or `run servosity` trigger phrases.
-
- ## Trademark note
+ For install, auth, examples, and longer product guidance, read `README.md` and `SKILL.md`. This file intentionally stays small so repo-local agents get invariant local guidance without duplicating the generated docs.
- Servosity is a trademark of Servosity Inc. This skill is published by Servosity Inc. itself (not an unofficial wrapper), so unlike third-party-vendor skills in this repository it does NOT carry an external non-affiliation banner. The Apache-2.0 license and DCO sign-off requirements still apply per the repo root.
+ ## Local Customizations
- ## Upstream toolchain
+ This directory is **generated output** -- a fresh print can overwrite the whole tree, so ad-hoc hand-edits don't survive on their own. If you modify the generated code, record each change under `.printing-press-patches/` (parallel to `.printing-press.json`) so a regen carries the intent forward instead of silently dropping it.
- The CLI and MCP binaries in this skill are generated by the [CLI Printing Press](https://github.com/mvanhorn/cli-printing-press) toolchain. When you encounter a systemic issue (poor command shape, wrong tool description across many tools, generator-side bug), file it upstream rather than patching it here. `msp-skills` is the distribution surface, not the build factory.
+ The entry shape, and the altitude to write it at -- a durable reprint-guard, not a changelog -- live in the source catalog's `AGENTS.md`, which is the single source of truth; this guide intentionally doesn't duplicate them.