{"id":"69fc7133-7f3f-408d-ace2-f9b3639547db","slug":"claude-code-engineering-guide","kind":"mcp","name":"claude-code-engineering-guide","summary":"Comprehensive guide for engineering with Claude Code - Best practices, security guidelines, and development workflows","owner":"reivosar","repoUrl":"https://github.com/reivosar/claude-code-engineering-guide","license":"MIT","licenseTier":"permissive","trust":"community","stars":4,"match":null,"fewStars":true,"format":"mcp","createdAt":"2025-07-14T20:56:03.000Z","addedAt":"2026-10-21T15:33:13.158Z","logoUrl":"https://avatars.githubusercontent.com/u/2153822?u=2c6cdd380f12121adc51c667fb905eafc05c4084&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-22T20:30:10.545Z","sample":false,"url":"https://conduits.dev/tools/claude-code-engineering-guide","language":"ASL","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Claude Code Engineering Guide - DSL Version\n\nModular engineering framework in Claude DSL v0.3 format with MCP server support for Claude Desktop.\n\n## Quick Setup\n\n```bash\ngit clone https://github.com/username/claude-code-engineering-guide.git\ncd claude-code-engineering-guide\nchmod +x setup-claude-dsl.sh\n./setup-claude-dsl.sh\n```\n\nChoose your integration method:\n1. **MCP Server (Recommended)** - Auto-load rules on demand, 0 tokens\n2. **Manual DSL Loading** - Copy CLAUDE.md, use 4,404 tokens\n\n## MCP Server Benefits\n\n| Method | Token Usage | Setup | Real-time Updates |\n|--------|-------------|--------|-------------------|\n| **MCP Server** | **0 tokens** | One-time setup | ✅ Automatic |\n| **Manual DSL** | 4,404 tokens | Per session | ❌ Manual reload |\n| **Markdown** | 7,041 tokens | Per session | ❌ Manual reload |\n\n## Architecture Overview\n\n```\ndsl/\n├── entry-point.dsl          # Main orchestrator\n├── development.dsl          # Development workflow\n├── CLAUDE.md               # Session entry point\n├── behavior-rules/         # Claude's operational behaviors\n├── coding-rules/           # Code quality and standards\n├── design-rules/           # UI/UX and documentation\n├── git-rules/              # Git workflow operations\n├── security-rules/         # Security requirements\n└── validation-rules/       # Correctness verification\n\nmcp-server/                 # MCP server for Claude Desktop\n├── mcp-handler.js          # Main MCP handler\n├── cli.js                  # Command line interface\n└── package.json            # NPM package configuration\n```\n\n## Usage\n\n### With MCP Server (After Setup)\nIn Claude Desktop:\n- `@dsl-rules` - List available DSL resources\n- `@dsl-rules claude.md` - Show session instructions\n- `@dsl-rules security-rules` - Show security rules\n- `/apply-dsl-rules` - Apply DSL rules for development\n- `/security-check web_application` - Run security validation\n\n### Manual DSL Loading\n```\nFollow entry-point.dsl for complete DSL execution.\n```\n\n## File Structure Details\n\n### Core Files (Always Loaded)\n- **`CLAUDE.md`** (15 lines) - Mandatory session entry point\n- **`entry-point.dsl`** (247 lines) - Main DSL orchestrator\n- **`development.dsl`** (138 lines) - Development workflow\n\n### Module Categories\n\n#### behavior-rules/ (7 files, 312 lines)\nClaude's operational behaviors and error handling\n\n#### coding-rules/ (4 files, 201 lines)\nCode quality and development standards\n\n#### design-rules/ (3 files, 114 lines)\nUI/UX standards and documentation\n\n#### security-rules/ (5 files, 218 lines)\nComprehensive security requirements\n\n#### validation-rules/ (4 files, 172 lines)\nCorrectness verification and validation\n\n#### git-rules/ (2 files, 54 lines)\nGit workflow and operations\n\n### Support Files\n- **`checklist.dsl`** (25 lines) - Final verification checklist\n- **`app-types.dsl`** (62 lines) - Application type definitions\n- **`risk-assessment.dsl`** (41 lines) - Risk evaluation framework\n\n## Key Features\n\n### 1. MCP Server Integration\n- **Zero token usage**: Rules loaded on-demand\n- **Real-time updates**: File changes apply immediately\n- **Conditional loading**: Task-appropriate rules only\n\n### 2. Modular Rule System\n- **Category organization**: Clear separation of concerns\n- **Cross-references**: Unified variables prevent duplication\n- **Extensible architecture**: Easy to add new categories\n\n### 3. Token Efficiency Comparison\n\n| Version | Files | Lines | Tokens | Efficiency |\n|---------|-------|-------|--------|------------|\n| **MCP Server** | 30 files | 1,573 lines | **0 tokens** | **100% reduction** |\n| **DSL** | 30 files | 1,573 lines | ~4,404 tokens | 37% reduction |\n| **YAML** | 30 files | 1,473 lines | ~5,084 tokens | 28% reduction |\n| **Markdown** | 10 files | 1,264 lines | ~7,041 tokens | Baseline |\n\n## Manual Installation\n\nIf the setup script fails:\n\n### MCP Server\n```bash\ncd mcp-server\nnpm install\nnpm install -g .\n```\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"dsl-rules\": {\n      \"command\": \"claude-dsl\",\n      \"args\": [\"/absolute/path/to/this/repo/dsl\"]\n    }\n  }\n}\n```\n\n### Manual DSL\nCopy `dsl/CLAUDE.md` contents and paste into Claude sessions.\n\n## Troubleshooting\n\n### Setup Script Issues\n- **Permission denied**: `chmod +x setup-claude-dsl.sh`\n- **npm errors**: Use `sudo npm install -g .` if needed\n- **Command not found**: Check PATH includes npm global bin\n\n### MCP Server Issues\n```bash\n# Test MCP server\nclaude-dsl /path/to/dsl/folder\n\n# Verify installation\nclaude-dsl --help\n```\n\n### Claude Desktop Issues\n1. Restart Claude Desktop after config changes\n2. Check config file syntax is valid JSON\n3. Verify DSL folder path is absolute\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details."}