updates readme and agent.md

Author: realEbi

AGENTS.md

@@ -15,17 +15,20 @@ lua/askCode/          ← all plugin logic lives here
     ├── init.lua      ← agent registry (maps name → module)
     ├── gemini.lua    ← Gemini CLI integration
     ├── kiro.lua      ← Kiro CLI integration
-    └── opencode.lua  ← OpenCode CLI integration
+    ├── opencode.lua  ← OpenCode CLI integration
+    └── claude.lua    ← Claude CLI integration
 plugin/askCode.lua    ← Neovim commands + <Plug> keymaps (entry point)
 tests/                ← MiniTest suite (one file per module)
 scripts/minimal_init.lua  ← headless Neovim init used by make test
 CODE-STANDARDS.md     ← authoritative coding standards and architecture
+.agents/add-new-agent.md  ← step-by-step plan for adding a new agent
+.claude/skills/add-agent/ ← Claude Code skill that automates adding a new agent
 ```
 
 ## Key Entry Points
 
 - **Feature work**: start in `lua/askCode/init.lua` — it orchestrates all modules
-- **Adding an agent**: create `lua/askCode/agents/<name>.lua`, register in `agents/init.lua`
+- **Adding an agent**: follow `.agents/add-new-agent.md`, or invoke the `/add-agent` Claude Code skill — create `lua/askCode/agents/<name>.lua`, register in `agents/init.lua`
 - **Config changes**: `lua/askCode/config.lua` — update `M.default` and annotations
 - **UI changes**: `lua/askCode/ui.lua` — `show_window` and `update_window`
 - **Commands/keymaps**: `plugin/askCode.lua`
@@ -55,6 +58,7 @@ Then users set `agent = "myagent"` in their config.
 - **Conversation history is a temp file**, not in-memory — `vim.fn.tempname()` path stored in `state.history_file`; full history is re-read and re-sent on every follow-up.
 - **Config merging uses `"keep"` strategy** — `vim.tbl_deep_extend("keep", changes, current)` means user values win over defaults, not the other way around.
 - **`opencode` agent uses a temp file for the prompt** — multiline prompts can't be safely passed via `shellescape` through `sh -c`; the agent writes the prompt to a temp file and uses `"$(cat <tmpfile>)"` in the command. It also requires `--format json` so the process exits cleanly.
+- **`claude` agent uses a temp file for the prompt** — same rationale as opencode; the prompt is written to a temp file and passed to `claude -p "$(cat <tmpfile>)"`. The `-p` flag makes Claude CLI non-interactive and outputs plain text, so `parse_response` only trims whitespace with no JSON parsing.
 
 ## Repo-Specific Tools
 
@@ -82,6 +86,24 @@ Tests use `MiniTest.new_child_neovim()` — each test case restarts a fresh chil
 - `vim.g.askcode_range` is set in `plugin/askCode.lua` for `AskCodeReplace` but never read — dead code.
 - `debug` logging only covers `init.lua`; agents and ui emit no debug output.
 
+## Adding a New Agent
+
+Use the `/add-agent` Claude Code skill to add a new agent in one step:
+
+```
+/add-agent <agent_name> <cli_invocation>
+```
+
+Example:
+
+```
+/add-agent claude "claude -p"
+```
+
+The skill reads the full implementation plan from `.agents/add-new-agent.md` and executes all steps automatically: creates the agent module, registers it, updates docs, writes unit tests, and verifies with `make test`.
+
+To add an agent manually without the skill, follow `.agents/add-new-agent.md` step by step.
+
 ## Detailed Documentation
 
 Full documentation is in `.agents/summary/`:

README.md

@@ -1,6 +1,6 @@
 # AskCode.nvim
 
-AskCode is a Neovim plugin that helps developers explore and understand codebases by connecting to CLI-based AI assistants like `gemini-cli`, `kiro-cli`, and `opencode`. It acts as your in-editor guide, letting you ask context-aware questions about selected code and receive answers without leaving Neovim.
+AskCode is a Neovim plugin that helps developers explore and understand codebases by connecting to CLI-based AI assistants like `gemini-cli`, `kiro-cli`, `opencode`, and `claude`. It acts as your in-editor guide, letting you ask context-aware questions about selected code and receive answers without leaving Neovim.
 
 ![Image](https://github.com/user-attachments/assets/e5f0dadb-9bdc-4b43-8c77-15a11810a3da)
 
@@ -18,15 +18,16 @@ AskCode is a Neovim plugin that helps developers explore and understand codebase
 ### Prerequisites
 
 - Neovim (v0.9.0 or later)
-- A compatible AI assistant CLI installed and configured in your shell environment (e.g., `gemini-cli`, `kiro-cli`, `opencode`).
+- A compatible AI assistant CLI installed and configured in your shell environment (e.g., `gemini-cli`, `kiro-cli`, `opencode`, `claude`).
 
 ### Supported Agents
 
-| Agent key  | CLI                                                         | Notes                     |
-| ---------- | ----------------------------------------------------------- | ------------------------- |
-| `gemini`   | [`gemini-cli`](https://github.com/google-gemini/gemini-cli) | Default agent             |
-| `kiro`     | [`kiro-cli`](https://kiro.dev)                              | Reads from stderr         |
-| `opencode` | [`opencode`](https://opencode.ai)                           | Uses `--format json` mode |
+| Agent key  | CLI                                                         | Notes                              |
+| ---------- | ----------------------------------------------------------- | ---------------------------------- |
+| `gemini`   | [`gemini-cli`](https://github.com/google-gemini/gemini-cli) | Default agent                      |
+| `kiro`     | [`kiro-cli`](https://kiro.dev)                              | Reads from stderr                  |
+| `opencode` | [`opencode`](https://opencode.ai)                           | Uses `--format json` mode          |
+| `claude`   | [`claude`](https://github.com/anthropics/claude-code)       | Uses `claude -p` non-interactive mode |
 
 ### Installation
 
@@ -145,6 +146,22 @@ vim.keymap.set("v", "<leader>ae", ":AskCode <Plug>(AskCodeAddDocstring)")
 vim.keymap.set("v", "<leader>ar", ":AskCodeReplace \"Refactor this code\"<CR>", { noremap = true, silent = true })
 ```
 
+## Adding a New Agent
+
+Use the `/add-agent` Claude Code skill to integrate any CLI-based AI assistant:
+
+```
+/add-agent <agent_name> <cli_invocation>
+```
+
+For example:
+
+```
+/add-agent myagent "myagent ask"
+```
+
+This skill creates the agent module, registers it, updates docs, and writes a full unit test suite — all verified by `make test`. See `.agents/add-new-agent.md` for the step-by-step plan if you prefer to do it manually.
+
 ## Development
 
 Contributions are welcome! To get started with development:
@@ -179,7 +196,7 @@ The project uses `mini.nvim` for its testing framework. You can find more inform
 ## Todo
 
 - [ ] **Support Prompt Templates**: Allow users to define custom prompt templates in the configuration.
-- [ ] **Integrate Claude-Code Agent**: Add a new agent for ClaudeCode by implementing the `prepare_command` function for its CLI.
+- [x] **Integrate Claude Agent**: Add a new agent for Claude CLI using `claude -p` non-interactive mode.
 - [ ] **Support Streaming JSON**: Improve the stream processor to parse chunked JSON responses for real-time display.
 - [x] **Support Follow-up Questions**: Maintain conversation history to allow for follow-up questions.
 - [x] **Integrate Kiro Agent**: Add a new agent for Kiro by implementing the `prepare_command` function for its CLI.