Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/affaan-m/ECC/llms.txt

Use this file to discover all available pages before exploring further.

ECC ships a complete manifest-driven installer that drops the right files into the right place for your harness and profile, then tracks exactly what was installed so upgrades and repairs are deterministic. The fastest path is a single npx command with a profile flag — no global install required.
If you are not sure which profile or components suit your workflow, ask the packaged advisor first: npx ecc consult "your workflow description" --target claude. It returns matching components, related profiles, and preview commands so you can inspect the exact file plan before committing.

​
Install ECC

1
Confirm prerequisites
2
ECC requires Node.js 18 or later and at least one supported AI coding harness. Check both before proceeding:
3
node --version   # must be >= 18.0.0
claude --version # or: cursor --version | codex --version | opencode --version
4
If you are targeting Claude Code, version v2.1.0 or later is required. Earlier versions handle the plugin hook system differently and will produce duplicate-hook errors.
5
6
Choose an install method
7
Pick exactly one install path and stick with it. Layering multiple methods (for example, plugin install followed by a full manual install) creates duplicate skills and duplicate hook execution.
8
npx (no global install)
# Recommended for most users — runs from npm without installing globally
npx ecc install --profile minimal --target claude
npm global
# Install the CLI globally, then use the ecc command directly
npm install -g ecc-universal
ecc install --profile minimal --target claude
git clone
# Full source clone — gives you the complete repo for rules, examples, and development
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
./install.sh --profile minimal --target claude
Windows (PowerShell)
# Git clone path on Windows
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
.\install.ps1 --profile minimal --target claude
9
Start with --profile minimal — it gives you rules, agents, commands, platform configs, and quality workflow skills without the hook runtime. Hooks add powerful automation but also surface-level complexity. Expand to --profile core or --profile developer once you are comfortable with the baseline.
10
11
Pick a profile
12
ECC’s installer is profile-driven. Each profile is a named set of modules that controls exactly what gets installed for your target harness.
13
ProfileModules IncludedBest Forminimalrules-core, agents-core, commands-core, platform-configs, workflow-qualityLow-context setups; rules + agents + skills, no hooksopencodecommands-core, platform-configs, workflow-qualityDefault OpenCode setup; hooks opt-in separatelycoreEverything in minimal + hooks-runtimeStandard harness baseline with hook enforcementdeveloperEverything in core + framework-language, database, orchestrationDay-to-day app engineering across frameworkssecurityEverything in core + securitySecurity-heavy workflows; OWASP, AgentShield, complianceresearchEverything in core + research-apis, business-content, social-distributionResearch, synthesis, and publishing workflowsfullAll currently classified modulesComplete ECC surface
14
To install a different profile, swap the --profile flag:
15
npx ecc install --profile developer --target claude
16
To target a different harness, swap --target:
17
npx ecc install --profile minimal --target cursor
npx ecc install --profile minimal --target codex
npx ecc install --profile opencode --target opencode
18
19
Verify the install
20
Once the installer completes, confirm ECC is tracking the installed files correctly:
21
# List all files ECC installed for the current context
npx ecc list-installed

# Query the install state and readiness summary
npx ecc status
22
You should see a list of installed modules and a readiness indicator. If anything looks wrong, run the doctor and repair commands:
23
# Diagnose missing or drifted ECC-managed files
npx ecc doctor

# Restore drifted or missing files without reinstalling everything
npx ecc repair
24
25
Consult the advisor
26
Before adding more components, ask ECC’s advisor which skills and profiles match your actual workflow:
27
# Get component recommendations from a natural language description
npx ecc consult "I need TypeScript code review" --target claude

# Scope recommendations to a specific domain
npx ecc consult "mlops training model deployment" --target claude
28
The advisor returns matching component IDs, related profiles, and the exact install command to run. Use --dry-run on the install command to preview the file plan without writing anything:
29
npx ecc install --profile minimal --target claude --with capability:machine-learning --dry-run
30
31
Run your first skill
32
Skills are the primary workflow surface in ECC. With the install complete, open your harness and invoke a skill directly.
33
In Claude Code (plugin install):
34
/ecc:plan "Add user authentication with OAuth"
35
In Claude Code (manual install):
36
/plan "Add user authentication with OAuth"
37
TDD workflow — chain skills for a complete feature cycle:
38
# Step 1: Plan the feature
/ecc:plan "Add rate limiting to the API"

# Step 2: Write tests first with the tdd-workflow skill
# Open the tdd-workflow skill and follow the Red-Green-Improve cycle

# Step 3: Review what was built
/code-review
39
Check which skills and agents are available:
40
# From Claude Code (plugin install)
/plugin list ecc@ecc

# From the CLI
npx ecc catalog profiles
npx ecc catalog components

​
What’s installed where

After a --target claude install, ECC places files in standard Claude Code locations:
ContentLocation
Rules~/.claude/rules/ecc/
Agents~/.claude/agents/
Skills~/.claude/skills/
Commands~/.claude/commands/
Hooks~/.claude/hooks/hooks.json
Platform config~/.claude/settings.json (merged, not overwritten)
ECC tracks every file it installs in a state store. Running npx ecc list-installed shows the full manifest.

​
Next steps

  • Add more modules — Run npx ecc install --modules hooks-runtime,security to layer in specific modules without changing your profile.
  • Upgrade — Run npx ecc auto-update to pull the latest ECC changes and reinstall managed targets.
  • Uninstall — Run npx ecc uninstall --dry-run to preview removal, then npx ecc uninstall to clean up all ECC-managed files.
  • Full installation reference — See Installation for all targets, profiles, module flags, and platform-specific notes.

Build docs developers (and LLMs) love

Get started for freeTalk to us