{"id":35887212,"url":"https://github.com/optimaquantum/claude-critical-rules-mcp","last_synced_at":"2026-01-13T21:59:04.039Z","repository":{"id":331632675,"uuid":"1130616362","full_name":"optimaquantum/claude-critical-rules-mcp","owner":"optimaquantum","description":"MCP server for Claude AI providing automatic enforcement of critical rules - Prevents 96 documented failure patterns","archived":false,"fork":false,"pushed_at":"2026-01-10T13:29:38.000Z","size":65,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T04:05:08.115Z","etag":null,"topics":["ai-automation","anthropic","best-practices","claude","claude-ai","claude-code","claude-desktop","developer-tools","mcp","mcp-server","model-context-protocol","npm-package","typescript"],"latest_commit_sha":null,"homepage":"https://optimaquantum.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/optimaquantum.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-08T18:57:52.000Z","updated_at":"2026-01-10T13:29:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/optimaquantum/claude-critical-rules-mcp","commit_stats":null,"previous_names":["optimaquantum/claude-critical-rules-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/optimaquantum/claude-critical-rules-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimaquantum%2Fclaude-critical-rules-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimaquantum%2Fclaude-critical-rules-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimaquantum%2Fclaude-critical-rules-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimaquantum%2Fclaude-critical-rules-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/optimaquantum","download_url":"https://codeload.github.com/optimaquantum/claude-critical-rules-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/optimaquantum%2Fclaude-critical-rules-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-automation","anthropic","best-practices","claude","claude-ai","claude-code","claude-desktop","developer-tools","mcp","mcp-server","model-context-protocol","npm-package","typescript"],"created_at":"2026-01-08T21:16:20.100Z","updated_at":"2026-01-13T21:59:04.034Z","avatar_url":"https://github.com/optimaquantum.png","language":"JavaScript","funding_links":[],"categories":["📦 Other"],"sub_categories":[],"readme":"# Claude Critical Rules MCP Server\n\n\u003e **MCP server providing automatic enforcement of 21 critical rules for Claude AI, based on 96+ documented failure patterns**\n\n[![npm version](https://badge.fury.io/js/@optimaquantum%2Fclaude-critical-rules-mcp-new.svg)](https://www.npmjs.com/package/@optima-quantum/claude-critical-rules-mcp-new)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/badge/version-1.2.0-blue.svg)](https://github.com/optimaquantum/claude-critical-rules-mcp/releases)\n\n## 🎯 What is this?\n\nAn MCP (Model Context Protocol) server that makes critical best practices automatically available to Claude AI in every conversation. Based on exhaustive analysis of **96+ real documented failures** over 6+ months of intensive production usage.\n\nThe system provides **21 numbered rules** organized into 5 categories, with automatic verification checklists, rule summaries, and auto-update capabilities.\n\n## ✨ Features\n\n- **21 Critical Rules** - Comprehensive checklist preventing common AI assistant failures\n- **5 Rule Categories** - Organized by: Verification, Backups, Execution, Database, Advanced\n- **Pre-flight Verification** - Mandatory checklist before technical tasks\n- **Auto-Update System** - Check and install rule updates from GitHub automatically\n- **Version Tracking** - SHA256 verification and changelog integration\n- **Evidence-based** - Every rule derived from real production failures\n\n## ⚡ Quick Install\n\n### Via npx (Recommended)\n\nAdd to your `claude_desktop_config.json`:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`  \n**Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"critical-rules\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@optima-quantum/claude-critical-rules-mcp-new\"]\n    }\n  }\n}\n```\n\n### Via Global Install\n\n```bash\nnpm install -g @optima-quantum/claude-critical-rules-mcp-new\n```\n\nThen configure:\n\n```json\n{\n  \"mcpServers\": {\n    \"critical-rules\": {\n      \"command\": \"claude-critical-rules-mcp\"\n    }\n  }\n}\n```\n\n### Restart Claude Desktop\n\nAfter configuration, restart Claude Desktop to load the MCP server.\n\n## 📋 Usage Instructions\n\n### **CRITICAL: Two Mandatory Steps Before Any Technical Task**\n\n#### 1. **ALWAYS Read, Understand, and Execute Compliance Check**\n\n```\nBefore starting ANY technical task, execute:\ncritical-rules:verify_compliance\n\nThis displays a 21-point checklist organized in 5 categories.\nDo NOT proceed until you confirm ALL 21 items.\n```\n\n#### 2. **ALWAYS Read Appropriate Skill Documentation**\n\n```\nBefore creating documents or working with specific technologies:\n- Read the appropriate skill file first\n- Common location: /mnt/skills/user/sysadmin-professional/SKILL.md\n- If skill doesn't exist: search online, verify reliability, propose installation\n```\n\n**Example Workflow:**\n```\nUser: \"Deploy the new API to production\"\n\nClaude:\n1. Executes: critical-rules:verify_compliance\n2. Reviews all 21 rules checklist\n3. Reads: /mnt/skills/user/sysadmin-professional/SKILL.md\n4. THEN proceeds with deployment\n```\n\n## 🛠️ Available Tools\n\n### `verify_compliance`\nDisplays mandatory 21-rule checklist before technical tasks.\n\n**Usage:**\n```javascript\ncritical-rules:verify_compliance\ntask_description: \"Deploy API to production\"\n```\n\n**Returns:**\n- 21-point checklist organized by category\n- Rule numbers and descriptions\n- Confirmation requirements\n- Version information\n\n### `get_rules_summary`\nQuick reference of all 21 rules with descriptions.\n\n**Usage:**\n```javascript\ncritical-rules:get_rules_summary\n```\n\n**Returns:**\n- Core principles (5 items)\n- All 21 rules by category\n- 6-step mandatory workflow\n- Update instructions\n\n### `get_version_info`\nDisplay current version and check for updates.\n\n**Usage:**\n```javascript\ncritical-rules:get_version_info\ncheck_remote: true  // Optional, default true\n```\n\n**Returns:**\n- Current version details\n- Remote version comparison\n- Update availability status\n- SHA256 hash information\n\n### `check_for_updates`\nCheck GitHub for new rule versions.\n\n**Usage:**\n```javascript\ncritical-rules:check_for_updates\n```\n\n**Returns:**\n- Update availability status\n- Version comparison\n- Release date\n- Changelog reference\n\n### `update_rules`\nDownload and install latest rules from GitHub.\n\n**Usage:**\n```javascript\ncritical-rules:update_rules\nforce: false  // Optional, force reinstall\n```\n\n**Returns:**\n- Update status\n- SHA256 verification\n- Backup location\n- Next steps\n\n## 📚 Available Resources\n\n### `critical-rules://instructions`\nComplete CRITICAL-RULES.md document with all 21 rules, examples, and detailed explanations.\n\n### `critical-rules://changelog`\nFull changelog with version history and update details.\n\n## 📖 The 21 Rules (Quick Reference)\n\n### 🔍 VERIFICATION (Rules 0-5)\n0. Never act without reading instructions completely\n1. Search current best practices (web_search mandatory)\n2. Read skills before creating documents\n3. Read ENTIRE file before modifying\n4. VERIFY, not assume structures/locations\n5. Check correct file/server\n\n### 💾 BACKUPS \u0026 PERMISSIONS (Rules 6-8)\n6. Search previous context if mentioned\n7. Backups with timestamp in standardized directories\n8. ASK before deleting/modifying critical items\n\n### 🔧 EXECUTION \u0026 VALIDATION (Rules 9-12)\n9. Ask SCOPE before implementing\n10. STOP if something fails (no cascading)\n11. Validate with EVIDENCE\n12. Complete logs (not just last 20 lines)\n\n### 🗃️ DATABASE \u0026 SECURITY (Rules 13-15)\n13. Database: backup → test → verify rollback\n14. Production vs Dev differentiation\n15. Security verification (IPs, fail2ban, firewall)\n\n### ⚡ ADVANCED RULES (Rules 16-21)\n16. Long commands (\u003e30s) → background execution\n17. NEVER use sed (python/awk/perl instead)\n18. Verify file line count before/after editing\n19. Follow instructions EXACTLY\n20. Check MCPs/skills/context FIRST\n21. Mandatory 21-point confirmation\n\n## 🎯 Core Principles\n\n1. **🔍 VERIFY, DON'T ASSUME** - Always check before acting\n2. **💾 BACKUP EVERYTHING** - Before any modification\n3. **🚫 ASK PERMISSION** - For deletions and critical changes\n4. **📊 EVIDENCE-BASED** - Test with proof, not assumptions\n5. **🛑 STOP ON ERRORS** - Don't continue after failures\n\n## 🔄 6-Step Mandatory Workflow\n\n0. **Ask scope** before starting\n1. **Analyze** completely\n2. **Plan** and explain\n3. **Create backups**\n4. **Execute** carefully\n5. **Validate** with evidence\n6. **Document** changes\n\n## 📊 Evidence Base\n\nBased on comprehensive analysis of:\n- **96+ documented failures** in production environments\n- **20+ recurring patterns** identified and categorized\n- **6+ months** of intensive Claude AI usage\n- **Multiple production systems** (servers, databases, APIs, deployments)\n\n## 🔐 Auto-Update Security\n\n- **SHA256 verification** - All downloaded rules verified for integrity\n- **Automatic backups** - Previous versions saved before updates\n- **Version tracking** - Complete changelog and version history\n- **Manual override** - Force parameter for explicit reinstalls\n\n## 🤝 Contributing\n\nContributions are welcome! If you've identified additional failure patterns or improvements:\n\n1. Fork the repository\n2. Create a feature branch\n3. Document the failure pattern with examples\n4. Submit a pull request\n\n## 📄 License\n\nMIT License - See [LICENSE](LICENSE) file for details.\n\n## 🏢 Author\n\n**Óptima Quantum Services FZCO**  \nDubai, UAE\n\n- Website: [optimaquantum.com](https://optimaquantum.com)\n- Email: support@optimaquantum.com\n- GitHub: [@optimaquantum](https://github.com/optimaquantum)\n\n## 📝 Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for version history and updates.\n\n## 🔗 Links\n\n- [npm Package](https://www.npmjs.com/package/@optima-quantum/claude-critical-rules-mcp-new)\n- [GitHub Repository](https://github.com/optimaquantum/claude-critical-rules-mcp)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n- [Claude AI](https://claude.ai)\n\n## ⭐ Star History\n\nIf this MCP server has helped prevent errors in your workflow, please consider starring the repository!\n\n---\n\n**Version:** 1.2.0  \n**Last Updated:** 2026-01-10  \n**Rules Count:** 21 numbered rules  \n**Failure Patterns Analyzed:** 96+\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foptimaquantum%2Fclaude-critical-rules-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foptimaquantum%2Fclaude-critical-rules-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foptimaquantum%2Fclaude-critical-rules-mcp/lists"}