@softspark/ai-toolkit 1.6.0 → 1.6.1

package/CHANGELOG.md

@@ -7,6 +7,19 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## v1.6.1 — IDE Rule Format Compliance Audit (2026-04-10)
+
+### Fixed
+- **Cline rules path** — changed `.cline/rules/` to `.clinerules/` directory per official Cline 3.7+ docs. Old path was silently ignored by Cline
+- **Augment frontmatter type** — changed `auto_attached` to `agent_requested` per official Augment docs
+- **Aider config** — added `CONVENTIONS.md` to `read:` list in `.aider.conf.yml` so Aider auto-loads the conventions we generate
+
+### Changed
+- **`add-rule` help text** — now lists all supported editors (was missing Augment, Roo, Aider, Antigravity)
+- Legacy `.clinerules` single-file is auto-migrated to `.clinerules/` directory on next install
+
+---
+
 ## v1.6.0 — IDE Language Rules Propagation, Planning Docs, Cloud Security Pack (2026-04-10)
 
 ### Added

package/README.md

@@ -121,7 +121,7 @@ Replaces all symlinks with real files, inlines rules into CLAUDE.md, copies cons
 | Windsurf | `~/.codeium/.../global_rules.md` + `.windsurf/rules/*.md` | `ai-toolkit install` / `--local` | global + project |
 | Gemini CLI | `~/.gemini/GEMINI.md` | `ai-toolkit install` | global |
 | GitHub Copilot | `.github/copilot-instructions.md` | `ai-toolkit install --local` | project |
-| Cline | `.clinerules` + `.cline/rules/*.md` | `ai-toolkit install --local` | project |
+| Cline | `.clinerules/*.md` | `ai-toolkit install --local` | project |
 | Roo Code | `.roomodes` + `.roo/rules/*.md` | `ai-toolkit install --local` | project |
 | Aider | `.aider.conf.yml` + `CONVENTIONS.md` | `ai-toolkit install --local` | project |
 | Augment | `.augment/rules/ai-toolkit-*.md` | `ai-toolkit install --local` | project |
@@ -535,9 +535,9 @@ When `--editors` is used alongside detected or explicit languages, language rule
 |--------|-------------------|------------|
 | Cursor | `.cursor/rules/ai-toolkit-lang-<lang>.mdc` | `globs` per file type (e.g. `**/*.py`) |
 | Windsurf | `.windsurf/rules/ai-toolkit-lang-<lang>.md` | always loaded |
-| Cline | `.cline/rules/ai-toolkit-lang-<lang>.md` | always loaded |
+| Cline | `.clinerules/ai-toolkit-lang-<lang>.md` | always loaded |
 | Roo Code | `.roo/rules/ai-toolkit-lang-<lang>.md` | always loaded |
-| Augment | `.augment/rules/ai-toolkit-lang-<lang>.md` | `auto_attached` with globs |
+| Augment | `.augment/rules/ai-toolkit-lang-<lang>.md` | `agent_requested` with globs |
 | Antigravity | `.agent/rules/ai-toolkit-lang-<lang>.md` | always loaded |
 
 Registered rules (`ai-toolkit add-rule`) are also propagated to directory-based editor configs as `ai-toolkit-custom-<name>` files.

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

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

package/bin/ai-toolkit.js

@@ -83,7 +83,7 @@ const COMMANDS = {
   'copilot-instructions': 'Generate .github/copilot-instructions.md',
   'gemini-md': 'Generate GEMINI.md for Gemini CLI',
   'cline-rules': 'Generate .clinerules for Cline (legacy)',
-  'cline-dir-rules': 'Generate .cline/rules/*.md for Cline (recommended)',
+  'cline-dir-rules': 'Generate .clinerules/*.md for Cline (recommended)',
   'roo-modes': 'Generate .roomodes for Roo Code',
   'roo-dir-rules': 'Generate .roo/rules/*.md shared rules for Roo Code',
   'aider-conf': 'Generate .aider.conf.yml for Aider',

package/kb/reference/architecture-overview.md

@@ -108,7 +108,7 @@ Machine (global)                              Project (local)
 - `--editors cursor,aider` — install only selected editors
 - (no flag) — auto-detect from existing project files; `update --local` picks up whatever editors already have configs
 
-Each editor gets both legacy single-file format (for backwards compat) and new directory-based format (`.cursor/rules/*.mdc`, `.windsurf/rules/*.md`, `.cline/rules/*.md`, `.roo/rules/*.md`, `.augment/rules/ai-toolkit-*.md`, `.agent/rules/*.md`, `CONVENTIONS.md`). Hooks are global-only — not merged into project settings.
+Each editor gets directory-based format (`.cursor/rules/*.mdc`, `.windsurf/rules/*.md`, `.clinerules/*.md`, `.roo/rules/*.md`, `.augment/rules/ai-toolkit-*.md`, `.agent/rules/*.md`, `CONVENTIONS.md`). Hooks are global-only — not merged into project settings.
 
 ## CLI Commands
 
@@ -132,7 +132,7 @@ Each editor gets both legacy single-file format (for backwards compat) and new d
 | `copilot-instructions` | `./` | Generates `.github/copilot-instructions.md` |
 | `gemini-md` | `./` | Generates `GEMINI.md` |
 | `cline-rules` | `./` | Generates `.clinerules` (legacy) |
-| `cline-dir-rules` | `./` | Generates `.cline/rules/*.md` |
+| `cline-dir-rules` | `./` | Generates `.clinerules/*.md` |
 | `roo-modes` | `./` | Generates `.roomodes` |
 | `roo-dir-rules` | `./` | Generates `.roo/rules/*.md` |
 | `aider-conf` | `./` | Generates `.aider.conf.yml` |

package/llms-full.txt

@@ -5264,7 +5264,7 @@ Machine (global)                              Project (local)
 - `--editors cursor,aider` — install only selected editors
 - (no flag) — auto-detect from existing project files; `update --local` picks up whatever editors already have configs
 
-Each editor gets both legacy single-file format (for backwards compat) and new directory-based format (`.cursor/rules/*.mdc`, `.windsurf/rules/*.md`, `.cline/rules/*.md`, `.roo/rules/*.md`, `.augment/rules/ai-toolkit-*.md`, `.agent/rules/*.md`, `CONVENTIONS.md`). Hooks are global-only — not merged into project settings.
+Each editor gets directory-based format (`.cursor/rules/*.mdc`, `.windsurf/rules/*.md`, `.clinerules/*.md`, `.roo/rules/*.md`, `.augment/rules/ai-toolkit-*.md`, `.agent/rules/*.md`, `CONVENTIONS.md`). Hooks are global-only — not merged into project settings.
 
 ## CLI Commands
 
@@ -5288,7 +5288,7 @@ Each editor gets both legacy single-file format (for backwards compat) and new d
 | `copilot-instructions` | `./` | Generates `.github/copilot-instructions.md` |
 | `gemini-md` | `./` | Generates `GEMINI.md` |
 | `cline-rules` | `./` | Generates `.clinerules` (legacy) |
-| `cline-dir-rules` | `./` | Generates `.cline/rules/*.md` |
+| `cline-dir-rules` | `./` | Generates `.clinerules/*.md` |
 | `roo-modes` | `./` | Generates `.roomodes` |
 | `roo-dir-rules` | `./` | Generates `.roo/rules/*.md` |
 | `aider-conf` | `./` | Generates `.aider.conf.yml` |

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.6.0",
+  "version": "1.6.1",
   "components": {
     "agents": {
       "description": "44 specialized agents (orchestrator, backend, frontend, security, devops, etc.)",

package/package.json

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

package/scripts/add_rule.py

@@ -2,8 +2,9 @@
 """add-rule -- Register a rule file in ~/.ai-toolkit/rules/.
 
 Registered rules are automatically injected into all AI tool configs
-(Claude, Cursor, Windsurf, Gemini) on next 'ai-toolkit install',
-and into project-local configs (Copilot, Cline) on 'ai-toolkit install --local'.
+on next 'ai-toolkit install' or 'ai-toolkit update':
+  Global: Claude, Cursor, Windsurf, Gemini, Augment
+  Local (--local): all of the above + Copilot, Cline, Roo, Aider, Antigravity
 
 Usage:
   add_rule.py <rule-file> [rule-name]
@@ -47,8 +48,8 @@ def main() -> None:
     print(f"Registered: '{rule_name}' -> {dest}")
     print()
     print("Apply now:")
-    print("  ai-toolkit update            # global (Claude, Cursor, Windsurf, Gemini)")
-    print("  ai-toolkit update --local    # project-local (Copilot, Cline)")
+    print("  ai-toolkit update            # global (Claude, Cursor, Windsurf, Gemini, Augment)")
+    print("  ai-toolkit update --local    # project-local (all editors)")
 
 
 if __name__ == "__main__":

package/scripts/generate_aider_conf.py

@@ -18,8 +18,9 @@ def main() -> None:
     print("# Use the architect mode for complex tasks, aligned with our 2-phase workflow")
     print("architect: true")
     print()
-    print("# Read global rules ")
+    print("# Read project rules (loaded as read-only context)")
     print("read:")
+    print('  - "CONVENTIONS.md"')
     print('  - ".claude/CLAUDE.md"')
     print('  - ".claude/constitution.md"')
     print('  - "AGENTS.md"')

package/scripts/generate_augment_rules.py

@@ -3,7 +3,7 @@
 
 Augment supports per-file rules with frontmatter:
   - type: always_apply  — always in context
-  - type: auto_attached + globs — attached for matching files
+  - type: agent_requested + globs — attached for matching files
 
 The existing generate_augment.py creates a single always_apply file.
 This generator adds granular per-category rules with appropriate types.
@@ -72,7 +72,7 @@ def _make_rules() -> dict[str, callable]:
         f"{PREFIX}code-style.md": lambda: _augment_wrap(
             rule_code_style(),
             description="Code style conventions",
-            rule_type="auto_attached",
+            rule_type="agent_requested",
             globs=["*.py", "*.ts", "*.tsx", "*.js", "*.jsx", "*.go", "*.rs",
                    "*.java", "*.kt", "*.swift", "*.dart", "*.cs", "*.php",
                    "*.cpp", "*.cc", "*.rb"],
@@ -80,7 +80,7 @@ def _make_rules() -> dict[str, callable]:
         f"{PREFIX}testing.md": lambda: _augment_wrap(
             rule_testing(),
             description="Testing standards and patterns",
-            rule_type="auto_attached",
+            rule_type="agent_requested",
             globs=["*.test.*", "*.spec.*", "test_*", "**/tests/**",
                    "**/test/**", "**/__tests__/**"],
         ),
@@ -107,7 +107,7 @@ def generate(target_dir: Path, *,
             all_rules[filename] = (lambda fn, l, g: lambda: _augment_wrap(
                 fn(),
                 description=f"{l.title()} language rules",
-                rule_type="auto_attached",
+                rule_type="agent_requested",
                 globs=g,
             ))(content_fn, lang, globs)
         else:

package/scripts/generate_cline_rules.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
-"""Generate .cline/rules/*.md files for Cline.
+"""Generate .clinerules/*.md files for Cline.
 
-Cline reads directory-based rules from .cline/rules/*.md (since Q1 2025).
-The legacy .clinerules single-file format is still generated separately
-by generate_cline.py for backwards compatibility.
+Cline reads rules from the .clinerules/ directory (since Cline 3.7).
+Each .md file inside .clinerules/ is automatically loaded.
+The legacy .clinerules single-file format is replaced by this directory.
 
 Usage:
   python3 scripts/generate_cline_rules.py [target-dir]
@@ -25,11 +25,16 @@ from dir_rules_shared import (
 def generate(target_dir: Path, *,
              language_modules: list[str] | None = None,
              rules_dir: Path | None = None) -> None:
-    """Write .cline/rules/*.md files to target_dir."""
+    """Write .clinerules/*.md files to target_dir."""
+    # Migrate: if .clinerules exists as a single file, remove it
+    # so the directory can be created (Cline 3.7+ uses directory format)
+    clinerules = target_dir / ".clinerules"
+    if clinerules.is_file():
+        clinerules.unlink()
     rules = dict(STANDARD_RULES)
     rules.update(build_language_rules(language_modules))
     rules.update(build_registered_rules(rules_dir))
-    write_rules(target_dir, rules, ".cline/rules")
+    write_rules(target_dir, rules, ".clinerules")
 
 
 def main() -> None:

package/scripts/install_steps/ai_tools.py

@@ -136,7 +136,6 @@ _EDITOR_MARKERS: dict[str, str] = {
     ".windsurfrules": "windsurf",
     ".windsurf/rules": "windsurf",
     ".clinerules": "cline",
-    ".cline/rules": "cline",
     ".roomodes": "roo",
     ".roo/rules": "roo",
     ".aider.conf.yml": "aider",
@@ -309,7 +308,7 @@ def _install_local_dry_run(reset: bool, editors: list[str] | None = None) -> Non
         "copilot":      "  Would inject: .github/copilot-instructions.md",
         "cursor":       "  Would generate: .cursorrules + .cursor/rules/*.mdc",
         "windsurf":     "  Would generate: .windsurfrules + .windsurf/rules/*.md",
-        "cline":        "  Would generate: .clinerules + .cline/rules/*.md",
+        "cline":        "  Would generate: .clinerules/*.md",
         "roo":          "  Would generate: .roomodes + .roo/rules/*.md",
         "aider":        "  Would generate: .aider.conf.yml + CONVENTIONS.md",
         "augment":      "  Would generate: .augment/rules/ai-toolkit-*.md",
@@ -429,11 +428,11 @@ def _create_local_ai_tool_configs(cwd: Path, rules_dir: Path,
                            rules_dir=rules_dir)
 
     if "cline" in eds:
-        inject_with_rules(
-            "generate-cline.sh",
-            cwd / ".clinerules",
-            rules_dir,
-        )
+        # Migrate: remove legacy .clinerules single file (replaced by directory)
+        legacy_clinerules = cwd / ".clinerules"
+        if legacy_clinerules.is_file():
+            legacy_clinerules.unlink()
+            print("  Migrated: .clinerules file → .clinerules/ directory")
         from generate_cline_rules import generate as gen_cline_rules
         gen_cline_rules(cwd, language_modules=language_modules,
                         rules_dir=rules_dir)