mirror of
https://github.com/affaan-m/ECC.git
synced 2026-10-14 12:15:29 +02:00
Affaan MustafaandGitHub
c05b2d6614
* chore: retire the Everything Claude Code name, ECC only Replace the expanded product name and the everything-claude-code slug with ECC across READMEs, translated docs, harness folders, skills, commands, scripts and examples. Repo URLs now point at affaan-m/ECC. Rename repo-internal artifacts to ecc forms (ecc-conventions skill, ecc-guardrails, ecc-research-playbook, ecc-team-config, ecc-instincts with ecc-* ids) and update .claude/ecc-tools.json. Legacy install ids, plugin dirs, package names and MCP prefixes stay where existing installs resolve against them. The codex global-state check and harness-audit repo detection accept the new name first and the legacy one as a fallback. The Discord bot prefers ~/GitHub/ECC and falls back to the nested legacy checkout path. Refresh the skill-triggers registryDigest for the changed skill text. * fix(ecc-tools): drop managed paths to the removed Claude repo skill .claude/skills/<repo-skill>/SKILL.md was deleted in #2770 but stayed listed in ecc-tools.json and the team config. Remove those entries and point the Claude Code adapter at the existing .agents/skills/ecc-conventions/SKILL.md.
75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
# Hook Bug Workarounds
|
|
|
|
Community-tested workarounds for current Claude Code bugs that can affect ECC hook-heavy setups.
|
|
|
|
This page is intentionally narrow: it collects the highest-signal operational fixes from the longer troubleshooting surface without repeating speculative or unsupported configuration advice. These are upstream Claude Code behaviors, not ECC bugs.
|
|
|
|
## When To Use This Page
|
|
|
|
Use this page when you are specifically debugging:
|
|
|
|
- false `Hook Error` labels on otherwise successful hook runs
|
|
- earlier-than-expected compaction
|
|
- MCP connectors that look authenticated but fail after compaction
|
|
- hook edits that do not hot-reload
|
|
- repeated `529 Overloaded` responses under heavy hook/tool pressure
|
|
|
|
For the fuller ECC troubleshooting surface, use [TROUBLESHOOTING.md](./TROUBLESHOOTING.md).
|
|
|
|
## High-Signal Workarounds
|
|
|
|
### False `Hook Error` labels
|
|
|
|
What helps:
|
|
|
|
- Consume stdin at the start of shell hooks (`input=$(cat)`).
|
|
- Keep stdout quiet for simple allow/block hooks unless your hook explicitly requires structured stdout.
|
|
- Send human-readable diagnostics to stderr.
|
|
- Use the correct exit codes: `0` allow, `2` block, other non-zero values are treated as errors.
|
|
|
|
```bash
|
|
input=$(cat)
|
|
echo "[BLOCKED] Reason here" >&2
|
|
exit 2
|
|
```
|
|
|
|
### Earlier-than-expected compaction
|
|
|
|
What helps:
|
|
|
|
- Remove `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` if lowering it causes earlier compaction in your build.
|
|
- Prefer manual `/compact` at natural task boundaries.
|
|
- Use ECC's `strategic-compact` guidance instead of forcing a lower threshold.
|
|
|
|
### MCP auth looks live but fails after compaction
|
|
|
|
What helps:
|
|
|
|
- Toggle the affected connector off and back on after compaction.
|
|
- If your Claude Code build supports it, add a lightweight `PostCompact` reminder hook that tells you to re-check connector auth.
|
|
- Treat this as a recovery reminder, not a permanent fix.
|
|
|
|
### Hook edits do not hot-reload
|
|
|
|
What helps:
|
|
|
|
- Restart the Claude Code session after changing hooks.
|
|
- Advanced users sometimes use shell-local reload helpers, but ECC does not ship one because those approaches are shell- and platform-dependent.
|
|
|
|
### Repeated `529 Overloaded`
|
|
|
|
What helps:
|
|
|
|
- Reduce tool-definition pressure with `ENABLE_TOOL_SEARCH=auto:5` if your setup supports it.
|
|
- Lower `MAX_THINKING_TOKENS` for routine work.
|
|
- Route subagent work to a cheaper model such as `CLAUDE_CODE_SUBAGENT_MODEL=haiku` if your setup exposes that knob.
|
|
- Disable unused MCP servers per project.
|
|
- Compact manually at natural breakpoints instead of waiting for auto-compaction.
|
|
|
|
## Related ECC Docs
|
|
|
|
- [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)
|
|
- [token-optimization.md](./token-optimization.md)
|
|
- [hooks/README.md](../hooks/README.md)
|
|
- [issue #644](https://github.com/affaan-m/ECC/issues/644)
|