senren-ui 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82671c3e673cf8cf9d922e83685d72bf5448b9acb1073596a9643f3da6fc9c15
-  data.tar.gz: 11691be1d0c35c8137aab34d0cb7ede42dc2b7a9f9d7f4cfa9b7a8b8acb1ba3e
+  metadata.gz: e233d7736e61036693bb895d99e0fd11a37eb9e183979fa9ea4f1d17d1686354
+  data.tar.gz: dbe764908e51d5007e876c412e2cdffeac6d2b36ac10b8b16187f376ef1e24f0
 SHA512:
-  metadata.gz: 52d5185842e8b35d4d3c6b2b9e3ec0015e1e09e436a830434f32a4f7fe64d846ba301c90d0229243a672cbfcc140e5104de5aef610ee8d33bc666414a08d83ee
-  data.tar.gz: eaf517da0a216f79d74fa6bbd25873f4f510b283a4fcb0b948f60a0dc9a6966c9e09e7cfd4d55987eaefc7d0600fd8bc90170b1b278a9afb8ca71fec875d34bf
+  metadata.gz: 4a9bd5abdf7f39b9afd87d94e263b256c4e8fd226d5505bee5e1c7cd031e44fe917442b17479718fe39d23909ceee0f94e064073a7717b6309508471db18ce8b
+  data.tar.gz: a40ab2909ac0f30900fe8e2aace6eba439820ac83cd2ccd37c6037bfcf372225c02d1268a721c3b38a4c243872c35b833ead558621a65a8399b9e8ea632d96b8

data/CHANGELOG.md

@@ -7,6 +7,35 @@ and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 v0.x is a pre-stable line: minor bumps may break things; patch bumps are
 bug fixes only.
 
+## [0.1.5] — 2026-05-03
+
+### Added
+
+- Multi-agent instruction sync system (`AgentRulesWriter`). A single
+  source-of-truth file (`.senren/agent-rules.md`) plus marker-managed
+  adapter files for Codex (`AGENTS.md`), Claude (`CLAUDE.md`),
+  Copilot (`.github/copilot-instructions.md`), and Cursor
+  (`.cursor/rules/senren.mdc`).
+- New rake task `senren:agents:sync`.
+- Plan 014 and Plan 015 documentation.
+
+### Changed
+
+- `LlmsWriter` is now a thin backward-compatible wrapper that delegates
+  to `AgentRulesWriter`. No more `public/llms*.txt` generation.
+- `senren:llms:generate` kept as deprecated alias.
+- `Doctor` checks now validate agent instruction files instead of
+  `public/llms*.txt`.
+- Doctor `run!` refactored into `runtime_checks` + `installation_checks`.
+- Install generator no longer creates `public/` directory.
+
+### Fixed
+
+- Deprecated `senren:llms:generate` task now passes `registry:` kwarg
+  consistently with all other call sites.
+- Release checklist items updated to reflect agent sync system.
+- Test assertion style standardized on Minitest-native `refute`.
+
 ## [0.1.4] — 2026-05-02
 
 ### Fixed

data/README.md

@@ -14,8 +14,7 @@ skill system and a source-copy install model inspired by shadcn/ui.
 - A registry of well-tested ViewComponents and Stimulus controllers.
 - A centralized `.senren/skill.md` file so AI coding agents understand
   every installed component, its dependencies, and its anti-patterns.
-- An `llms.txt` / `llms-full.txt` generator so AI agents can discover
-  Senren without scraping your codebase.
+- A multi-agent instruction sync for Codex, Claude, Copilot, and Cursor.
 
 ## What Senren is not
 
@@ -52,7 +51,7 @@ bin/rails generate senren:component picker --no-client  # without Stimulus
 bin/rails senren:add dialog --client        # install interactive official component
 bin/rails senren:add button                 # install static official component
 bin/rails senren:skill:sync                 # rebuild .senren/skill.md
-bin/rails senren:llms:generate              # rebuild public/llms*.txt
+bin/rails senren:agents:sync                # rebuild .senren/agent-rules + adapters
 bin/rails senren:doctor                     # check installation health
 ```
 
@@ -96,12 +95,17 @@ After install, your app contains:
 - `.senren/registry.yml` — mirror of the gem-side registry.
 - `.senren/installed_components.yml` — ledger of installed components.
 - `.senren/conventions.md` — Senren conventions for humans and agents.
-- `public/llms.txt`, `public/llms-full.txt` — discoverable AI summary.
+- `.senren/agent-rules.md` — source of truth for generated agent rules.
+- `AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md`,
+  `.cursor/rules/senren.mdc` — marker-managed adapter files for each agent.
 
 The skill file uses `<!-- senren:skill:start -->` / `:end` markers; only
 the region between them is rewritten by the generator, so any notes you
 add outside the markers are preserved.
 
+Agent adapter files are also marker-managed, so Senren updates only its own
+generated block and preserves your existing instructions outside that block.
+
 ## Component list
 
 See `registry/components.yml` for the canonical list. v0.1 ships:

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

@@ -27,10 +27,6 @@ module Senren
         empty_directory 'app/assets/stylesheets'
       end
 
-      def create_public_dir
-        empty_directory 'public'
-      end
-
       def copy_base_files
         template 'base_component.rb.tt', 'app/components/senren/base_component.rb'
         template 'senren.css.tt',                'app/assets/stylesheets/senren.css'
@@ -47,14 +43,15 @@ module Senren
         Senren::Rails::SkillWriter.new(paths: host_paths).sync!
       end
 
-      def write_llms_files
-        say_status :senren, 'writing public/llms.txt and public/llms-full.txt'
-        Senren::Rails::LlmsWriter.new(paths: host_paths).generate!
+      def write_agent_files
+        say_status :senren, 'syncing Codex/Cursor/Claude/Copilot instruction files'
+        Senren::Rails::AgentRulesWriter.new(paths: host_paths).sync!
       end
 
       def print_next_steps
         say "\nSenren installed."
         say 'Next: bin/rails senren:add button card badge alert dialog'
+        say 'Then: bin/rails senren:agents:sync'
       end
 
       private

data/lib/generators/senren/install/templates/conventions.md.tt

@@ -38,8 +38,11 @@ and obey it strictly.
 | `.senren/registry.yml`              | Generator (mirror of gem registry) |
 | `.senren/installed_components.yml`  | Generator (ledger)  |
 | `.senren/conventions.md`            | This file - safe to edit |
-| `public/llms.txt`                   | Generator (do not edit) |
-| `public/llms-full.txt`              | Generator (do not edit) |
+| `.senren/agent-rules.md`            | Generator (do not edit) |
+| `AGENTS.md`                         | Generated region only (between markers) |
+| `CLAUDE.md`                         | Generated region only (between markers) |
+| `.github/copilot-instructions.md`   | Generated region only (between markers) |
+| `.cursor/rules/senren.mdc`          | Generated region only (between markers) |
 
 ## Adding a component
 
@@ -64,3 +67,10 @@ Senren never overwrites those files unless you pass `--force`.
 
 You can write app-specific notes outside those markers. They are preserved
 across `bin/rails senren:skill:sync`.
+
+## Agent instruction maintenance
+
+Senren writes a shared source file at `.senren/agent-rules.md` and syncs
+adapter files for Codex/Cursor/Claude/Copilot. For adapter files, only the
+generated block between markers is managed by Senren; your custom notes
+outside markers are preserved.

data/lib/senren/rails/agent_rules_writer.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Senren
+  module Rails
+    # Generates a single source-of-truth rules file plus adapter files for
+    # Copilot, Cursor, Claude, and Codex.
+    #
+    # Adapter files are marker-managed to avoid overwriting existing project
+    # instructions outside Senren's generated block.
+    class AgentRulesWriter
+      START_MARKER = '<!-- senren:agent:start -->'
+      END_MARKER   = '<!-- senren:agent:end -->'
+
+      attr_reader :registry, :paths
+
+      def initialize(registry: Registry.load!, paths: HostPaths.new)
+        @registry = registry
+        @paths    = paths
+      end
+
+      def sync!
+        paths.ensure_agent_dirs!
+        files = []
+        files << write_full_file(paths.agent_rules_file, render_source_rules)
+        files << write_adapter_file(paths.codex_agents_md, render_codex_adapter)
+        files << write_adapter_file(paths.claude_md, render_claude_adapter)
+        files << write_adapter_file(paths.copilot_instructions, render_copilot_adapter)
+        files << write_adapter_file(paths.cursor_rule_file, render_cursor_adapter, prefix: cursor_frontmatter)
+        files
+      end
+
+      private
+
+      def installed_names
+        path = paths.installed_components
+        return [] unless path.exist?
+
+        ledger = YAML.safe_load_file(path) || {}
+        Array(ledger['installed']).filter_map { |entry| registry.find(entry['name']) }.map(&:name).sort
+      end
+
+      def render_source_rules
+        names = installed_names
+        <<~MD
+          # Senren Agent Rules
+
+          Generated by senren-ui. Do not edit by hand.
+          Run `bin/rails senren:agents:sync` to regenerate.
+
+          This file is the Senren source of truth for AI coding agents in this app.
+
+          ## Hard Rules
+
+          - Use Senren components before writing custom HTML.
+          - Use ViewComponent for reusable UI.
+          - Use Turbo for server state.
+          - Use Stimulus only for local behavior.
+          - Do not introduce React, Vue, Alpine, or external state frameworks.
+          - Use semantic Tailwind tokens; do not hard-code color families.
+
+          ## Important Files
+
+          - `.senren/skill.md`                 - centralized component guidance
+          - `.senren/conventions.md`           - project conventions
+          - `.senren/registry.yml`             - component registry mirror
+          - `.senren/installed_components.yml` - local install ledger
+
+          ## Installed Components (#{names.size})
+
+          #{format_names(names)}
+        MD
+      end
+
+      def render_codex_adapter
+        <<~MD
+          ## Senren UI
+
+          Follow `.senren/agent-rules.md` as the source of truth.
+
+          - Prefer Senren components before custom HTML.
+          - Keep reusable UI in ViewComponent.
+          - Use Turbo for server state, Stimulus for local behavior.
+          - Do not add React, Vue, Alpine, or external state frameworks.
+          - Use semantic Tailwind tokens.
+        MD
+      end
+
+      def render_claude_adapter
+        <<~MD
+          ## Senren UI
+
+          @.senren/agent-rules.md
+
+          Apply Senren conventions and component-first rules from the imported file.
+        MD
+      end
+
+      def render_copilot_adapter
+        <<~MD
+          ## Senren UI
+
+          Use `.senren/agent-rules.md` as the source of truth for this repository.
+
+          - Prefer Senren components before custom HTML.
+          - Reusable UI must use ViewComponent.
+          - Turbo handles server state; Stimulus handles local behavior.
+          - Do not introduce React, Vue, Alpine, or external state frameworks.
+          - Use semantic Tailwind tokens.
+        MD
+      end
+
+      def render_cursor_adapter
+        <<~MD
+          ## Senren UI
+
+          Follow `.senren/agent-rules.md` as the source of truth.
+
+          - Prefer Senren components before custom HTML.
+          - Reusable UI uses ViewComponent.
+          - Turbo for server state, Stimulus for local behavior.
+          - No React/Vue/Alpine/external state frameworks.
+          - Use semantic Tailwind tokens.
+        MD
+      end
+
+      def cursor_frontmatter
+        <<~MDC
+          ---
+          description: Senren UI repository conventions
+          alwaysApply: true
+          ---
+        MDC
+      end
+
+      def format_names(names)
+        return '_No components installed yet._' if names.empty?
+
+        names.map { |name| "- #{name}" }.join("\n")
+      end
+
+      def write_full_file(path, content)
+        atomic_write(path, content)
+        path
+      end
+
+      def write_adapter_file(path, generated, prefix: '')
+        existing = path.exist? ? path.read : prefix.to_s
+        updated = inject(existing, generated)
+        atomic_write(path, updated)
+        path
+      end
+
+      def inject(existing, generated)
+        if existing.include?(START_MARKER) && existing.include?(END_MARKER)
+          before = existing.split(START_MARKER, 2).first
+          tail = existing.split(START_MARKER, 2).last
+          after = tail.split(END_MARKER, 2).last
+          "#{before}#{START_MARKER}\n\n#{generated.rstrip}\n\n#{END_MARKER}#{after}"
+        else
+          body = existing.rstrip
+          prefix = body.empty? ? '' : "#{body}\n\n"
+          "#{prefix}#{START_MARKER}\n\n#{generated.rstrip}\n\n#{END_MARKER}\n"
+        end
+      end
+
+      def atomic_write(path, content)
+        tmp = "#{path}.tmp"
+        File.write(tmp, content)
+        File.rename(tmp, path)
+      end
+    end
+  end
+end

data/lib/senren/rails/doctor.rb

@@ -17,19 +17,7 @@ module Senren
       end
 
       def run!
-        results = []
-        results << check('ViewComponent gem available')           { defined?(::ViewComponent) }
-        results << check('TailwindCSS stylesheet present')        { paths.stylesheet_path.exist? }
-        results << check('Stimulus directory present')            { paths.stimulus_dir.directory? }
-        results << check('Turbo gem available')                   { defined?(::Turbo) || gem_loadable?('turbo-rails') }
-        results << check('.senren directory exists')              { paths.senren_dir.directory? }
-        results << check('.senren/skill.md exists')               { paths.skill_file.file? }
-        results << check('.senren/registry.yml exists')           { paths.registry_mirror.file? }
-        results << check('.senren/installed_components.yml exists') { paths.installed_components.file? }
-        results << check('public/llms.txt exists')                { paths.llms_short.file? }
-        results << check('public/llms-full.txt exists')           { paths.llms_full.file? }
-        results << check('app/components/senren exists')          { paths.components_dir.directory? }
-        results << check('app/javascript/controllers/senren exists') { paths.stimulus_dir.directory? }
+        results = runtime_checks + installation_checks
         installed = installed_count
         results << Result.new("#{installed} component(s) installed", installed >= 0, nil)
 
@@ -57,6 +45,31 @@ module Senren
         false
       end
 
+      def runtime_checks
+        [
+          check('ViewComponent gem available')    { defined?(::ViewComponent) },
+          check('TailwindCSS stylesheet present') { paths.stylesheet_path.exist? },
+          check('Stimulus directory present')     { paths.stimulus_dir.directory? },
+          check('Turbo gem available')            { defined?(::Turbo) || gem_loadable?('turbo-rails') }
+        ]
+      end
+
+      def installation_checks
+        [
+          check('.senren directory exists')               { paths.senren_dir.directory? },
+          check('.senren/skill.md exists')                { paths.skill_file.file? },
+          check('.senren/registry.yml exists')            { paths.registry_mirror.file? },
+          check('.senren/installed_components.yml exists') { paths.installed_components.file? },
+          check('.senren/agent-rules.md exists')          { paths.agent_rules_file.file? },
+          check('AGENTS.md exists')                       { paths.codex_agents_md.file? },
+          check('CLAUDE.md exists')                       { paths.claude_md.file? },
+          check('.github/copilot-instructions.md exists') { paths.copilot_instructions.file? },
+          check('.cursor/rules/senren.mdc exists')        { paths.cursor_rule_file.file? },
+          check('app/components/senren exists')           { paths.components_dir.directory? },
+          check('app/javascript/controllers/senren exists') { paths.stimulus_dir.directory? }
+        ]
+      end
+
       def installed_count
         return 0 unless paths.installed_components.file?
 

data/lib/senren/rails/host_paths.rb

@@ -16,6 +16,7 @@ module Senren
       def registry_mirror       = senren_dir.join('registry.yml')
       def installed_components  = senren_dir.join('installed_components.yml')
       def conventions_file      = senren_dir.join('conventions.md')
+      def agent_rules_file      = senren_dir.join('agent-rules.md')
 
       def components_dir        = root.join('app', 'components', 'senren')
       def base_component_path   = components_dir.join('base_component.rb')
@@ -24,12 +25,20 @@ module Senren
 
       def stimulus_dir          = root.join('app', 'javascript', 'controllers', 'senren')
 
-      def llms_short            = root.join('public', 'llms.txt')
-      def llms_full             = root.join('public', 'llms-full.txt')
+      def github_dir            = root.join('.github')
+      def copilot_instructions  = github_dir.join('copilot-instructions.md')
+      def cursor_rules_dir      = root.join('.cursor', 'rules')
+      def cursor_rule_file      = cursor_rules_dir.join('senren.mdc')
+      def claude_md             = root.join('CLAUDE.md')
+      def codex_agents_md       = root.join('AGENTS.md')
 
       def ensure_dirs!
         [senren_dir, components_dir, stimulus_dir,
-         stylesheet_path.dirname, llms_short.dirname].each(&:mkpath)
+         stylesheet_path.dirname, github_dir, cursor_rules_dir].each(&:mkpath)
+      end
+
+      def ensure_agent_dirs!
+        [senren_dir, github_dir, cursor_rules_dir].each(&:mkpath)
       end
     end
   end

data/lib/senren/rails/installer.rb

@@ -5,7 +5,7 @@ require 'fileutils'
 module Senren
   module Rails
     # Idempotent installer that lays down the .senren directory, base
-    # component, stylesheet, and initial llms files. Reused by the install
+    # component, stylesheet, and agent instruction files. Reused by the install
     # generator and by ad-hoc rake task entry points.
     class Installer
       attr_reader :paths, :stdout
@@ -20,7 +20,7 @@ module Senren
         install_static_files(force: force)
         mirror_registry
         SkillWriter.new(paths: paths).sync!
-        LlmsWriter.new(paths: paths).generate!
+        AgentRulesWriter.new(paths: paths).sync!
         print_next_steps
         true
       end
@@ -73,6 +73,7 @@ module Senren
 
             bin/rails senren:add button card badge alert
             bin/rails senren:add dialog dropdown_menu
+            bin/rails senren:agents:sync
             bin/rails senren:doctor
 
           Read .senren/skill.md and .senren/conventions.md to get oriented.

data/lib/senren/rails/llms_writer.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
-require 'yaml'
-
 module Senren
   module Rails
-    # Generates public/llms.txt and public/llms-full.txt for AI discoverability.
-    # The entire content of both files is owned by this writer; do not edit by hand.
+    # Backward-compatible wrapper around AgentRulesWriter.
+    #
+    # Legacy llms generation now maps to agent rules synchronization and no longer
+    # writes public llms files.
     class LlmsWriter
       attr_reader :registry, :paths
 
@@ -15,134 +15,7 @@ module Senren
       end
 
       def generate!
-        paths.llms_short.parent.mkpath
-        paths.llms_full.parent.mkpath
-        atomic_write(paths.llms_short, render_short)
-        atomic_write(paths.llms_full,  render_full)
-        [paths.llms_short, paths.llms_full]
-      end
-
-      private
-
-      def installed
-        path = paths.installed_components
-        return [] unless path.exist?
-
-        ledger = YAML.safe_load_file(path) || {}
-        Array(ledger['installed']).filter_map { |e| registry.find(e['name']) }
-      end
-
-      def render_short
-        names = installed.map(&:name).sort
-        <<~TXT
-          # Senren UI
-
-          Generated by senren-ui. Do not edit by hand. Run
-          `bin/rails senren:llms:generate` to regenerate.
-
-          Senren UI is the local Rails UI system used by this application.
-          Use `.senren/skill.md` as the primary AI Agent guide.
-
-          ## Hard Rules
-
-          - Use Senren components before writing custom HTML.
-          - Use ViewComponent for reusable UI.
-          - Use Turbo for server state.
-          - Use Stimulus only for local behavior.
-          - Do not introduce React, Vue, Alpine, or any external state framework.
-          - Do not hard-code colors; use semantic Tailwind tokens.
-
-          ## Important Files
-
-          - `.senren/skill.md`              - centralized AI agent guide
-          - `.senren/registry.yml`          - mirror of installable components
-          - `.senren/installed_components.yml` - what is currently installed
-          - `.senren/conventions.md`        - Senren conventions for humans and agents
-
-          ## Installed Components (#{names.size})
-
-          #{names.map { |n| "- #{n}" }.join("\n")}
-        TXT
-      end
-
-      def render_full
-        comps = installed.sort_by(&:name)
-
-        out = []
-        out << '# Senren UI - Full Snapshot'
-        out << ''
-        out << 'Generated by senren-ui. Do not edit by hand. Run'
-        out << '`bin/rails senren:llms:generate` to regenerate.'
-        out << ''
-        out << '## Hard Rules'
-        out << ''
-        out << '- Use Senren components before writing custom HTML.'
-        out << '- Server-rendered HTML first; ViewComponent for reusable UI.'
-        out << '- Hotwire (Turbo + Stimulus) is the only client runtime.'
-        out << '- TailwindCSS with semantic tokens (`bg-background`, `text-foreground`, ...).'
-        out << '- Do not introduce React, Vue, Alpine, or external state frameworks.'
-        out << '- Components copied into `app/components/senren/` are owned by this app; edit them directly.'
-        out << ''
-        out << '## Installed Component Inventory'
-        out << ''
-
-        registry.groups.each do |group|
-          group_comps = comps.select { |c| c.category == group['id'] }
-          next if group_comps.empty?
-
-          out << "### #{group['title']}"
-          out << ''
-          out << group['description'].to_s
-          out << ''
-          group_comps.each { |c| out << render_component(c) }
-        end
-
-        out << '## Recipes'
-        out << ''
-        registry.recipes.each do |id, recipe|
-          out << "### #{id}"
-          out << ''
-          out << recipe['description'].to_s
-          out << ''
-          out << 'Components:'
-          recipe['components'].each { |c| out << "- #{c}" }
-          out << ''
-        end
-
-        out.join("\n")
-      end
-
-      def render_component(comp)
-        ruby_class = "Senren::#{comp.name.split('_').map { |w| w[0].upcase + w[1..] }.join}Component"
-        s = []
-        s << "#### #{comp.name}#{'  (stub)' if comp.stub?}"
-        s << ''
-        s << "Category: #{comp.category}.  " \
-             "Client: #{comp.client? ? "yes (#{comp.controller})" : 'no'}.  " \
-             "Variants: #{comp.variants.empty? ? 'none' : comp.variants.join(', ')}."
-        s << ''
-        s << "Use for: #{comp.use_for.join('; ')}." unless comp.use_for.empty?
-        s << "Avoid: #{comp.avoid.join('; ')}." unless comp.avoid.empty?
-        s << ''
-        s << 'Rails usage:'
-        s << ''
-        s << '```erb'
-        s << if comp.variants.any?
-               "<%= render #{ruby_class}.new(variant: :#{comp.variants.first}) do %>"
-             else
-               "<%= render #{ruby_class}.new do %>"
-             end
-        s << '  ...'
-        s << '<% end %>'
-        s << '```'
-        s << ''
-        s.join("\n")
-      end
-
-      def atomic_write(path, content)
-        tmp = "#{path}.tmp"
-        File.write(tmp, content)
-        File.rename(tmp, path)
+        AgentRulesWriter.new(registry: registry, paths: paths).sync!
       end
     end
   end

data/lib/senren/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Senren
   module Rails
-    VERSION = '0.1.4'
+    VERSION = '0.1.5'
   end
 end

data/lib/senren/rails.rb

@@ -9,6 +9,7 @@ module Senren
     autoload :Registry,         'senren/rails/registry'
     autoload :ComponentCopier,  'senren/rails/component_copier'
     autoload :SkillWriter,      'senren/rails/skill_writer'
+    autoload :AgentRulesWriter, 'senren/rails/agent_rules_writer'
     autoload :LlmsWriter,       'senren/rails/llms_writer'
     autoload :Installer,        'senren/rails/installer'
     autoload :Doctor,           'senren/rails/doctor'

data/lib/tasks/senren.rake

@@ -16,27 +16,39 @@ namespace :senren do
     installed = copier.install(names, client_override: options[:client_override], force: options[:force])
 
     Senren::Rails::SkillWriter.new(registry: registry, paths: paths).sync!
-    Senren::Rails::LlmsWriter.new(registry: registry, paths: paths).generate!
+    Senren::Rails::AgentRulesWriter.new(registry: registry, paths: paths).sync!
 
     puts "Installed: #{installed.join(', ')}"
   end
 
   namespace :skill do
-    desc 'Rebuild .senren/skill.md from the registry and installed_components ledger.'
+    desc 'Rebuild .senren/skill.md and refresh agent instruction adapters.'
     task sync: :environment do
       paths    = Senren::Rails::HostPaths.new
       registry = Senren::Rails::Registry.load!
       file = Senren::Rails::SkillWriter.new(registry: registry, paths: paths).sync!
       puts "Wrote #{file}"
+      Senren::Rails::AgentRulesWriter.new(registry: registry, paths: paths).sync!
+    end
+  end
+
+  namespace :agents do
+    desc 'Regenerate .senren/agent-rules.md and adapter instruction files.'
+    task sync: :environment do
+      paths    = Senren::Rails::HostPaths.new
+      registry = Senren::Rails::Registry.load!
+      files = Senren::Rails::AgentRulesWriter.new(registry: registry, paths: paths).sync!
+      files.each { |f| puts "Wrote #{f}" }
     end
   end
 
   namespace :llms do
-    desc 'Regenerate public/llms.txt and public/llms-full.txt.'
+    desc 'Deprecated alias for senren:agents:sync.'
     task generate: :environment do
+      puts 'senren:llms:generate is deprecated. Running senren:agents:sync instead.'
       paths    = Senren::Rails::HostPaths.new
       registry = Senren::Rails::Registry.load!
-      files = Senren::Rails::LlmsWriter.new(registry: registry, paths: paths).generate!
+      files = Senren::Rails::AgentRulesWriter.new(registry: registry, paths: paths).sync!
       files.each { |f| puts "Wrote #{f}" }
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: senren-ui
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - vutt
@@ -66,6 +66,7 @@ files:
 - lib/generators/senren/install/templates/installed_components.yml.tt
 - lib/generators/senren/install/templates/senren.css.tt
 - lib/senren/rails.rb
+- lib/senren/rails/agent_rules_writer.rb
 - lib/senren/rails/component_copier.rb
 - lib/senren/rails/doctor.rb
 - lib/senren/rails/engine.rb