Skip to main content

Migrating to v1.7.0

Breaking Changes

None. v1.7.0 is fully backward compatible with v1.6.0.

New Features to Adopt

1. Codex Support

If using OpenAI Codex CLI:

2. Frontend Slides Skill

New zero-dependency HTML presentation builder:
Use for:
  • Creating slide decks without external tools
  • PPTX-to-web conversion workflows
  • Visual style exploration

3. New Business Skills

Five new cross-functional skills:

Migrating to v1.6.0

Breaking Changes

None. v1.6.0 is fully backward compatible with v1.4.1.

New Features to Adopt

1. AgentShield Integration

Run security scans:

2. GitHub Marketplace App

Install the GitHub App for automated skill creation: github.com/marketplace/ecc-tools

3. New Skills

Seven new skills added:

Migrating to v1.4.1

Bug Fix

Fixed: Instinct import content loss in /instinct-import. If you imported instincts before v1.4.1:
  1. Re-import from original source
  2. Verify Action, Evidence, and Examples sections are present

Migrating to v1.4.0

Breaking Changes: Multi-Language Rules

Rules were restructured from flat files to common/ + language-specific directories. Before v1.4.0:
After v1.4.0:

Migration Steps

1. Backup Existing Rules

2. Remove Old Rules

3. Install New Structure

4. Verify Installation

Migrating from Other Configs

From Cursor IDE

If migrating from Cursor to Claude Code:

1. Convert Rules

Cursor rules use .cursorrules format. Convert to Claude Code:
Then manually restructure:
  • Extract general guidelines → ~/.claude/rules/coding-style.md
  • Extract testing rules → ~/.claude/rules/testing.md
  • Extract project-specific → .claude/CLAUDE.md

2. Convert Hooks

Cursor hooks are in .cursor/hooks/. Claude Code uses hooks/hooks.json: Cursor hook:
Claude Code hook:

From OpenCode

If migrating from OpenCode:

1. Convert Instructions to Rules

OpenCode uses .opencode/instructions/. Convert to rules:

2. Convert Plugin Hooks

OpenCode plugins use onToolExecute. Claude Code uses PreToolUse/PostToolUse: OpenCode:
Claude Code:

From Vanilla Claude Code

If migrating from basic Claude Code setup:

1. Install ECC Plugin

2. Keep Existing Agents

ECC agents supplement yours. Keep both:

3. Merge Rules

If you have custom rules, merge with ECC rules:

Version Compatibility Matrix

Rollback Procedures

Rollback to Previous ECC Version

Restore Backup

Getting Help

If migration issues occur:
  1. Check Troubleshooting
  2. Search GitHub Issues
  3. Open a new issue with:
    • Current ECC version
    • Target ECC version
    • Error messages
    • Migration steps attempted