The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
fix: preserve directory structure in installation to prevent file overwrites (#169)
Mark L33186f1a9312
diff --git a/install.sh b/install.shnew file mode 100755index 000000000..20fbf4802--- /dev/null+++ b/install.sh@@ -0,0 +1,51 @@+#!/usr/bin/env bash+# install.sh — Install claude rules while preserving directory structure.+#+# Usage:+# ./install.sh <language> [<language> ...]+#+# Examples:+# ./install.sh typescript+# ./install.sh typescript python golang+#+# This script copies rules into ~/.claude/rules/ keeping the common/ and+# language-specific subdirectories intact so that:+# 1. Files with the same name in common/ and <language>/ don't overwrite+# each other.+# 2. Relative references (e.g. ../common/coding-style.md) remain valid.++set -euo pipefail++RULES_DIR="$(cd "$(dirname "$0")/rules" && pwd)"+DEST_DIR="${CLAUDE_RULES_DIR:-$HOME/.claude/rules}"++if [[ $# -eq 0 ]]; then+ echo "Usage: $0 <language> [<language> ...]"+ echo ""+ echo "Available languages:"+ for dir in "$RULES_DIR"/*/; do+ name="$(basename "$dir")"+ [[ "$name" == "common" ]] && continue+ echo " - $name"+ done+ exit 1+fi++# Always install common rules+echo "Installing common rules -> $DEST_DIR/common/"+mkdir -p "$DEST_DIR/common"+cp -r "$RULES_DIR/common/." "$DEST_DIR/common/"++# Install each requested language+for lang in "$@"; do+ lang_dir="$RULES_DIR/$lang"+ if [[ ! -d "$lang_dir" ]]; then+ echo "Warning: rules/$lang/ does not exist, skipping." >&2+ continue+ fi+ echo "Installing $lang rules -> $DEST_DIR/$lang/"+ mkdir -p "$DEST_DIR/$lang"+ cp -r "$lang_dir/." "$DEST_DIR/$lang/"+done++echo "Done. Rules installed to $DEST_DIR/"diff --git a/rules/README.md b/rules/README.mdindex 3153d6008..57de9d382 100644--- a/rules/README.md+++ b/rules/README.md@@ -25,17 +25,36 @@ rules/## Installation+### Option 1: Install Script (Recommended)++```bash+# Install common + one or more language-specific rule sets+./install.sh typescript+./install.sh python+./install.sh golang++# Install multiple languages at once+./install.sh typescript python+```++### Option 2: Manual Installation++> **Important:** Copy entire directories — do NOT flatten with `/*`.+> Common and language-specific directories contain files with the same names.+> Flattening them into one directory causes language-specific files to overwrite+> common rules, and breaks the relative `../common/` references used by+> language-specific files.+```bash# Install common rules (required for all projects)-cp -r rules/common/* ~/.claude/rules/+cp -r rules/common ~/.claude/rules/common# Install language-specific rules based on your project's tech stack-cp -r rules/typescript/* ~/.claude/rules/-cp -r rules/python/* ~/.claude/rules/-cp -r rules/golang/* ~/.claude/rules/+cp -r rules/typescript ~/.claude/rules/typescript+cp -r rules/python ~/.claude/rules/python+cp -r rules/golang ~/.claude/rules/golang# Attention ! ! ! Configure according to your actual project requirements; the configuration here is for reference only.-```## Rules vs Skills