From eecfe9c48f9a4cfc9b3b997e82af23a1679de150 Mon Sep 17 00:00:00 2001
From: thoroc <thomas.a.roche@gmail.com>
Date: Mon, 11 May 2026 10:56:37 +0100
Subject: [PATCH 1/3] docs(providers): add Cline and Kiro provider docs

---
 docs/providers/cline.md | 30 ++++++++++++++++++++++++++++++
 docs/providers/kiro.md  | 30 ++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+)
 create mode 100644 docs/providers/cline.md
 create mode 100644 docs/providers/kiro.md

diff --git a/docs/providers/cline.md b/docs/providers/cline.md
new file mode 100644
index 0000000..72eee46
--- /dev/null
+++ b/docs/providers/cline.md
@@ -0,0 +1,30 @@
+# Cline
+
+**iris provider name:** `cline`
+
+## Config file
+
+| Scope   | Path |
+|---------|------|
+| Project | — |
+| Global  | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+
+Project-level config is not supported.
+
+## Format
+
+```json
+{
+  "mcpServers": {
+    "server-name": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
+      "env": { "KEY": "value" }
+    }
+  }
+}
+```
+
+Root key: `mcpServers` (standard MCP JSON format). Both stdio (`command`/`args`/`env`) and HTTP (`url`/`headers`) transports are supported.
+
+## References
diff --git a/docs/providers/kiro.md b/docs/providers/kiro.md
new file mode 100644
index 0000000..0fc083b
--- /dev/null
+++ b/docs/providers/kiro.md
@@ -0,0 +1,30 @@
+# Kiro
+
+**iris provider name:** `kiro`
+
+## Config file
+
+| Scope   | Path |
+|---------|------|
+| Project | `.kiro/settings/mcp.json` |
+| Global  | `~/.kiro/settings/mcp.json` |
+
+Both project-level and global configs are supported.
+
+## Format
+
+```json
+{
+  "mcpServers": {
+    "server-name": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
+      "env": { "KEY": "value" }
+    }
+  }
+}
+```
+
+Root key: `mcpServers` (standard MCP JSON format). Both stdio (`command`/`args`/`env`) and HTTP (`url`/`headers`) transports are supported.
+
+## References

From 3d7270861e8324354cca1e3dab83134a4070ce52 Mon Sep 17 00:00:00 2001
From: thoroc <thomas.a.roche@gmail.com>
Date: Mon, 11 May 2026 10:58:52 +0100
Subject: [PATCH 2/3] docs(readme): add Cline and Kiro to supported providers
 table

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index d50dc48..b3bef6e 100644
--- a/README.md
+++ b/README.md
@@ -74,6 +74,8 @@ The `providers` field is written automatically by `iris init -I` and tells `iris
 | Kimi Code (`kimi`) | — | `~/.kimi/mcp.json` |
 | Mistral Vibe (`mistral-vibe`) | `.vibe/config.toml` | `~/.vibe/config.toml` |
 | IntelliJ IDEA (`intellij`) | `.idea/mcp.json` | — |
+| Cline (`cline`) | — | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
+| Kiro (`kiro`) | `.kiro/settings/mcp.json` | `~/.kiro/settings/mcp.json` |
 
 ## Development
 

From e67380f6e7a26977eef8535ea2ab0f9898e9fd69 Mon Sep 17 00:00:00 2001
From: thoroc <thomas.a.roche@gmail.com>
Date: Mon, 11 May 2026 11:01:52 +0100
Subject: [PATCH 3/3] docs(agents): enumerate all 8 files required for a new
 provider PR

---
 AGENTS.md | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index 3e080e5..bcf31c6 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -60,7 +60,20 @@ All Go formatting is enforced by `mise run lint` (golangci-lint with gofmt). Key
 
 ## Git workflow
 
-A new provider PR always commits **all 6 files atomically** (see Provider testdata fixtures below).
+A new provider PR always commits all files atomically:
+
+| File | Purpose |
+|------|---------|
+| `internal/providers/<name>.go` | Provider implementation |
+| `internal/providers/<name>_test.go` | Tests (Config, Parse, Generate, Exists) |
+| `internal/providers/fixtures/<name>_input.json` | Realistic on-disk config |
+| `internal/providers/fixtures/<name>_expected.json` | Exact iris output |
+| `internal/types/provider.go` | Add `NameXxx` constant |
+| `cmd/iris/main.go` | Register `New<Name>Provider()` |
+| `docs/providers/<slug>.md` | Provider documentation |
+| `README.md` | Add to supported providers table |
+
+Create a feature branch, push, open a PR. Run `mise run test` and `mise run lint` at session end to confirm no regressions.
 
 ## Provider testdata fixtures