The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
fix: add no-hooks minimal install path
Affaan Mustafa5881554a1ccf
diff --git a/README.md b/README.mdindex d1d3b778f..0d4f6df1b 100644--- a/README.md+++ b/README.md@@ -179,6 +179,34 @@ Most Claude Code users should use exactly one install path:If you already layered multiple installs and things look duplicated, skip straight to [Reset / Uninstall ECC](#reset--uninstall-ecc).+### Low-context / no-hooks path++If hooks feel too global or you only want ECC's rules, agents, commands, and core workflow skills, skip the plugin and use the minimal manual profile:++```bash+./install.sh --profile minimal --target claude+```++```powershell+.\install.ps1 --profile minimal --target claude+# or+npx ecc-install --profile minimal --target claude+```++This profile intentionally excludes `hooks-runtime`.++If you want the normal core profile but need hooks off, use:++```bash+./install.sh --profile core --without baseline:hooks --target claude+```++Add hooks later only if you want runtime enforcement:++```bash+./install.sh --target claude --modules hooks-runtime+```+### Step 1: Install the Plugin (Recommended)> NOTE: The plugin is convenient, but the OSS installer below is still the most reliable path if your Claude Code build has trouble resolving self-hosted marketplace entries.diff --git a/manifests/install-profiles.json b/manifests/install-profiles.jsonindex c35bb0dbe..d82cf4ed4 100644--- a/manifests/install-profiles.json+++ b/manifests/install-profiles.json@@ -1,6 +1,16 @@{"version": 1,"profiles": {+ "minimal": {+ "description": "Low-context Claude Code setup with rules, agents, commands, platform configs, and quality workflow support, but no hook runtime.",+ "modules": [+ "rules-core",+ "agents-core",+ "commands-core",+ "platform-configs",+ "workflow-quality"+ ]+ },"core": {"description": "Minimal harness baseline with commands, hooks, platform configs, and quality workflow support.","modules": [diff --git a/tests/lib/install-manifests.test.js b/tests/lib/install-manifests.test.jsindex 10c97ad1e..b987ab1cf 100644--- a/tests/lib/install-manifests.test.js+++ b/tests/lib/install-manifests.test.js@@ -79,6 +79,7 @@ function runTests() {if (test('lists install profiles from the real project', () => {const profiles = listInstallProfiles();+ assert.ok(profiles.some(profile => profile.id === 'minimal'), 'Should include minimal profile');assert.ok(profiles.some(profile => profile.id === 'core'), 'Should include core profile');assert.ok(profiles.some(profile => profile.id === 'full'), 'Should include full profile');})) passed++; else failed++;@@ -212,6 +213,22 @@ function runTests() {assert.strictEqual(plan.targetRoot, path.join(projectRoot, '.agent'));})) passed++; else failed++;+ if (test('resolves minimal profile without the hook runtime', () => {+ const plan = resolveInstallPlan({+ profileId: 'minimal',+ target: 'claude',+ projectRoot: '/workspace/app',+ });++ assert.deepStrictEqual(+ plan.selectedModuleIds,+ ['rules-core', 'agents-core', 'commands-core', 'platform-configs', 'workflow-quality']+ );+ assert.ok(!plan.selectedModuleIds.includes('hooks-runtime'),+ 'minimal profile should not install hooks-runtime');+ assert.ok(plan.operations.length > 0, 'Should include install operations');+ })) passed++; else failed++;+if (test('resolves explicit modules with dependency expansion', () => {const plan = resolveInstallPlan({ moduleIds: ['security'] });assert.ok(plan.selectedModuleIds.includes('security'), 'Should include requested module');diff --git a/tests/scripts/install-apply.test.js b/tests/scripts/install-apply.test.jsindex 3c2a7fda8..63fde637b 100644--- a/tests/scripts/install-apply.test.js+++ b/tests/scripts/install-apply.test.js@@ -271,6 +271,24 @@ function runTests() {}})) passed++; else failed++;+ if (test('supports minimal profile dry-runs without hooks through the installer', () => {+ const homeDir = createTempDir('install-apply-home-');+ const projectDir = createTempDir('install-apply-project-');++ try {+ const result = run(['--profile', 'minimal', '--dry-run'], { cwd: projectDir, homeDir });+ assert.strictEqual(result.code, 0, result.stderr);+ assert.ok(result.stdout.includes('Mode: manifest'));+ assert.ok(result.stdout.includes('Profile: minimal'));+ assert.ok(result.stdout.includes('Selected modules: rules-core, agents-core, commands-core, platform-configs, workflow-quality'));+ assert.ok(!result.stdout.includes('hooks-runtime'));+ assert.ok(!fs.existsSync(path.join(homeDir, '.claude', 'ecc', 'install-state.json')));+ } finally {+ cleanup(homeDir);+ cleanup(projectDir);+ }+ })) passed++; else failed++;+if (test('installs manifest profiles and writes non-legacy install-state', () => {const homeDir = createTempDir('install-apply-home-');const projectDir = createTempDir('install-apply-project-');diff --git a/tests/scripts/install-readme-clarity.test.js b/tests/scripts/install-readme-clarity.test.jsindex a6029edaa..a1946ef0a 100644--- a/tests/scripts/install-readme-clarity.test.js+++ b/tests/scripts/install-readme-clarity.test.js@@ -70,6 +70,29 @@ function runTests() {);})) passed++; else failed++;+ if (test('README documents low-context no-hooks install path', () => {+ assert.ok(+ readme.includes('### Low-context / no-hooks path'),+ 'README should surface a low-context no-hooks install option near Quick Start'+ );+ assert.ok(+ readme.includes('./install.sh --profile minimal --target claude'),+ 'README should document the shell minimal profile command'+ );+ assert.ok(+ readme.includes('npx ecc-install --profile minimal --target claude'),+ 'README should document the npx minimal profile command'+ );+ assert.ok(+ readme.includes('--profile core --without baseline:hooks --target claude'),+ 'README should document the hook opt-out path for the core profile'+ );+ assert.ok(+ readme.includes('This profile intentionally excludes `hooks-runtime`.'),+ 'README should state that the minimal profile excludes hooks'+ );+ })) passed++; else failed++;+if (test('README explains plugin-path cleanup and rules scoping', () => {assert.ok(readme.includes('remove the plugin from Claude Code'),