feature-dev

Claude Code - BRUTAL EDITION 🔥

Claude Code BRUTAL EDITION is an enterprise-hardened fork that enforces zero-tolerance for "vibecoding" anti-patterns. Every line of code generated follows SOTA (State of the Art) engineering practices with built-in security validation, structured logging, and comprehensive quality standards.

Built on top of the original Claude Code agentic coding tool, this edition adds:

• ✅ Zero hardcoded secrets - Environment variables enforced
• ✅ Zero SQL/command injection - Input validation framework
• ✅ Zero silent failures - Explicit error handling required
• ✅ SOTA patterns - Circuit breakers, structured logging, idempotency
• ✅ Enterprise documentation - Inclusive language, no condescending tone
• ✅ Security-first - Allowlist validation, secrets management

Original Claude Code: An agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows -- all through natural language commands.

Learn more:

• Official Documentation
• BRUTAL EDITION Repository

What Makes BRUTAL EDITION Different?

🛡️ Enterprise-Grade Engineering Standards

This edition enforces 300+ quality checks covering:

1. Security Hardening

   • No hardcoded secrets (validated via hooks)
   • SQL/Command injection prevention
   • Input validation with allowlist approach
   • Secrets management best practices

2. Code Quality Enforcement

   • Structured logging (JSON format)
   • Explicit error handling (no silent failures)
   • Type hints required on all public functions
   • Named constants (no magic numbers)
   • Function complexity limits (<50 lines, <5 params)

3. Documentation Standards

   • Inclusive language (main/replica, allowlist/denylist)
   • No condescending tone ("simply", "just")
   • Prerequisites clearly stated with versions
   • Real examples (no Lorem Ipsum)

4. SOTA Architectural Patterns

   • Circuit breaker pattern
   • Idempotency keys
   • Event sourcing capabilities
   • Graceful degradation
   • Dependency injection

See CODE_QUALITY_STANDARDS.md and DOCUMENTATION_STANDARDS.md for complete details.

Get Started

1. Install Claude Code:

MacOS/Linux:

curl -fsSL https://claude.ai/install.sh | bash

Homebrew (MacOS):

brew install --cask claude-code

Windows:

irm https://claude.ai/install.ps1 | iex

NPM:

npm install -g @anthropic-ai/claude-code

NOTE: If installing with NPM, you also need to install Node.js 18+

2. Navigate to your project directory and run claude.

3. BRUTAL EDITION Banner: On startup, you'll see the custom banner with quality standards enforcement active.

BRUTAL EDITION Features

Active Quality Enforcement

The BRUTAL EDITION includes several enforcement mechanisms:

• Pre-commit Hooks: Validates code before generation
• Input Validation Framework: plugins/hookify/utils/validation.py
• Structured Logging: plugins/hookify/utils/logging.py
• Configuration Validation: Ensures proper setup
• Anti-Vibecoding Rules: Real-time pattern detection

New Documentation

• CODE_QUALITY_STANDARDS.md - 400+ lines covering all anti-patterns and SOTA solutions
• DOCUMENTATION_STANDARDS.md - Professional documentation guidelines
• CONTRIBUTING.md - Complete contribution workflow
• .env.example - Secure environment variable template
• .claude/ENGINEERING_STANDARDS.md - LLM guidance for code generation

Validation Utilities

# Input validation
from hookify.utils.validation import InputValidator

errors = InputValidator.validate_file_path(user_path)
errors += InputValidator.validate_bash_command(command)
errors += InputValidator.validate_regex_pattern(pattern)

# Structured logging
from hookify.utils.logging import StructuredLogger

logger = StructuredLogger("component")
logger.error("Operation failed", {"user_id": 123}, error=exception)

Plugins

This repository includes several Claude Code plugins that extend functionality with custom commands and agents. See the plugins directory for detailed documentation on available plugins.

Reporting Bugs