docs: generalize agent guidance

Author: ma2za

.gitignore

@@ -111,8 +111,7 @@ env.bak/
 venv.bak/
 
 # Private maintainer configuration
-removed-provider.md
-docs/removed-provider-removed-provider.md
+.agents/
 tmp_pytest/
 
 # Spyder project settings

AGENTS.md

@@ -1,17 +1,14 @@
 # Shared agent instructions
 
-`removed-provider.md` is the authoritative project memory for every agent working in
-this repository. Read it completely before inspecting, changing, or running
-the project, and follow it for the entire task.
+This file is the public source of guidance for any coding agent working in
+this repository. Read it before inspecting, changing, or running the project.
 
-Repository workflows and policies under `.removed-provider/` are shared agent settings,
-not removed-provider-only guidance. Read the relevant files before performing the
-corresponding operation. If an agent does not support the removed-provider slash-command
-syntax, follow the command prompt manually:
+Private local maintainer guidance and optional workflows may live under
+`.agents/`. Read the relevant files when they are available:
 
-- `.removed-provider/commands/release/prepare.toml` defines release preparation.
-- `.removed-provider/commands/release/verify.toml` defines release verification.
-- `.removed-provider/policies/git-override.toml` records repository Git tool policy.
+- `.agents/commands/release/prepare.toml` defines release preparation.
+- `.agents/commands/release/verify.toml` defines release verification.
+- `.agents/policies/git-override.toml` records repository Git tool policy.
 
 Tool policies never override the user's request, the host's permissions, or
 higher-priority safety instructions.

CHANGELOG.md

@@ -71,7 +71,7 @@
 - Seven new MCP tools for read operations and safe publishing: `get_status`, `list_publications`, `list_drafts`, `get_draft`, `schedule_draft`, `unschedule_draft`, and `publish_draft_checked`.
 - Pre-publish validation, interactive confirmation requirements, and no-email defaults for the new `publish_draft_checked` MCP tool.
 - Verified MCP client configuration examples in `docs/mcp.md`.
-- Documentation for removed-provider CLI with removed-provider (`docs/removed-provider-removed-provider.md`).
+- Documentation for local agent workflows.
 
 ### Improved
 

README.md

@@ -251,6 +251,7 @@ See [MCP server](docs/mcp.md) for the tool list and safety notes.
 - [Low-level Python API](docs/low-level-api.md)
 - [YAML drafts](docs/yaml.md)
 - [MCP server](docs/mcp.md)
+- [Agent workflow](docs/agents.md)
 - [Safety and publishing behavior](docs/safety.md)
 - [Troubleshooting](docs/troubleshooting.md)
 - [Compatibility policy](docs/compatibility.md)

docs/agents.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: Agent workflow
+---
+
+# Agent workflow
+
+This repository can be maintained with any compatible coding agent. Read
+[`AGENTS.md`](../AGENTS.md) before inspecting or changing the project.
+
+Private maintainer configuration is optional and lives under `.agents/`; it is
+not distributed with the package. Do not commit credentials, cookies, tokens,
+or local service-account files.
+
+Use the documented Poetry commands for dependency installation, offline tests,
+and release validation. Live tests require explicit maintainer authorization
+and must never publish content.

docs/index.md

@@ -20,6 +20,7 @@ publish, or delete it.
 - [Python SDK](python-sdk.md)
 - [Markdown syntax](markdown.md)
 - [MCP setup](mcp.md)
+- [Agent workflow](agents.md)
 - [Safety and publishing behavior](safety.md)
 - [Troubleshooting](troubleshooting.md)
 

docs/releases/0.4.0.md

@@ -13,7 +13,7 @@ This release makes the optional MCP server significantly more useful for inspect
 - Seven new MCP tools for read operations and safe publishing: `get_status`, `list_publications`, `list_drafts`, `get_draft`, `schedule_draft`, `unschedule_draft`, and `publish_draft_checked`.
 - Pre-publish validation, interactive confirmation requirements, and no-email defaults for the new `publish_draft_checked` MCP tool.
 - Verified MCP client configuration examples in `docs/mcp.md`.
-- Documentation for removed-provider CLI with removed-provider (`docs/removed-provider-removed-provider.md`).
+- Documentation for local agent workflows.
 
 ### Improved