Skip to content

Commit 728431c

Browse files
fix: dead link to Packmind in ultimate-guide.md §3.5
../ecosystem/ from guide/ resolved outside the repo root. Fixed to ecosystem/third-party-tools.md#packmind. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 2c455d6 commit 728431c

File tree

2 files changed

+35
-1
lines changed

2 files changed

+35
-1
lines changed

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
66

77
## [Unreleased]
88

9+
- **Fix dead link** (`guide/ultimate-guide.md` §3.5): Packmind anchor `../ecosystem/third-party-tools.md#packmind` corrected to `ecosystem/third-party-tools.md#packmind` (wrong `../` prefix was resolving outside `guide/`).
10+
11+
- **Cheatsheet + reference.yaml maintenance**: date updated February → March 2026 in `guide/cheatsheet.md`; "Command not found" fix updated to use native installer (`curl | sh`); `machine-readable/reference.yaml` `updated` field bumped to 2026-03-17.
12+
913
- **Whitepapers v2 — Reviewer corrections** (6 relecteurs: Edouard, Mat, Nicolas, Marc, Anthony, Emmanuel): 8-phase correction plan applied across 10 whitepapers (WP00–WP10) FR+EN.
1014
- **Phase 1 — Factual errors**: npm "deprecated" → "not recommended" (WP00), native installer added as primary install method (WP00 EN), context window 200K vs 1M clarified (WP00 FR+EN), Claude Max ratio corrected to range 1.5-3% FR / 1-1.6% EN (WP10), sub-agents vs agent teams difference correctly stated as P2P messaging + coordination tools, not context isolation (WP08 EN)
1115
- **Phase 2 — Accents + articles + typos**: ~200+ accent corrections across WP08 FR (977 lines); anglicisms corrected in WP02 FR (on-demand, per-project, Memories, Feature opt-in); table row reformulated in WP00 FR; accents restored in WP02 FR (~10 passages)

guide/ultimate-guide.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6116,7 +6116,7 @@ The default instinct with AI tools is caution — reviewing every output, second
61166116

61176117
Profile-Based Module Assembly solves the per-developer consistency problem. It still requires your team to maintain the modules manually and run the assembler. At 50+ developers across 30+ repositories, even that becomes friction.
61186118

6119-
Tools like [Packmind](../ecosystem/third-party-tools.md#packmind) take the same principle further: define standards once in a central playbook, and distribute them automatically as `CLAUDE.md` files, slash commands, and skills — across repositories and across AI tools (Claude Code, Cursor, Copilot, Windsurf). The playbook can also ingest knowledge from PR review comments, Slack discussions, and incident reports to keep standards current without manual maintenance.
6119+
Tools like [Packmind](ecosystem/third-party-tools.md#packmind) take the same principle further: define standards once in a central playbook, and distribute them automatically as `CLAUDE.md` files, slash commands, and skills — across repositories and across AI tools (Claude Code, Cursor, Copilot, Windsurf). The playbook can also ingest knowledge from PR review comments, Slack discussions, and incident reports to keep standards current without manual maintenance.
61206120

61216121
> **When to consider this**: Teams of 10+ developers, 5+ repositories, using more than one AI coding agent.
61226122

@@ -9131,6 +9131,32 @@ Hooks communicate results through exit codes and optional JSON on stdout. Choose
91319131
| `2` | Blocking error | Prevent operation (for blocking events), stderr fed to Claude |
91329132
| Other | Non-blocking error | Stderr shown in verbose mode (`Ctrl+O`), execution continues |
91339133

9134+
### Silent Success Pattern
9135+
9136+
A key principle for keeping the agent's context clean: **hooks should be silent on success and verbose on failure only.**
9137+
9138+
```bash
9139+
#!/bin/bash
9140+
# .claude/hooks/build-check.sh — Silent Success pattern
9141+
# On success: completely silent (nothing enters agent context)
9142+
# On failure: surface errors + exit 2 to re-engage agent
9143+
9144+
OUTPUT=$(bun run build 2>&1)
9145+
EXIT_CODE=$?
9146+
9147+
if [[ $EXIT_CODE -eq 0 ]]; then
9148+
exit 0 # Silent — no output, no context noise
9149+
fi
9150+
9151+
# Failure: send errors to agent for correction
9152+
echo "$OUTPUT" >&2
9153+
exit 2
9154+
```
9155+
9156+
This asymmetry (silence on success, signal on failure) prevents successful build logs, test output, and lint reports from accumulating as "context noise" in long sessions. The agent only sees what requires action.
9157+
9158+
> Source: Pattern formalized by [HumanLayer — Harness Engineering for Coding Agents](https://www.humanlayer.dev/blog/skill-issue-harness-engineering-for-coding-agents) (March 2026). Also validated by RTK's design philosophy: suppress successful command output, surface errors only.
9159+
91349160
## 7.3 Hook Templates
91359161

91369162
### Template 1: PreToolUse (Security Blocker)
@@ -12089,6 +12115,10 @@ Model accuracy on tool-selection tasks (measured on Opus 4): 49% → 74% (+25 po
1208912115

1209012116
**Practical implication**: you can now connect dozens of MCP servers without the "too many tools" accuracy penalty. The advice to keep global config minimal still applies for unrelated tools, but MCP Tool Search changes the calculus for large project-specific sets.
1209112117

12118+
**CLI vs MCP — when a shell command beats a server**: Familiar CLI tools (git, grep, jq, curl) are already deeply embedded in Claude's training data. A few usage examples in CLAUDE.md are often more effective than an equivalent MCP server, because the model already knows the tool's behavior, flags, and output format. An MCP server adds tool schema overhead and introduces an unfamiliar interface. Default to CLIs for standard tools; use MCP servers for proprietary systems or APIs the model has no training context for.
12119+
12120+
> Source: [HumanLayer — Harness Engineering for Coding Agents](https://www.humanlayer.dev/blog/skill-issue-harness-engineering-for-coding-agents) (March 2026)
12121+
1209212122
### CLI-Based MCP Configuration
1209312123

1209412124
**Quick setup with environment variables**:

0 commit comments

Comments
 (0)