@softspark/ai-toolkit 1.3.7 → 1.3.8

package/CHANGELOG.md

@@ -7,6 +7,14 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.3.8 — Language Rules as References (2026-04-07)
+
+### Changed
+- **Language rules injection**: Instead of inlining full rule content (~705 lines), `install --local` now injects lightweight reference pointers (~12 lines) with absolute paths to rule files. Claude reads them on demand via Read tool, keeping CLAUDE.md compact.
+- **plugin.json**: Version synced from stale 1.2.1 to 1.3.8.
+
+---
+
 ## v1.3.7 — Update Notifications (2026-04-07)
 
 ### Added

package/app/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-toolkit",
   "description": "Professional-grade Claude Code toolkit: 90 skills, 44 agents, persona presets, skill security auditor, expanded lifecycle hooks, experimental opt-in plugin packs, benchmark harvesting, and multi-tool support.",
-  "version": "1.2.1",
+  "version": "1.3.8",
   "author": {
     "name": "SoftSpark",
     "url": "https://github.com/softspark"

package/kb/reference/extension-api.md

@@ -3,7 +3,7 @@ title: "Extension API Reference"
 category: reference
 service: ai-toolkit
 tags: [extension-api, inject-rule, inject-hook, mcp-templates, integration]
-version: "1.3.0"
+version: "1.3.8"
 created: "2026-04-07"
 last_updated: "2026-04-07"
 description: "Reference for ai-toolkit's extension API: inject-rule, inject-hook, remove-rule, remove-hook, and mcp template management."

package/kb/reference/skills-catalog.md

@@ -3,7 +3,7 @@ title: "AI Toolkit - Skills Catalog"
 category: reference
 service: ai-toolkit
 tags: [skills, domain-knowledge, catalog, task-skills, hybrid-skills]
-version: "1.3.3"
+version: "1.3.8"
 created: "2026-03-23"
 last_updated: "2026-04-07"
 description: "Complete catalog of 90 skills: 28 task, 30 hybrid, 32 knowledge. Includes effort levels, skill-scoped hooks, executable scripts, security auditor, and persona presets."

package/llms-full.txt

@@ -2276,7 +2276,7 @@ title: "Extension API Reference"
 category: reference
 service: ai-toolkit
 tags: [extension-api, inject-rule, inject-hook, mcp-templates, integration]
-version: "1.3.0"
+version: "1.3.8"
 created: "2026-04-07"
 last_updated: "2026-04-07"
 description: "Reference for ai-toolkit's extension API: inject-rule, inject-hook, remove-rule, remove-hook, and mcp template management."
@@ -4067,7 +4067,7 @@ title: "AI Toolkit - Skills Catalog"
 category: reference
 service: ai-toolkit
 tags: [skills, domain-knowledge, catalog, task-skills, hybrid-skills]
-version: "1.3.3"
+version: "1.3.8"
 created: "2026-03-23"
 last_updated: "2026-04-07"
 description: "Complete catalog of 90 skills: 28 task, 30 hybrid, 32 knowledge. Includes effort levels, skill-scoped hooks, executable scripts, security auditor, and persona presets."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softspark/ai-toolkit",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "Professional-grade AI coding toolkit: 90 skills, 44 agents, multi-platform support (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment), machine-enforced safety constitution, persona presets, skill security auditor, expanded lifecycle hooks, 11 plugin packs, and benchmark tooling.",
   "keywords": [
     "claude",

package/scripts/install_steps/ai_tools.py

@@ -188,39 +188,27 @@ def _inject_language_rules(cwd: Path, language_modules: list[str] | None) -> Non
     if not langs:
         return
 
-    # Build compact summary: first 5 key rules from each category
-    lines: list[str] = ["# Language Rules (auto-detected)", ""]
-    lines.append(f"Detected: **{', '.join(langs)}** + common rules.")
+    # Build a lightweight reference pointer — NOT the full rules content.
+    # Full rules are available as knowledge skills (auto-loaded by Claude)
+    # and as files Claude can Read on demand.
+    toolkit_pkg = app_dir.parent
+    lines: list[str] = ["# Language Rules", ""]
+    lines.append(f"This project uses: **{', '.join(langs)}**")
     lines.append("")
-    lines.append("Detailed rules available as knowledge skills (auto-loaded by Claude).")
-    lines.append("")
-
-    # Deduplicate: common + unique language dirs
+    lines.append("When writing or reviewing code, use the Glob and Read tools to read the rules:")
+    # Resolve actual installed path for the rules
+    rules_resolved = str(rules_src.resolve())
     all_dirs: list[str] = ["common"]
     for l in langs:
         if l not in all_dirs:
             all_dirs.append(l)
-
-    for lang_dir in all_dirs:
-        lang_path = rules_src / lang_dir
-        if not lang_path.is_dir():
-            continue
-        lang_label = lang_dir.capitalize() if lang_dir != "common" else "Common"
-        lines.append(f"## {lang_label} Rules")
-        lines.append("")
-        for rule_file in sorted(lang_path.glob("*.md")):
-            content = rule_file.read_text(encoding="utf-8").strip()
-            # Strip YAML frontmatter
-            if content.startswith("---"):
-                end = content.find("---", 3)
-                if end != -1:
-                    content = content[end + 3:].strip()
-            # Extract first 3 bullet points as key rules
-            bullets = [l.strip() for l in content.splitlines() if l.strip().startswith("- ")][:3]
-            if bullets:
-                category = rule_file.stem.replace("-", " ").title()
-                lines.append(f"**{category}:** {' | '.join(b.lstrip('- ') for b in bullets)}")
-        lines.append("")
+    for lang in all_dirs:
+        lang_path = rules_src / lang
+        if lang_path.is_dir():
+            categories = ", ".join(f.stem for f in sorted(lang_path.glob("*.md")))
+            lines.append(f"- `{lang_path.resolve()}/` ({categories})")
+    lines.append("")
+    lines.append("Read the relevant rule files before making code changes. Do NOT guess — read first.")
 
     # Write summary to temp file, then inject as section
     import tempfile