From d9b05d564e7b7ef76be3d80c194761412a04312a Mon Sep 17 00:00:00 2001 From: Alex Clarke Date: Fri, 3 Jul 2026 22:04:28 -0600 Subject: [PATCH] docs: updated the docs to explain the iwe MCP server --- Installation.md | 3 +++ MCP-Servers.md | 3 +++ Skills.md | 19 ++++++++++++------- 3 files changed, 18 insertions(+), 7 deletions(-) diff --git a/Installation.md b/Installation.md index aa553f5..d42970d 100644 --- a/Installation.md +++ b/Installation.md @@ -7,6 +7,9 @@ Coyote requires the following tools to be installed on your system: * [docker](https://docs.docker.com/engine/install/) * [uv](https://docs.astral.sh/uv/getting-started/installation/) * `curl -LsSf https://astral.sh/uv/install.sh | sh` +* [iwe](https://github.com/iwe-org/iwe) (`iwec`, for the built-in `iwe` MCP server that navigates large markdown knowledgebases) + * **Homebrew:** `brew tap iwe-org/iwe && brew install iwe` + * **Cargo:** `cargo install iwec` These tools are used to provide various functionalities within Coyote, such as document processing, JSON manipulation, and they are used within agents and tools. diff --git a/MCP-Servers.md b/MCP-Servers.md index 33fefa8..297126c 100644 --- a/MCP-Servers.md +++ b/MCP-Servers.md @@ -249,6 +249,9 @@ Coyote ships with a `functions/mcp.json` file that includes some useful MCP serv * [docker](https://github.com/ckreiling/mcp-server-docker) - Manage your local Docker containers with natural language * [slack](https://github.com/korotovsky/slack-mcp-server) - Interact with Slack * [ddg-search](https://github.com/nickclyde/duckduckgo-mcp-server) - Perform web searches with the DuckDuckGo search engine +* [iwe](https://github.com/iwe-org/iwe) - Navigate and manage large markdown knowledgebases (plan repos, specs, notes) as a structured + graph. The server is rooted at the directory Coyote is launched from (`--project .`), runs fully locally (no network access needed), + and requires the `iwec` binary. Pairs with the built-in `iwe-knowledge-base` [skill](Skills), which enables this server on load. The `mcp.json` file is created from a bundled template on first run and is never overwritten afterward. It is your own configuration to edit freely. To discard your changes and restore the bundled template (for example, to pick up new diff --git a/Skills.md b/Skills.md index 732a4c4..058a69c 100644 --- a/Skills.md +++ b/Skills.md @@ -349,14 +349,19 @@ whitelist — but their processes stay cached for fast re-load. # Built-in Skills -Coyote ships with four built-in skills, installed automatically on first run: +Coyote ships with nine built-in skills, installed automatically on first run: -| Skill | Granted tools | Purpose | -|-------------------|--------------------------------------------------------------------------|-------------------------------------------------------------------------| -| `git-master` | `execute_command` | Atomic commits, rebase methodology, conflict resolution, investigation. | -| `code-review` | `fs_read, fs_grep, fs_glob, fs_cat, fs_ls` | Correctness/tests/clarity/coupling/footguns review checklist. | -| `ai-slop-remover` | none (knowledge-only) | Detect and remove AI slop from code and prose. | -| `frontend-ui-ux` | `fs_read, fs_write, fs_patch, fs_grep, fs_glob, fs_cat, fs_ls, fs_mkdir` | Designer-turned-developer crafting UI/UX even without mockups. | +| Skill | Granted tools / MCP servers | Purpose | +|-----------------------|--------------------------------------------------------------------------|------------------------------------------------------------------------------| +| `git-master` | `execute_command` | Atomic commits, rebase methodology, conflict resolution, investigation. | +| `code-review` | `fs_read, fs_grep, fs_glob, fs_cat, fs_ls` | Correctness/tests/clarity/coupling/footguns review checklist. | +| `ai-slop-remover` | none (knowledge-only) | Detect and remove AI slop from code and prose. | +| `frontend-ui-ux` | `fs_read, fs_write, fs_patch, fs_grep, fs_glob, fs_cat, fs_ls, fs_mkdir` | Designer-turned-developer crafting UI/UX even without mockups. | +| `delegation-protocol` | none (knowledge-only) | Structured 6-section delegation template and session-continuity rules for sub-agents. | +| `parallel-research` | none (knowledge-only) | Fan-out exploration protocol; parallel research agents without duplicated work. | +| `oracle-protocol` | none (knowledge-only) | Discipline for when and how to consult Oracle. | +| `verification-gates` | `execute_command` | Evidence requirements (diagnostics, builds, tests) before claiming completion. | +| `iwe-knowledge-base` | MCP server: `iwe` | Navigate and curate large markdown knowledgebases (plans, specs, notes) via [IWE](https://github.com/iwe-org/iwe) graph tools. Requires the `iwec` binary. | Each is intentionally short — they're starter templates. Fork them via `.skill ` to customize.