@corbat-tech/coding-standards-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Corbat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,371 @@
+<div align="center">
+
+# CORBAT
+
+### Stop repeating yourself. Start coding.
+
+**Your architecture rules, TDD workflow, and SOLID principles — injected automatically into every AI response.**
+
+[![CI](https://github.com/corbat-tech/corbat-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/corbat-tech/corbat-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-1.0-blue.svg)](https://modelcontextprotocol.io/)
+
+</div>
+
+<p align="center">
+  <img src="assets/demo.gif" alt="CORBAT Demo" width="800">
+</p>
+
+---
+
+## The Problem
+
+Every time you ask AI to write code, you repeat the same instructions:
+
+```
+"Create a payment service. Use hexagonal architecture. Follow TDD.
+ Apply SOLID. Use our naming conventions. Ensure 80% coverage..."
+```
+
+**This is tedious, error-prone, and inconsistent.**
+
+## The Solution
+
+Define your standards once. Corbat injects them automatically.
+
+```
+You: "Create a payment service"
+
+Corbat: ✓ Detected Java/Spring project
+        ✓ Applied hexagonal architecture
+        ✓ Enforced TDD workflow
+        ✓ Injected SOLID principles
+        ✓ Set 80%+ coverage requirement
+```
+
+**One prompt. Full compliance.**
+
+---
+
+## Why Corbat vs Alternatives?
+
+| Feature | Corbat | Linters (ESLint, etc.) | Manual prompts |
+|---------|:------:|:----------------------:|:--------------:|
+| Enforces **before** code is written | ✅ | ❌ | ❌ |
+| Architecture patterns (hexagonal, DDD) | ✅ | ❌ | ⚠️ |
+| TDD workflow enforcement | ✅ | ❌ | ⚠️ |
+| Task-specific guardrails | ✅ | ❌ | ❌ |
+| Auto-detects your stack | ✅ | ❌ | ❌ |
+| Zero repetition | ✅ | ✅ | ❌ |
+
+**Linters catch errors after the fact. Corbat prevents them.**
+
+---
+
+## Quick Start
+
+**Step 1** — Clone and build:
+```bash
+git clone https://github.com/corbat-tech/corbat-mcp.git
+cd corbat-mcp && npm install && npm run build
+```
+
+**Step 2** — Connect to Claude:
+
+<table>
+<tr>
+<td><b>Claude Code</b></td>
+<td>
+
+```bash
+claude mcp add corbat node /absolute/path/to/corbat-mcp/dist/index.js
+```
+
+</td>
+</tr>
+<tr>
+<td><b>Claude Desktop</b></td>
+<td>
+
+Edit `~/.config/Claude/claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "corbat": {
+      "command": "node",
+      "args": ["/absolute/path/to/corbat-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+</td>
+</tr>
+</table>
+
+**Step 3** — Use it:
+```
+"Create a user service"
+```
+
+Corbat auto-detects your stack and applies all standards. **That's it.**
+
+---
+
+## What You Get
+
+When you ask Claude to create code, Corbat injects this context automatically:
+
+```markdown
+# Task: Create payment service
+
+## Detected
+- Stack: Java 21 · Spring Boot 3 · Maven
+- Task type: FEATURE
+- Profile: java-spring-backend
+
+## Guardrails
+
+### MUST
+✓ Write tests BEFORE implementation (TDD)
+✓ Use hexagonal architecture (domain/application/infrastructure)
+✓ Apply SOLID principles
+✓ Ensure 80%+ test coverage
+✓ Validate all inputs
+✓ Document public APIs
+
+### AVOID
+✗ God classes (>200 lines) or god methods (>20 lines)
+✗ Hard-coded configuration values
+✗ Mixing business logic with infrastructure
+✗ Circular dependencies between layers
+
+## Workflow
+1. CLARIFY  → Confirm requirements
+2. PLAN     → Create task checklist
+3. BUILD    → TDD cycle: Red → Green → Refactor
+4. VERIFY   → Tests pass, linter clean
+5. REVIEW   → Self-check against standards
+
+## Naming Conventions
+- Classes: PascalCase (PaymentService)
+- Methods: camelCase (processPayment)
+- Constants: SCREAMING_SNAKE_CASE
+- Packages: lowercase (com.example.payment)
+```
+
+**Claude now generates code that follows ALL your standards.**
+
+---
+
+## Task-Specific Guardrails
+
+Corbat adapts its rules based on what you're doing:
+
+<table>
+<tr>
+<th>Task</th>
+<th>MUST</th>
+<th>AVOID</th>
+</tr>
+<tr>
+<td><b>Feature</b></td>
+<td>TDD, 80%+ coverage, SOLID, hexagonal</td>
+<td>God classes, coupled layers</td>
+</tr>
+<tr>
+<td><b>Bugfix</b></td>
+<td>Failing test first, minimal changes</td>
+<td>Refactoring, adding features</td>
+</tr>
+<tr>
+<td><b>Refactor</b></td>
+<td>Tests pass before AND after, incremental</td>
+<td>Behavior changes, big bang</td>
+</tr>
+<tr>
+<td><b>Test</b></td>
+<td>AAA pattern, one assertion, descriptive names</td>
+<td>Implementation details, flaky tests</td>
+</tr>
+</table>
+
+---
+
+## Compatibility
+
+| Client | Status |
+|--------|:------:|
+| Claude Code (CLI) | ✅ Tested |
+| Claude Desktop | ✅ Tested |
+| Cursor | ⚠️ Experimental |
+| Windsurf | ⚠️ Experimental |
+| Other MCP clients | ✅ Standard protocol |
+
+---
+
+## Built-in Profiles
+
+| Profile | Best for | Architecture |
+|---------|----------|--------------|
+| `java-spring-backend` | Enterprise Java | Hexagonal + DDD |
+| `nodejs` | Node.js/TypeScript APIs | Clean Architecture |
+| `python` | Python/FastAPI | Clean Architecture |
+| `react` | React applications | Feature-based |
+| `angular` | Angular 19+ applications | Feature-based + Signals |
+| `vue` | Vue 3.5+ applications | Feature-based + Composition |
+| `minimal` | MVPs, prototypes | Basic standards |
+
+**Auto-detection**: Corbat reads `pom.xml`, `package.json`, `requirements.txt`, etc. to select the right profile.
+
+---
+
+## Customize (Optional)
+
+### Option A: Interactive generator
+```bash
+npx /path/to/corbat-mcp/dist/cli/init.js
+```
+
+### Option B: Manual config
+
+Create `.corbat.json` in your project root:
+
+```json
+{
+  "profile": "nodejs",
+  "rules": {
+    "always": [
+      "Use TypeScript strict mode",
+      "Prefer functional programming"
+    ],
+    "never": [
+      "Use any type"
+    ]
+  }
+}
+```
+
+---
+
+## Available Tools
+
+| Tool | Purpose |
+|------|---------|
+| `get_context` | **Primary** — Returns all standards for your task |
+| `validate` | Check code against standards |
+| `search` | Search standards documentation |
+| `profiles` | List available profiles |
+| `health` | Server status check |
+
+## Available Prompts
+
+| Prompt | Purpose |
+|--------|---------|
+| `implement` | Guided implementation with TDD workflow |
+| `review` | Expert code review (architecture, SOLID, security) |
+
+---
+
+## How It Works
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│  Your Prompt    │────▶│     Corbat      │────▶│  Claude + Rules │
+│                 │     │                 │     │                 │
+│ "Create user    │     │ 1. Detect stack │     │ Generates code  │
+│  service"       │     │ 2. Classify task│     │ following ALL   │
+│                 │     │ 3. Load profile │     │ your standards  │
+│                 │     │ 4. Inject rules │     │                 │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+```
+
+---
+
+## Included Documentation
+
+Corbat comes with 15 standards documents you can search:
+
+- **Architecture**: Hexagonal, DDD, Clean Architecture
+- **Code Quality**: SOLID, Clean Code, Naming Conventions
+- **Testing**: TDD, Unit/Integration/E2E guidelines
+- **DevOps**: Docker, Kubernetes, CI/CD
+- **Observability**: Logging, Metrics, Tracing
+
+Use `search` tool: *"search kafka"* → Returns event-driven architecture guidelines.
+
+---
+
+## Troubleshooting
+
+<details>
+<summary><b>Claude can't find corbat</b></summary>
+
+1. Use **absolute path** in config (not relative)
+2. Verify: `ls /your/path/to/corbat-mcp/dist/index.js`
+3. Check `node` is in PATH: `which node`
+4. Restart Claude completely
+5. Check Claude's MCP logs
+
+</details>
+
+<details>
+<summary><b>Wrong stack detected</b></summary>
+
+Override with `.corbat.json`:
+```json
+{ "profile": "nodejs" }
+```
+
+Or specify in prompt: *"...using profile nodejs"*
+
+</details>
+
+<details>
+<summary><b>Standards not being applied</b></summary>
+
+1. Check if `.corbat.json` exists in project root
+2. Verify profile exists in `profiles/templates/`
+3. Try explicit: *"Use corbat get_context for: your task"*
+
+</details>
+
+<details>
+<summary><b>Permission errors (macOS/Linux)</b></summary>
+
+```bash
+chmod +x /path/to/corbat-mcp/dist/index.js
+which node  # Use this absolute path in config
+```
+
+</details>
+
+---
+
+## Project Quality
+
+| Metric | Value |
+|--------|-------|
+| Test coverage | 80%+ |
+| Tests passing | 78 |
+| TypeScript | Strict mode |
+| Linting | Biome |
+| Architecture validation | dependency-cruiser |
+
+---
+
+## Links
+
+- [Full Documentation](docs/full-documentation.md)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Report Issues](https://github.com/corbat-tech/corbat-mcp/issues)
+
+---
+
+<div align="center">
+
+**Define once. Apply everywhere. Ship faster.**
+
+[Get Started](#quick-start) · [Documentation](docs/full-documentation.md) · [Report Bug](https://github.com/corbat-tech/corbat-mcp/issues)
+
+</div>

package/dist/agent.d.ts

@@ -0,0 +1,53 @@
+import { type DetectedStack, type Guardrails, type ProjectConfig, type TaskType } from './types.js';
+/**
+ * Load project configuration from .corbat.json
+ */
+export declare function loadProjectConfig(projectDir: string): Promise<ProjectConfig | null>;
+/**
+ * Detect project stack from file system.
+ */
+export declare function detectProjectStack(projectDir: string): Promise<DetectedStack | null>;
+/**
+ * Get guardrails for a specific task type.
+ */
+export declare function getGuardrails(taskType: TaskType, projectConfig?: ProjectConfig | null): Guardrails;
+/**
+ * Get project rules (always rules + task-specific rules).
+ */
+export declare function getProjectRules(taskType: TaskType, projectConfig?: ProjectConfig | null): string[];
+/**
+ * Classify task type from description.
+ */
+export declare function classifyTaskType(description: string): TaskType;
+/**
+ * Technical decision templates by category.
+ */
+export declare const TECHNICAL_DECISIONS: Record<string, {
+    options: Array<{
+        name: string;
+        description: string;
+        pros: string[];
+        cons: string[];
+        useWhen: string[];
+    }>;
+    defaultRecommendation: string;
+}>;
+/**
+ * Get a technical decision recommendation.
+ */
+export declare function getTechnicalDecision(category: string, _context: string, projectConfig?: ProjectConfig | null): {
+    options: Array<{
+        name: string;
+        description: string;
+        pros: string[];
+        cons: string[];
+        useWhen: string[];
+    }>;
+    recommendation: string;
+    reasoning: string;
+} | null;
+/**
+ * Format guardrails as markdown.
+ */
+export declare function formatGuardrailsAsMarkdown(guardrails: Guardrails): string;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAElB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAgQpB;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWzF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6E1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,UAAU,CAalG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,EAAE,CAkBlG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAuF9D;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,MAAM,EACN;IACE,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAoIF,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,GACnC;IACD,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAsBP;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAyBzE"}