@slamb2k/mad-skills 2.0.46 → 2.0.48

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mad-skills",
   "description": "AI-assisted planning, development and governance tools",
-  "version": "2.0.46",
+  "version": "2.0.48",
   "author": {
     "name": "slamb2k",
     "url": "https://github.com/slamb2k"

package/hooks/lib/banner.cjs

@@ -13,7 +13,6 @@ const BANNER_LINES = [
   "::::: ##:.:: ##: ##.... ##: ##:::: ##::::'##::: ##: ##:. ##::: ##:: ##::::::: ##:::::::'##::: ##:::::::",
   "::::: ##:::: ##: ##:::: ##: ########:::::. ######:: ##::. ##:'####: ########: ########:. ######::::::::",
   "::::::..:::::..::..:::::..::........:::::::......:::..::::..::....::........::........:::......:::::::::",
-  '::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::',
 ];
 
 const SEPARATOR = '\u2500'.repeat(70);

package/hooks/lib/config.cjs

@@ -62,8 +62,5 @@ module.exports = {
         'Read', 'Glob', 'Grep', 'ToolSearch', 'Agent', 'WebSearch', 'WebFetch',
       ],
     },
-    hookify: {
-      rulePattern: /^hookify\..*\.local\.md$/,
-    },
   },
 };

package/hooks/lib/plugin-health.cjs

@@ -2,7 +2,6 @@
 
 const { join } = require('path');
 const { homedir } = require('os');
-const { readdirSync } = require('fs');
 const config = require('./config.cjs');
 const state = require('./state.cjs');
 const { readJson } = require('./utils.cjs');
@@ -11,7 +10,6 @@ const { readJson } = require('./utils.cjs');
  * Plugin Health — detect performance anti-patterns in companion plugins.
  *
  * Checks:
- *   - Hookify enabled with no rules (pure overhead)
  *   - claude-mem missing SKIP_TOOLS for read-only tools
  *   - claude-mem context injection too high (when OMC also active)
  *
@@ -27,38 +25,9 @@ function checkPluginHealth(projectDir, output) {
 
   const plugins = settings.enabledPlugins || {};
 
-  checkHookify(projectDir, plugins, output);
   checkClaudeMem(plugins, output);
 }
 
-// ─── hookify ──────────────────────────────────────────────────────────
-
-function checkHookify(projectDir, plugins, output) {
-  const hookifyKey = Object.keys(plugins).find(k => k.includes('hookify'));
-  if (!hookifyKey || plugins[hookifyKey] !== true) return; // Not enabled
-
-  // Count rule files in project .claude/ directory
-  let ruleCount = 0;
-  try {
-    const projectClaudeDir = join(projectDir, '.claude');
-    const files = readdirSync(projectClaudeDir);
-    ruleCount = files.filter(f => config.pluginHealth.hookify.rulePattern.test(f)).length;
-  } catch { /* directory doesn't exist — zero rules */ }
-
-  // Also check global .claude/ directory
-  try {
-    const globalClaudeDir = join(homedir(), '.claude');
-    const files = readdirSync(globalClaudeDir);
-    ruleCount += files.filter(f => config.pluginHealth.hookify.rulePattern.test(f)).length;
-  } catch { /* noop */ }
-
-  if (ruleCount === 0) {
-    output.signals.push(
-      '\u26A0 Hookify enabled but no rules configured \u2014 fires on every tool call for nothing. Run /brace or disable in settings',
-    );
-  }
-}
-
 // ─── claude-mem ───────────────────────────────────────────────────────
 
 function checkClaudeMem(plugins, output) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slamb2k/mad-skills",
-  "version": "2.0.46",
+  "version": "2.0.48",
   "description": "Claude Code skills collection — full lifecycle development tools",
   "type": "module",
   "repository": {

package/skills/brace/SKILL.md

@@ -102,7 +102,7 @@ For each row, in order:
 **Plugin detection:** For plugin dependencies (Type = plugin), check
 `~/.claude/settings.json` → `enabledPlugins` for a key containing the plugin
 name set to `true`. Store results as `PLUGIN_STATE` (`claude_mem_installed`,
-`omc_installed`, `hookify_installed`) for use in Phase 4 and Phase 7.
+`omc_installed`) for use in Phase 4 and Phase 7.
 
 1. Capture **FLAGS** from the user's request
 
@@ -170,16 +170,15 @@ Store result as `upgrade_legacy: true|false` in USER_CONFIG.
 
 4. Ask installation level via AskUserQuestion:
 
-   Question: "Where should global preferences and universal principles go?"
+   Question: "Install universal guidance (preferences, principles) at user level?"
    Options:
-   - "Both — global + project (Recommended)" → portable AND global coverage
-   - "Global (~/.claude/CLAUDE.md) only" → applies to all projects
-   - "Project level only" → self-contained, portable
+   - "Yes, install globally (Recommended)" — applies to all projects via `~/.claude/CLAUDE.md`
+   - "No, project level only" — self-contained in this project's CLAUDE.md
 
 5. Store as USER_CONFIG:
    - project_name: from directory name or user override
    - description: from user input
-   - install_level: "both" | "global" | "project"
+   - install_level: "global" | "project"
 
 **If cancelled, stop here.**
 
@@ -220,7 +219,7 @@ Will upgrade: {list of items with status "upgrade"}
 Will remove:  {list of items with status "remove" — legacy cleanup}
 Will clean:   {list of items with status "cleanup" — remove legacy references}
 Will skip:    {count} existing items
-Global config: {install_level description}
+Universal guidance: {install_level description}
 
 Proceed?
 ```
@@ -247,7 +246,7 @@ Before sending the prompt, substitute these variables:
 - `{ACTION_PLAN}` — the action plan from Phase 3
 - `{PROJECT_NAME}` — from USER_CONFIG
 - `{PROJECT_DESCRIPTION}` — from USER_CONFIG
-- `{INSTALL_LEVEL}` — from USER_CONFIG ("both", "global", or "project")
+- `{INSTALL_LEVEL}` — from USER_CONFIG ("global" or "project")
 - `{CLAUDE_MD_TEMPLATE}` — read from `references/claude-md-template.md`
   (the section between BEGIN TEMPLATE and END TEMPLATE)
 - `{GITIGNORE_CONTENT}` — read from `assets/gitignore-template`
@@ -334,10 +333,10 @@ This phase modifies user-level settings files (`~/.claude/settings.json`,
 If `--force` is set, apply all recommendations without prompting.
 
 **Plugin presence guards:** Only audit plugins detected as installed during
-pre-flight (`PLUGIN_STATE`). Skip H1/H2 if hookify is absent. Skip M1/M2/M3
-if claude-mem is absent. Skip M2 if OMC is absent (M2 requires both). The
-`{PLUGIN_ROLE_SEPARATION}` content in CLAUDE.md is only injected when both
-claude-mem and OMC are confirmed enabled.
+pre-flight (`PLUGIN_STATE`). Skip M1/M2/M3 if claude-mem is absent. Skip M2
+if OMC is absent (M2 requires both). The `{PLUGIN_ROLE_SEPARATION}` content
+in CLAUDE.md is only injected when both claude-mem and OMC are confirmed
+enabled.
 
 If no companion plugins are installed at all, output:
 ```
@@ -383,8 +382,6 @@ If "Let me choose", present individual findings as multi-select.
 
 | Code | Check | Condition | Severity |
 |------|-------|-----------|----------|
-| H1 | Hookify: no rules | enabled + zero `hookify.*.local.md` files | high |
-| H2 | Hookify: python3 broken | enabled + `python3 --version` fails | high |
 | M1 | claude-mem: read-only tools | SKIP_TOOLS missing Read/Glob/Grep/ToolSearch/Agent/WebSearch/WebFetch | medium |
 | M2 | claude-mem: high context | observations > 10 or sessions > 3, AND OMC also enabled | medium |
 | M3 | claude-mem: provider=claude | provider is "claude" (SDK spawn known-broken) | low |

package/skills/brace/assets/global-preferences-template.md

@@ -1,8 +1,11 @@
 # Global Preferences & Universal Principles
 
 Template appended to `~/.claude/CLAUDE.md` by brace when the user
-selects "global" or "both" installation level. The Phase 4 agent inserts
-this content before the "## Current Skills" section.
+selects "global" install level. When the user selects "project" level,
+this file is not used — instead, the universal principles are written
+to the project CLAUDE.md (with a redundancy check against global).
+The Phase 4 agent inserts this content before the "## Current Skills"
+section.
 
 ---
 

package/skills/brace/references/claude-md-template.md

@@ -4,9 +4,10 @@ Template for the generated project CLAUDE.md. The Phase 4 agent substitutes
 `{VARIABLE}` placeholders and writes to the project root.
 
 `{UNIVERSAL_PRINCIPLES}` is populated with the Question & Assumption
-Accountability and Communication sections when install_level is "project"
-or "both". Left empty when install_level is "global" (principles are in
-`~/.claude/CLAUDE.md` instead).
+Accountability section when install_level is "project" AND those sections
+are not already present in `~/.claude/CLAUDE.md`. Left empty when
+install_level is "global" (principles are in the global config instead)
+or when the sections would be redundant with existing global content.
 
 ---
 

package/skills/brace/references/phase-prompts.md

@@ -146,21 +146,31 @@ skills-based workflow while preserving all other content.
   This project uses claude-mem for persistent cross-session memory.
   ```
 
-### Global preferences (conditional)
+### Global preferences and universal principles
 
-If INSTALL_LEVEL is "global" or "both":
+**If INSTALL_LEVEL is "global":**
 - Read ~/.claude/CLAUDE.md
 - If it does NOT contain "## Global Preferences", insert the Global
   Preferences Content (below) immediately before "## Current Skills"
 - If it already contains "## Global Preferences", skip (idempotent)
-
-### {UNIVERSAL_PRINCIPLES} substitution
-
-If INSTALL_LEVEL is "project" or "both", substitute {UNIVERSAL_PRINCIPLES}
-in the CLAUDE.md template with the Universal Principles Content below.
-
-If INSTALL_LEVEL is "global", substitute {UNIVERSAL_PRINCIPLES} with an
-empty string (principles are in the global config instead).
+- Substitute {UNIVERSAL_PRINCIPLES} in the project CLAUDE.md template with
+  an empty string (principles are in the global config instead).
+
+**If INSTALL_LEVEL is "project":**
+- Do NOT modify ~/.claude/CLAUDE.md.
+- Before writing universal principles into the project CLAUDE.md, check
+  ~/.claude/CLAUDE.md for existing equivalent sections (redundancy guard):
+  - If global contains "## Global Preferences" → SKIP that section in
+    project CLAUDE.md. Add to SCAFFOLD_REPORT.skipped_redundant.
+  - If global contains "## Universal Operating Principles" → SKIP that
+    section in project CLAUDE.md. Add to SCAFFOLD_REPORT.skipped_redundant.
+- For any sections NOT found in global, substitute {UNIVERSAL_PRINCIPLES}
+  in the project CLAUDE.md template with only the non-redundant sections
+  from the Universal Principles Content below.
+- If ALL sections are redundant, substitute {UNIVERSAL_PRINCIPLES} with
+  an empty string.
+- Report each skipped section to the user:
+  "⏭️ Skipped {section} in project CLAUDE.md — already present in ~/.claude/CLAUDE.md"
 
 ### CLAUDE.md Template
 
@@ -206,6 +216,7 @@ SCAFFOLD_REPORT:
   cleaned: [list of files cleaned of legacy references]
   preserved_content: [any key decisions extracted from memory/MEMORY.md, or empty]
   skipped: [list of items skipped]
+  skipped_redundant: [sections skipped in project CLAUDE.md because already in global, or empty]
   global_updated: true|false|skipped
   errors: [any errors encountered]
 ```
@@ -286,39 +297,19 @@ Limit PLUGIN_REPORT to 30 lines maximum.
    node -e "
      const s = JSON.parse(require('fs').readFileSync('$HOME/.claude/settings.json','utf8'));
      const p = s.enabledPlugins || {};
-     const hookify = Object.keys(p).find(k => k.includes('hookify'));
      const mem = Object.keys(p).find(k => k.includes('claude-mem'));
      const omc = Object.keys(p).find(k => k.includes('oh-my-claudecode'));
-     console.log('hookify_installed:' + !!hookify);
-     console.log('hookify_enabled:' + (hookify && p[hookify] === true));
      console.log('claude_mem_installed:' + !!mem);
      console.log('claude_mem_enabled:' + (mem && p[mem] === true));
      console.log('omc_installed:' + !!omc);
      console.log('omc_enabled:' + (omc && p[omc] === true));
    "
-   Record: hookify_installed/enabled, claude_mem_installed/enabled, omc_installed/enabled
+   Record: claude_mem_installed/enabled, omc_installed/enabled
 
    If a plugin is not installed (not in enabledPlugins at all), skip its
    entire audit section below and report all its fields as "N/A".
 
-2. **Hookify audit** (only if hookify_enabled == true)
-   a. Check python3 availability:
-      python3 --version >/dev/null 2>&1 && echo "python3_available:true" || echo "python3_available:false"
-      Record: python3_available
-
-   b. Count hookify rule files:
-      RULE_COUNT=0
-      for f in "$HOME/.claude"/hookify.*.local.md .claude/hookify.*.local.md; do
-        [ -f "$f" ] && RULE_COUNT=$((RULE_COUNT + 1))
-      done
-      echo "hookify_rule_count:$RULE_COUNT"
-      Record: hookify_rule_count
-
-   c. Determine findings:
-      - If python3_available == false → finding H2
-      - If hookify_rule_count == 0 → finding H1
-
-3. **claude-mem audit** (only if claude_mem_enabled == true)
+2. **claude-mem audit** (only if claude_mem_enabled == true)
    MEM_SETTINGS="$HOME/.claude-mem/settings.json"
    if [ -f "$MEM_SETTINGS" ]; then
      node -e "
@@ -349,10 +340,6 @@ Limit PLUGIN_REPORT to 30 lines maximum.
 
 PLUGIN_REPORT:
   settings_file_found: true|false
-  hookify_installed: true|false
-  hookify_enabled: true|false
-  hookify_python3_available: true|false|N/A
-  hookify_rule_count: {number}|N/A
   claude_mem_installed: true|false
   claude_mem_enabled: true|false
   claude_mem_skip_tools: {current value}|N/A
@@ -363,5 +350,5 @@ PLUGIN_REPORT:
   claude_mem_has_openrouter_key: true|false|N/A
   omc_installed: true|false
   omc_enabled: true|false
-  findings: {comma-separated list of H1,H2,M1,M2,M3 or "none"}
+  findings: {comma-separated list of M1,M2,M3 or "none"}
 ```

package/skills/brace/references/plugin-tuning-steps.md

@@ -6,28 +6,6 @@ checks current value before modifying.
 
 ---
 
-## H1/H2: Disable Hookify
-
-Target: `~/.claude/settings.json`
-
-```bash
-node -e "
-  const fs = require('fs');
-  const p = require('os').homedir() + '/.claude/settings.json';
-  const s = JSON.parse(fs.readFileSync(p, 'utf8'));
-  const key = Object.keys(s.enabledPlugins || {}).find(k => k.includes('hookify'));
-  if (key && s.enabledPlugins[key] !== false) {
-    s.enabledPlugins[key] = false;
-    fs.writeFileSync(p, JSON.stringify(s, null, 2) + '\n');
-    console.log('Disabled hookify');
-  } else {
-    console.log('Hookify already disabled — skipped');
-  }
-"
-```
-
----
-
 ## M1: Add Read-Only Tools to SKIP_TOOLS
 
 Target: `~/.claude-mem/settings.json`

package/skills/brace/references/report-template.md

@@ -19,6 +19,7 @@ Present this summary after verification completes.
 │
 │  📄 Files
 │     {✅|⏭️} CLAUDE.md
+│     {✅|⏭️} ~/.claude/CLAUDE.md  {updated / already present / skipped (project-only)}
 │     {✅|⏭️} .gitignore
 │
 │  🗑️ Removed (only if legacy items were cleaned up)
@@ -27,7 +28,6 @@ Present this summary after verification completes.
 │     {✅} memory/           Legacy memory directory
 │
 │  🔌 Plugin Tuning (only if Phase 7 ran)
-│     {✅|⏭️} Hookify: {disabled / already disabled / not installed / skipped / N/A}
 │     {✅|⏭️} claude-mem SKIP_TOOLS: {optimised / already optimal / not installed / skipped / N/A}
 │     {✅|⏭️} claude-mem context: {reduced / already optimal / not installed / skipped / N/A}
 │     {✅|⏭️} claude-mem provider: {switched / already optimal / not installed / skipped / N/A}

package/skills/brace/references/scaffold-manifest.md

@@ -9,7 +9,7 @@ creation checklist. Phase 1 uses it to detect existing structure.
 |------|--------|-------------|
 | `CLAUDE.md` | references/claude-md-template.md | Project operating document |
 | `.gitignore` | assets/gitignore-template | Standard ignores |
-| `~/.claude/CLAUDE.md` | assets/global-preferences-template.md | Global preferences (conditional on install_level) |
+| `~/.claude/CLAUDE.md` | assets/global-preferences-template.md | Global preferences (when install_level is "global") |
 
 ## Project Directories
 

package/skills/manifest.json

@@ -1,12 +1,12 @@
 {
-  "generated": "2026-04-17T04:43:53.359Z",
+  "generated": "2026-04-17T05:36:15.739Z",
   "count": 10,
   "skills": [
     {
       "name": "brace",
       "directory": "brace",
       "description": "'Initialize any project directory with a standard scaffold for AI-assisted development. Creates specs/ and context/ directories, a project CLAUDE.md with development workflow and guardrails, .gitignore, and branch protection. Recommends claude-mem for persistent memory. Idempotent — safe to run on existing projects. Triggers: \"init project\", \"setup brace\", \"brace\", \"initialize\", \"bootstrap\", \"scaffold\".'",
-      "lines": 427,
+      "lines": 424,
       "hasScripts": false,
       "hasReferences": true,
       "hasAssets": true,