Skip to content

tags: - claude-code - ai-agents - developer-tools - workflow-automation - code-standards original-url: https://github.com/affaan-m/ECC

ECC: The Agent Harness Performance Optimization System

Original URL: https://github.com/affaan-m/ECC

Introduction

ECC (Agent Harness Performance Optimization System) is an open-source framework developed by Affaan Ahmed, winner of the Anthropic Hackathon. It provides a comprehensive system for optimizing AI agent workflows across multiple development environments including Claude Code, Cursor, OpenCode, Codex, and others. ECC delivers production-ready agents, skills, hooks, rules, and security scanning capabilities evolved through extensive real-world usage.

Core Components and Architecture

Agents and Skills

  • 60 specialized subagents for delegated tasks with limited scope
  • 232 reusable skills as the primary workflow surface
  • 75 legacy command shims for backward compatibility
  • Skills cover domain-specific workflows like TDD, security review, API design, and testing

Rules and Guidelines

  • Language-agnostic principles in rules/common/ for universal coding standards
  • Language-specific packs for TypeScript, Python, Go, Swift, PHP, and more
  • Always-follow guidelines covering coding style, git workflow, testing, and security

Hooks and Automation

  • Event-driven hooks for sessionStart, afterFileEdit, beforeSubmitPrompt, and more
  • Automated formatting, TypeScript checking, and secret detection
  • Memory persistence across sessions for context continuity

Installation and Setup

# Add marketplace
/plugin marketplace add https://github.com/affaan-m/ECC
# Install plugin
/plugin install ecc@ecc

Manual Installation

# Clone and install
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
./install.sh --profile full --target claude

Selective Installation

# Minimal profile for rules-only
./install.sh --profile minimal --target claude
# Component-specific installation
npx ecc consult "security reviews" --target claude

Cross-Platform Support

ECC provides native support for major development environments:

  • Claude Code: Primary target with full hook support
  • Cursor: Project-local adapters with DRY hook pattern
  • OpenCode: Plugin support with 11 hook events
  • Codex: CLI and macOS app support with AGENTS.md
  • GitHub Copilot: Instruction and prompt layer integration
  • Zed: Project-local selective install adapters
  • Gemini CLI: Experimental support via .gemini/ configs

Key Features and Capabilities

Token Optimization

  • Model routing for cost efficiency
  • Context management and compaction strategies
  • Recommended settings for reduced API costs without quality loss

Security and Verification

  • AgentShield integration for vulnerability scanning
  • 102+ static analysis rules covering secrets, permissions, and injection risks
  • Security-first development workflows

Continuous Learning

  • Instinct-based learning system that auto-extracts patterns
  • Confidence scoring for learned behaviors
  • Import/export capabilities for team knowledge sharing

Multi-Agent Orchestration

  • Parallel task decomposition with /multi-plan and /multi-execute
  • Backend/frontend workflow orchestration
  • Session management and state tracking

Version Highlights (v2.0.0-rc.1)

Dashboard GUI

  • Tkinter-based desktop application with dark/light theme toggle
  • Search and filter across all components
  • Real-time metadata display for agents, skills, and commands

Operator Workflows

  • New operator-focused skills for business operations
  • Social media and content creation tooling
  • Integration with external services and APIs

Framework Expansion

  • Support for 12 language ecosystems including Rust, Kotlin, and C++
  • Expanded cross-harness packaging for broader compatibility
  • Native tools for testing and security audit

Configuration and Customization

Package Manager Detection

ECC automatically detects preferred package managers with priority: 1. Environment variable (CLAUDE_PACKAGE_MANAGER) 2. Project config (.claude/package-manager.json) 3. Lock file detection 4. Global config fallback

Hook Runtime Controls

# Adjust strictness
export ECC_HOOK_PROFILE=minimal|standard|strict
# Disable specific hooks
export ECC_DISABLED_HOOKS="hook-id-1,hook-id-2"
# Control session context
export ECC_SESSION_START_MAX_CHARS=4000

Best Practices and Recommendations

Context Management

  • Keep under 10 MCP servers per project
  • Use /mcp to disable unused servers
  • Monitor context window with /cost command

Workflow Optimization

  • Use /clear between unrelated tasks
  • Apply /compact at logical breakpoints
  • Leverage skills over commands for new workflows

Team Collaboration

  • Share instincts across team members
  • Use selective installation for team-specific needs
  • Maintain consistent coding standards through rules

Conclusion

ECC represents a significant advancement in AI-assisted development workflows, providing a comprehensive toolkit for optimizing agent performance across multiple environments. With its extensive agent catalog, security-focused approach, and cross-platform compatibility, ECC enables teams to build production-ready AI workflows while maintaining high standards for code quality and security. The system's modular architecture allows for selective adoption, making it suitable for both individual developers and large-scale team environments.