docs: fix lint warnings and clean up references
- Fix MD060 table separator spacing across all docs - Fix MD031/MD032 blank lines around code fences and lists - Fix MD029 ordered list numbering in ecc-setup-guide - Genericize hardcoded app names (LedGrab/MediaServer → YourApp) - Remove non-existent `claude skill install` CLI command - Add staleness warning for ECC Windows fixes - Add cross-link from windows-code-signing to gitea-python-ci-cd
This commit is contained in:
+24
-7
@@ -2,6 +2,8 @@
|
||||
|
||||
Step-by-step instructions for setting up ECC on a new machine. Can be followed manually or by Claude.
|
||||
|
||||
> **Staleness warning:** The Windows-specific fixes (gotchas 6–8) were documented against ECC as of early 2026. These bugs may have been fixed upstream — check the [ECC repository](https://github.com/affaan-m/everything-claude-code) for recent changes before applying the workarounds.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Node.js + npm installed
|
||||
@@ -12,6 +14,7 @@ Step-by-step instructions for setting up ECC on a new machine. Can be followed m
|
||||
## Step 1 — Clone and install
|
||||
|
||||
**Windows (PowerShell):**
|
||||
|
||||
```powershell
|
||||
git clone https://github.com/affaan-m/everything-claude-code.git C:\Users\<USERNAME>\everything-claude-code
|
||||
cd C:\Users\<USERNAME>\everything-claude-code
|
||||
@@ -19,6 +22,7 @@ npm install
|
||||
```
|
||||
|
||||
**macOS/Linux (Bash):**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/affaan-m/everything-claude-code.git ~/everything-claude-code
|
||||
cd ~/everything-claude-code
|
||||
@@ -30,18 +34,21 @@ npm install
|
||||
Run the installer **from inside the cloned repo**.
|
||||
|
||||
**Windows (PowerShell):**
|
||||
|
||||
```powershell
|
||||
.\install.ps1 <languages>
|
||||
# Example: .\install.ps1 python typescript
|
||||
```
|
||||
|
||||
**macOS/Linux (Bash):**
|
||||
|
||||
```bash
|
||||
./install.sh <languages>
|
||||
# Example: ./install.sh python typescript
|
||||
```
|
||||
|
||||
**Cross-platform (npm):**
|
||||
|
||||
```bash
|
||||
npx ecc-install <languages>
|
||||
```
|
||||
@@ -55,7 +62,7 @@ Available languages: `python`, `typescript`, `golang`, `swift`, `php`, `rust`, `
|
||||
All files go to `~/.claude/` (global, applies to all projects):
|
||||
|
||||
| Category | Location | Examples |
|
||||
|----------|----------|---------|
|
||||
| ---------- | ---------- | --------- |
|
||||
| Rules | `~/.claude/rules/` | coding-style, testing, security (per language) |
|
||||
| Agents | `~/.claude/agents/` | planner, architect, code-reviewer, tdd-guide, security-reviewer |
|
||||
| Skills | `~/.claude/skills/` | python-patterns, tdd-workflow, e2e-testing, continuous-learning |
|
||||
@@ -67,14 +74,18 @@ All files go to `~/.claude/` (global, applies to all projects):
|
||||
Some agents (planner, architect) ship with only `Read, Grep, Glob` tools. To enable `ast-index` and other CLI tools, add `Bash` to their tool lists.
|
||||
|
||||
Edit these files in `~/.claude/agents/`:
|
||||
|
||||
- `planner.md`
|
||||
- `architect.md`
|
||||
|
||||
Change the frontmatter `tools` line from:
|
||||
|
||||
```yaml
|
||||
tools: ["Read", "Grep", "Glob"]
|
||||
```
|
||||
|
||||
To:
|
||||
|
||||
```yaml
|
||||
tools: ["Read", "Grep", "Glob", "Bash"]
|
||||
```
|
||||
@@ -131,7 +142,7 @@ Hooks and new agents only take effect after restarting Claude Code.
|
||||
Run these commands inside Claude Code to verify:
|
||||
|
||||
| Command | Expected result |
|
||||
|---------|----------------|
|
||||
| --------- | ---------------- |
|
||||
| `/plan "test"` | Should invoke the planner agent |
|
||||
| `/instinct-status` | Should show instinct status (empty on first run) |
|
||||
| `/code-review` | Should invoke the code-reviewer agent |
|
||||
@@ -139,7 +150,7 @@ Run these commands inside Claude Code to verify:
|
||||
## Useful commands
|
||||
|
||||
| Command | Purpose |
|
||||
|---------|---------|
|
||||
| --------- | --------- |
|
||||
| `/plan` | Create implementation plan before coding |
|
||||
| `/tdd` | Test-driven development workflow |
|
||||
| `/code-review` | Review code for quality issues |
|
||||
@@ -166,11 +177,11 @@ Run these commands inside Claude Code to verify:
|
||||
|
||||
The observe hook ships with three bugs that silently prevent all observations on Windows:
|
||||
|
||||
6. **`python3` is the Windows Store stub** — On Windows, `python3` resolves to the Microsoft Store redirect (`AppData/Local/Microsoft/WindowsApps/python3`) which returns exit code 49 instead of running Python. The hook's `resolve_python_cmd()` uses `command -v` which finds the stub. **Fix:** In both `~/.claude/skills/continuous-learning-v2/hooks/observe.sh` and `~/.claude/skills/continuous-learning-v2/scripts/detect-project.sh`, change `resolve_python_cmd()` to test execution (`"$candidate" -c "1"`) instead of just checking presence (`command -v`).
|
||||
1. **`python3` is the Windows Store stub** — On Windows, `python3` resolves to the Microsoft Store redirect (`AppData/Local/Microsoft/WindowsApps/python3`) which returns exit code 49 instead of running Python. The hook's `resolve_python_cmd()` uses `command -v` which finds the stub. **Fix:** In both `~/.claude/skills/continuous-learning-v2/hooks/observe.sh` and `~/.claude/skills/continuous-learning-v2/scripts/detect-project.sh`, change `resolve_python_cmd()` to test execution (`"$candidate" -c "1"`) instead of just checking presence (`command -v`).
|
||||
|
||||
7. **`claude-vscode` entrypoint rejected** — The hook's Layer 1 filter only allows `cli` and `sdk-ts` entrypoints. VS Code extension sets `CLAUDE_CODE_ENTRYPOINT=claude-vscode`, so every observation is silently skipped. **Fix:** Add `claude-vscode` to the allowed entrypoints case pattern in `observe.sh`.
|
||||
2. **`claude-vscode` entrypoint rejected** — The hook's Layer 1 filter only allows `cli` and `sdk-ts` entrypoints. VS Code extension sets `CLAUDE_CODE_ENTRYPOINT=claude-vscode`, so every observation is silently skipped. **Fix:** Add `claude-vscode` to the allowed entrypoints case pattern in `observe.sh`.
|
||||
|
||||
8. **Observer disabled by default** — `~/.claude/skills/continuous-learning-v2/config.json` ships with `"enabled": false`. **Fix:** Set `"enabled": true`.
|
||||
3. **Observer disabled by default** — `~/.claude/skills/continuous-learning-v2/config.json` ships with `"enabled": false`. **Fix:** Set `"enabled": true`.
|
||||
|
||||
## Step 6 — Configure agent model tiers
|
||||
|
||||
@@ -179,12 +190,13 @@ ECC agents ship with `sonnet` as default. For better results, set thinking-heavy
|
||||
Edit the `model:` line in each agent's frontmatter in `~/.claude/agents/`:
|
||||
|
||||
| Model | Agents | Rationale |
|
||||
|-------|--------|-----------|
|
||||
| ------- | -------- | ----------- |
|
||||
| **opus** | code-reviewer, python-reviewer, typescript-reviewer, rust-reviewer, go-reviewer, java-reviewer, kotlin-reviewer, cpp-reviewer, flutter-reviewer, database-reviewer, security-reviewer, tdd-guide, planner, architect, chief-of-staff | Deep reasoning for code quality, security, architecture |
|
||||
| **sonnet** | build-error-resolver, cpp-build-resolver, go-build-resolver, java-build-resolver, kotlin-build-resolver, rust-build-resolver, pytorch-build-resolver, e2e-runner, harness-optimizer, loop-operator, docs-lookup, refactor-cleaner | Mechanical tasks, error fixing |
|
||||
| **haiku** | doc-updater | Lightweight docs work |
|
||||
|
||||
To bulk-update reviewers and thinking-heavy agents to opus:
|
||||
|
||||
```bash
|
||||
# From bash/git bash:
|
||||
for f in ~/.claude/agents/{code,python,typescript,rust,go,java,kotlin,cpp,flutter,database,security}-reviewer.md ~/.claude/agents/tdd-guide.md; do
|
||||
@@ -201,6 +213,7 @@ The installer overwrites all files in `~/.claude/`, so updating is straightforwa
|
||||
**1. Pull the latest version:**
|
||||
|
||||
**Windows (PowerShell):**
|
||||
|
||||
```powershell
|
||||
cd C:\Users\<USERNAME>\everything-claude-code
|
||||
git pull
|
||||
@@ -208,6 +221,7 @@ npm install
|
||||
```
|
||||
|
||||
**macOS/Linux (Bash):**
|
||||
|
||||
```bash
|
||||
cd ~/everything-claude-code
|
||||
git pull
|
||||
@@ -215,6 +229,7 @@ npm install
|
||||
```
|
||||
|
||||
**2. Back up your customizations:**
|
||||
|
||||
```bash
|
||||
# Save agent model overrides
|
||||
grep -l 'model: opus' ~/.claude/agents/*.md > /tmp/ecc-opus-agents.txt
|
||||
@@ -228,11 +243,13 @@ cp ~/.claude/skills/continuous-learning-v2/config.json /tmp/cl-config.json.bak
|
||||
**3. Re-run the installer:**
|
||||
|
||||
**Windows (PowerShell):**
|
||||
|
||||
```powershell
|
||||
.\install.ps1 python typescript
|
||||
```
|
||||
|
||||
**macOS/Linux (Bash):**
|
||||
|
||||
```bash
|
||||
./install.sh python typescript
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user