docs: add CLI commands and project configuration guide to README

- Document codingbuddy init command and usage
- Add MCP resources, tools, and prompts reference tables
- Add project configuration guide with examples
- Update paths and environment variables

Author: wishket-pjw

mcp-server/README.md

@@ -1,12 +1,49 @@
-# Codingbuddy Rules MCP Server
+# Codingbuddy MCP Server
 
-A NestJS-based Model Context Protocol (MCP) server that exposes the Multi-AI Rules System (`.ai-rules/`) to AI clients.
+A NestJS-based Model Context Protocol (MCP) server that provides AI coding assistants with project-specific context and rules.
+
+## Quick Start
+
+```bash
+# Initialize project configuration (AI-powered)
+npx codingbuddy init
+
+# This analyzes your project and creates codingbuddy.config.js
+```
 
 ## Features
 
-- **Resources**: Access rule files directly (`rules://core`, `rules://agents/frontend-developer`, etc.)
-- **Tools**: Search rules (`search_rules`) and get agent profiles (`get_agent_details`).
-- **Prompts**: Activate agents with context (`activate_agent`).
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `codingbuddy init` | Analyze project and generate configuration |
+| `codingbuddy --help` | Show help |
+| `codingbuddy --version` | Show version |
+
+### MCP Resources
+
+| Resource | Description |
+|----------|-------------|
+| `config://project` | Project configuration (tech stack, architecture, language) |
+| `rules://rules/core.md` | Core workflow rules |
+| `rules://rules/project.md` | Project setup rules |
+| `rules://agents/{name}.json` | Specialist agent definitions |
+
+### MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_project_config` | Get project configuration settings |
+| `search_rules` | Search through rules and guidelines |
+| `get_agent_details` | Get detailed profile of a specialist agent |
+| `parse_mode` | Parse PLAN/ACT/EVAL workflow mode (includes language setting) |
+
+### MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `activate_agent` | Activate a specialist agent with project context |
 
 ## Prerequisites
 
@@ -26,12 +63,14 @@ Add the following configuration to your Claude Desktop config:
   "mcpServers": {
     "codingbuddy-rules": {
       "command": "npx",
-      "args": ["codingbuddy"]
+      "args": ["codingbuddy-mcp"]
     }
   }
 }
 ```
 
+> **Note**: Use `codingbuddy-mcp` for the MCP server. The `codingbuddy` command is for CLI operations like `init`.
+
 ### Option 2: Global Installation
 
 ```bash
@@ -63,7 +102,7 @@ yarn build
   "mcpServers": {
     "codingbuddy-rules": {
       "command": "node",
-      "args": ["/ABSOLUTE/PATH/TO/codingbuddy/mcp-server/dist/main.js"]
+      "args": ["/ABSOLUTE/PATH/TO/codingbuddy/mcp-server/dist/src/main.js"]
     }
   }
 }
@@ -100,6 +139,91 @@ The server will start in SSE mode, exposing:
 | `MCP_TRANSPORT` | Transport mode (`stdio` or `sse`) | `stdio` |
 | `PORT` | HTTP port for SSE mode | `3000` |
 | `CODINGBUDDY_RULES_DIR` | Custom path to `.ai-rules` directory | Auto-detected |
+| `CODINGBUDDY_PROJECT_ROOT` | Project root for config loading | Current directory |
+| `ANTHROPIC_API_KEY` | API key for `codingbuddy init` | Required for init |
+
+## Project Configuration
+
+### Initialize Configuration
+
+```bash
+# Basic usage (requires ANTHROPIC_API_KEY env var)
+npx codingbuddy init
+
+# With options
+npx codingbuddy init --format json        # Output as JSON instead of JS
+npx codingbuddy init --force              # Overwrite existing config
+npx codingbuddy init /path/to/project     # Specify project path
+npx codingbuddy init --api-key sk-...     # Pass API key directly
+```
+
+### Configuration File
+
+The `codingbuddy init` command creates a `codingbuddy.config.js` file:
+
+```javascript
+module.exports = {
+  // Response language (ko, en, ja, etc.)
+  language: 'ko',
+
+  // Project metadata
+  projectName: 'my-awesome-app',
+  description: 'A modern web application',
+
+  // Technology stack
+  techStack: {
+    languages: ['TypeScript'],
+    frontend: ['React', 'Next.js', 'Tailwind CSS'],
+    backend: ['Node.js', 'Prisma'],
+    database: ['PostgreSQL'],
+    tools: ['ESLint', 'Prettier', 'Vitest'],
+  },
+
+  // Architecture pattern
+  architecture: {
+    pattern: 'feature-sliced-design',
+    structure: ['app', 'widgets', 'features', 'entities', 'shared'],
+  },
+
+  // Coding conventions
+  conventions: {
+    style: 'airbnb',
+    naming: {
+      files: 'kebab-case',
+      components: 'PascalCase',
+      functions: 'camelCase',
+    },
+  },
+
+  // Testing strategy
+  testStrategy: {
+    approach: 'tdd',
+    frameworks: ['Vitest', 'Playwright'],
+    coverage: 80,
+  },
+};
+```
+
+### File Structure
+
+```
+my-project/
+├── codingbuddy.config.js     # Main configuration
+├── .codingignore             # Files to ignore (gitignore syntax)
+└── .codingbuddy/             # Additional context (optional)
+    └── context/
+        ├── architecture.md   # Architecture documentation
+        └── api-guide.md      # API usage guide
+```
+
+### How AI Uses Configuration
+
+When you use an AI assistant with this MCP server:
+
+1. **Language**: AI responds in your configured language
+2. **Tech Stack**: AI provides code examples using your frameworks
+3. **Architecture**: AI suggests structures following your patterns
+4. **Conventions**: AI follows your naming and style rules
 
 ## Development
 
@@ -119,7 +243,7 @@ The [MCP Inspector](https://github.com/modelcontextprotocol/inspector) is a web-
 yarn build
 
 # Run with Inspector
-npx @modelcontextprotocol/inspector node dist/main.js
+npx @modelcontextprotocol/inspector node dist/src/main.js
 ```
 
 ### 2. Manual Test Script

yarn.lock

@@ -53,6 +53,22 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@anthropic-ai/sdk@npm:^0.71.2":
+  version: 0.71.2
+  resolution: "@anthropic-ai/sdk@npm:0.71.2"
+  dependencies:
+    json-schema-to-ts: "npm:^3.1.1"
+  peerDependencies:
+    zod: ^3.25.0 || ^4.0.0
+  peerDependenciesMeta:
+    zod:
+      optional: true
+  bin:
+    anthropic-ai-sdk: bin/cli
+  checksum: 10c0/6561264d2d516b0a2a2f48bba739497b76ec1ef85a5b78deca7900701513ca7cb5317dc4ee8147fc3f734709d364e29e2aaf79b39afe8284b0bf0c0c172f8223
+  languageName: node
+  linkType: hard
+
 "@babel/code-frame@npm:^7.0.0, @babel/code-frame@npm:^7.16.7":
   version: 7.27.1
   resolution: "@babel/code-frame@npm:7.27.1"
@@ -89,6 +105,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@babel/runtime@npm:^7.18.3":
+  version: 7.28.4
+  resolution: "@babel/runtime@npm:7.28.4"
+  checksum: 10c0/792ce7af9750fb9b93879cc9d1db175701c4689da890e6ced242ea0207c9da411ccf16dc04e689cc01158b28d7898c40d75598f4559109f761c12ce01e959bf7
+  languageName: node
+  linkType: hard
+
 "@babel/types@npm:^7.28.5":
   version: 7.28.5
   resolution: "@babel/types@npm:7.28.5"
@@ -2145,6 +2168,7 @@ __metadata:
   version: 0.0.0-use.local
   resolution: "codingbuddy@workspace:mcp-server"
   dependencies:
+    "@anthropic-ai/sdk": "npm:^0.71.2"
     "@modelcontextprotocol/sdk": "npm:^1.0.1"
     "@nestjs/cli": "npm:^10.0.0"
     "@nestjs/common": "npm:^10.0.0"
@@ -2162,7 +2186,8 @@ __metadata:
     vitest: "npm:^4.0.15"
     zod: "npm:^3.22.0"
   bin:
-    codingbuddy-mcp: ./dist/main.js
+    codingbuddy: ./dist/src/cli/cli.js
+    codingbuddy-mcp: ./dist/src/main.js
   languageName: unknown
   linkType: soft
 
@@ -3781,6 +3806,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"json-schema-to-ts@npm:^3.1.1":
+  version: 3.1.1
+  resolution: "json-schema-to-ts@npm:3.1.1"
+  dependencies:
+    "@babel/runtime": "npm:^7.18.3"
+    ts-algebra: "npm:^2.0.0"
+  checksum: 10c0/609bae04aa5e860a11b6d30ccf41445fae1c7f66fb600c1d170257cf33aa468aa9d03aa046428c3688aff0ff450c2b0c76584b66fa4a5d0da8e33799e4c439a6
+  languageName: node
+  linkType: hard
+
 "json-schema-traverse@npm:^0.4.1":
   version: 0.4.1
   resolution: "json-schema-traverse@npm:0.4.1"
@@ -5502,6 +5537,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"ts-algebra@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "ts-algebra@npm:2.0.0"
+  checksum: 10c0/4ae93bec1bada635bba425854eec323dad50b6ffe86bc04ad2d7f9ce3fb129d673dcf483e19a6e70d07a3a9083e6a0a7f4e004bb8d2164cddc60cc9540ba187f
+  languageName: node
+  linkType: hard
+
 "ts-api-utils@npm:^2.1.0":
   version: 2.1.0
   resolution: "ts-api-utils@npm:2.1.0"