rails_skills 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1b6f8f02fc94e9e434f1920d1e48644527a8b6bc759cf6a3f98a8e58ae91e3c
-  data.tar.gz: 57557d27a5b1d441d275504ff7198a0bf8e94c46a0f9a09b575b1eadd850e7da
+  metadata.gz: 5af04983ccd7bca43906c83a86f87b2335b3ebf8f623c7c076c643912e4a4de0
+  data.tar.gz: 3a0f8b103cf6a739d43563af198164be53f1ecd0695dd380550936437cdec0d5
 SHA512:
-  metadata.gz: 6aa639bc11974b790c8072330b89746ce6ef1d0d6abe7f9e48b81babc3eee3094301c200bee533f5d23a615c4dccb1c7ca5082e5c97aa7d4503e5341f544b654
-  data.tar.gz: 59c1921613d644ef07b1b567b23cfa0f990eeb700c1928e9903d9a609aee7f5af2277e40071301cd84d67c58121e881ad992b4b38a5d1510d548047309c5e97f
+  metadata.gz: 447433389c77cfa4db2c17fe6a23bb70816c45029bab1ee59e8bbea1bc428ad17beb9d6c840625c6fc05884ea07581798c4133a93f8286144ab80a7f51a9934a
+  data.tar.gz: 16ac56c48e06851a081221aedf2a8bb2ad2d93d60b7ff881977e9ead7b2d9123db5fe76252edbff7d7de0eb7ee983ee0f40326777ea64c6502bc564bc834485a

data/README.md

@@ -4,12 +4,13 @@ A Ruby gem that organizes your knowledge base into AI skills shared between **yo
 
 # Structure
 It introduces additional layer on top of MVC - intelligence layer. This layer is optimised for reading by both humans and machines.
-Next structure is default:
+The gem scaffolds three default categories but any folder under `skills/` is automatically discovered and symlinked:
 | Category | Purpose | Example |
 |----------|---------|---------|
-| **domains/** | Business domain knowledge | `domains/payments`, `domains/auth` |
+| **services/** | Business service skills | `services/payments`, `services/auth` |
 | **stack/** | Technology stack skills | `stack/ruby`, `stack/postgres` |
-| **workflows/** | Development workflows | `workflows/commit`, `workflows/deploy` |
+| **workflows/** | Development workflows and guides | `workflows/commit`, `workflows/deploy` |
+| **your_folder/** | Any custom category you create | `your_folder/my_skill` |
 
 ## Usage
 
@@ -27,12 +28,12 @@ rails generate rails_skills:install
 ```
 your_rails_app/
 ├── skills/                    # Shared AI skill files (canonical location)
-│   ├── domains/               # Domain-specific skills
+│   ├── services/               # Domain-specific skills
 │   │   └── .keep
 │   ├── stack/                 # Technology stack skills
 │   │   └── ruby/
 │   │       └── SKILL.md
-│   └── workflows/             # Workflow skills
+│   └── workflows/             # Workflows and guides
 │       ├── commit/
 │       │   └── SKILL.md
 │       └── rails_skills/
@@ -58,9 +59,10 @@ Skills are organized by category in `skills/` but flattened when symlinked into
 ### Create a custom skill
 
 ```bash
-rails generate rails_skills:skill domains/payments
+rails generate rails_skills:skill services/payments
 rails generate rails_skills:skill stack/postgres
 rails generate rails_skills:skill workflows/deploy --description="Deployment workflow"
+rails generate rails_skills:skill my_folder/my_skill  # custom folders work too
 ```
 
 Skills are created in `skills/` and automatically symlinked (flattened) into both `.claude/skills` and `.codex/skills`.
@@ -87,7 +89,7 @@ skills/stack/ruby          →  .claude/skills/stack/ruby    (NOT discovered)
 
 ## How It Works
 
-1. `skills/` is the single source of truth, organized by category (`domains/`, `stack/`, `workflows/`)
+1. `skills/` is the single source of truth — any subfolder is a category
 2. Claude and Codex require a flat skills directory — nested paths are not loaded
 3. The gem creates flattened symlinks: `skills/stack/ruby` → `.claude/skills/ruby`
 4. Edit skills in `skills/` and both AI tools see the changes immediately

data/lib/generators/rails_skills/install/install_generator.rb

@@ -15,7 +15,7 @@ module RailsSkills
 
       def create_skills_directory
         empty_directory RailsSkills::SKILLS_DIR
-        RailsSkills::CATEGORIES.each do |category|
+        RailsSkills::DEFAULT_CATEGORIES.each do |category|
           empty_directory "#{RailsSkills::SKILLS_DIR}/#{category}"
         end
       end
@@ -32,7 +32,14 @@ module RailsSkills
       end
 
       def create_skills_targets
-        RailsSkills::SKILL_TARGETS.each { |target| empty_directory target }
+        RailsSkills::SKILL_TARGETS.each do |target|
+          dest = File.join(destination_root, target)
+          if File.symlink?(dest)
+            File.delete(dest)
+            say_status :remove, "#{target} (old symlink)", :yellow
+          end
+          empty_directory target
+        end
       end
 
       def copy_claude_settings
@@ -40,8 +47,8 @@ module RailsSkills
       end
 
       def install_default_skills
-        # domains - empty with .keep
-        install_skill_folder("domains")
+        # services - empty with .keep
+        install_skill_folder("services")
 
         # stack - ruby skill
         install_skill("stack/ruby")
@@ -53,10 +60,12 @@ module RailsSkills
 
       def link_skills
         skills_root = File.join(destination_root, RailsSkills::SKILLS_DIR)
+        return unless File.directory?(skills_root)
 
-        RailsSkills::CATEGORIES.each do |category|
+        Dir.children(skills_root).sort.each do |category|
           category_dir = File.join(skills_root, category)
           next unless File.directory?(category_dir)
+          next if category.start_with?(".")
 
           Dir.children(category_dir).sort.each do |name|
             next unless File.directory?(File.join(category_dir, name))
@@ -85,7 +94,7 @@ module RailsSkills
         say ""
         say "Directory structure:", :yellow
         say "  skills/"
-        say "    domains/       <- domain-specific skills"
+        say "    services/      <- service-specific skills"
         say "    stack/         <- technology stack skills (ruby)"
         say "    workflows/     <- workflow skills (commit)"
         RailsSkills::SKILL_TARGETS.each do |target|
@@ -98,9 +107,10 @@ module RailsSkills
         say "Skills are flattened into #{RailsSkills::SKILL_TARGETS.join(' and ')}", :blue
         say ""
         say "Next steps:", :yellow
-        say "  rails g rails_skills:skill domains/my_domain   # Create a domain skill"
+        say "  rails g rails_skills:skill services/payments    # Create a service skill"
         say "  rails g rails_skills:skill stack/postgres      # Create a stack skill"
         say "  rails g rails_skills:skill workflows/deploy    # Create a workflow skill"
+        say "  rails g rails_skills:skill my_folder/my_skill  # Custom folders work too"
         say ""
       end
 

data/lib/generators/rails_skills/skills_library/workflows/commit/SKILL.md

@@ -7,7 +7,7 @@ description: Git commit workflow and conventions
 
 1. **Check status**: `git status`
 2. **Review changes**: `git diff`
-3. **Analyze missing docs/skills** - If you see changes to domains listed in skills/domains - review the need to update the skill doc
+3. **Analyze missing docs/skills** - If you see changes to services listed in skills/services - review the need to update the skill doc
 3. **Stage files**: `git add <files>` (prefer specific files over `-A`)
 4. **Commit**: `git commit -m "type: message"`
 5. **Push**: Push only if explicitly asked so, use `git push origin {current branch}`

data/lib/generators/rails_skills/skills_library/workflows/rails_skills/SKILL.md

@@ -10,15 +10,16 @@ description: How to manage AI skills with the rails_skills gem
 | Command | Purpose |
 |---------|---------|
 | `rails g rails_skills:install` | Install skills directory and symlinks |
-| `rails g rails_skills:skill domains/NAME` | Create a domain skill |
+| `rails g rails_skills:skill services/NAME` | Create a service skill |
 | `rails g rails_skills:skill stack/NAME` | Create a stack skill |
 | `rails g rails_skills:skill workflows/NAME` | Create a workflow skill |
+| `rails g rails_skills:skill FOLDER/NAME` | Any custom folder works |
 
 ## Directory Structure
 
 ```
 skills/                        # Canonical location — edit skills here
-  domains/                     # Business domain knowledge
+  services/                     # Business service knowledge
   stack/                       # Technology stack skills
   workflows/                   # Development workflow skills
 .claude/skills/                # Flattened symlinks (auto-managed)
@@ -31,11 +32,14 @@ Skills are organized by category in `skills/` but flattened when symlinked. `ski
 
 ## Categories
 
+Any folder under `skills/` is a category. The gem scaffolds three defaults but you can create your own:
+
 | Category | Use for | Examples |
 |----------|---------|----------|
-| **domains/** | Business logic, bounded contexts | `domains/payments`, `domains/auth`, `domains/billing` |
+| **services/** | Business logic, bounded contexts | `services/payments`, `services/auth`, `services/billing` |
 | **stack/** | Languages, frameworks, databases | `stack/ruby`, `stack/postgres`, `stack/redis` |
 | **workflows/** | Dev processes, CI/CD, conventions | `workflows/commit`, `workflows/deploy`, `workflows/review` |
+| **your_folder/** | Anything you need | `your_folder/my_skill` |
 
 ## Creating Skills
 
@@ -44,7 +48,7 @@ Skills are organized by category in `skills/` but flattened when symlinked. `ski
 rails g rails_skills:skill stack/postgres
 
 # With custom description
-rails g rails_skills:skill domains/payments --description="Payment processing patterns"
+rails g rails_skills:skill services/payments --description="Payment processing patterns"
 
 # With references directory for supplementary files
 rails g rails_skills:skill stack/redis --with-references
@@ -81,6 +85,6 @@ Conventions and guidelines.
 1. One skill per concept — keep skills focused and single-purpose
 2. Use quick reference tables for scannable lookup
 3. Include real code examples over abstract descriptions
-4. Put domain skills close to the business language your team uses
+4. Put service skills close to the business language your team uses
 5. Update skills when patterns evolve — they are living documentation
 6. Skills are shared between Claude and Codex — write for both audiences

data/lib/rails_skills/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsSkills
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/rails_skills.rb

@@ -9,6 +9,6 @@ module RailsSkills
   SKILLS_DIR = "skills"
   CLAUDE_DIR = ".claude"
   CODEX_DIR = ".codex"
-  CATEGORIES = %w[domains stack workflows].freeze
+  DEFAULT_CATEGORIES = %w[services stack workflows].freeze
   SKILL_TARGETS = ["#{CLAUDE_DIR}/skills", "#{CODEX_DIR}/skills"].freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_skills
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Sergii Mostovyi
@@ -44,7 +44,7 @@ files:
 - lib/generators/rails_skills/rules_library/testing.md
 - lib/generators/rails_skills/skill/skill_generator.rb
 - lib/generators/rails_skills/skill/templates/SKILL.md.tt
-- lib/generators/rails_skills/skills_library/domains/.keep
+- lib/generators/rails_skills/skills_library/services/.keep
 - lib/generators/rails_skills/skills_library/stack/ruby/SKILL.md
 - lib/generators/rails_skills/skills_library/workflows/commit/SKILL.md
 - lib/generators/rails_skills/skills_library/workflows/rails_skills/SKILL.md