newstler
diff --git a/‎.claude/agents/rails-backend.md‎
Lines changed: 1 addition & 1 deletion b/‎.claude/agents/rails-backend.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.claude/commands/commit-push-pr.md‎
Lines changed: 1 addition & 1 deletion b/‎.claude/commands/commit-push-pr.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.claude/commands/review-code.md‎
Lines changed: 1 addition & 1 deletion b/‎.claude/commands/review-code.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.claude/commands/run-tests.md‎
Lines changed: 1 addition & 1 deletion b/‎.claude/commands/run-tests.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.claude/rules/i18n.md‎
Lines changed: 168 additions & 0 deletions b/‎.claude/rules/i18n.md‎
Lines changed: 168 additions & 0 deletions
diff --git a/‎.claude/rules/madmin.md‎
Lines changed: 149 additions & 0 deletions b/‎.claude/rules/madmin.md‎
Lines changed: 149 additions & 0 deletions
@@ -113,5 +113,5 @@ Before completing any task:
 ```bash
 bundle exec rubocop -A     # Fix lint issues
 rails test                  # Run tests
-bundle exec brakeman -q     # Security check
+bin/brakeman --no-pager      # Security check
 ```
@@ -21,7 +21,7 @@ Before committing, ensure code quality:
 ```bash
 bundle exec rubocop -A
 rails test
-bundle exec brakeman -q --no-pager
+bin/brakeman --no-pager
 ```
 
 If any quality gate fails, fix the issues before proceeding.
 
@@ -65,7 +65,7 @@ git diff --cached  # If already staged
 ```bash
 bundle exec rubocop -A
 rails test
-bundle exec brakeman -q --no-pager
+bin/brakeman --no-pager
 ```
 
 ## 4. Common Issues
 
@@ -93,7 +93,7 @@ Action: Method doesn't exist, check model implementation.
 If all tests pass:
 ```bash
 bundle exec rubocop -A
-bundle exec brakeman -q
+bin/brakeman --no-pager
 ```
 
 If tests fail:
 
@@ -0,0 +1,168 @@
+# i18n Standards
+
+## Philosophy
+
+**No hardcoded user-facing text.** All strings shown to users must use Rails i18n.
+
+## Key Conventions
+
+### Lazy Lookup in Views
+
+Use the shorthand `.key` notation in views - Rails automatically infers the full path:
+
+```erb
+<%# In app/views/sessions/new.html.erb %>
+<%= t(".heading") %>  <%# Looks up en.sessions.new.heading %>
+<%= t(".email_label") %>
+```
+
+### Lazy Lookup in Mailers
+
+Same pattern works in mailers:
+
+```ruby
+# In app/mailers/user_mailer.rb, method magic_link
+mail(to: user.email, subject: t(".subject"))  # en.user_mailer.magic_link.subject
+```
+
+### Controllers Use Full Paths
+
+Controllers should use explicit paths for clarity:
+
+```ruby
+redirect_to path, notice: t("controllers.sessions.create.notice")
+redirect_to path, alert: t("controllers.application.authenticate_user")
+```
+
+### Interpolation
+
+Use `%{variable}` for dynamic values:
+
+```yaml
+# config/locales/en/controllers.yml
+en:
+  controllers:
+    sessions:
+      verify:
+        notice: "Welcome back, %{name}!"
+```
+
+```ruby
+t("controllers.sessions.verify.notice", name: user.name)
+```
+
+## File Structure
+
+```
+config/locales/
+├── en.yml                      # Common terms (app_name, common.*)
+└── en/
+    ├── controllers.yml         # Flash messages and controller strings
+    ├── mailers.yml            # Email subjects and content
+    └── views/
+        ├── sessions.yml       # User login views
+        ├── home.yml           # Dashboard
+        ├── chats.yml          # Chat views
+        ├── models.yml         # AI models views
+        ├── messages.yml       # Message form
+        ├── shared.yml         # Sidebar, flash, shared partials
+        └── admins/
+            └── sessions.yml   # Admin login views
+```
+
+## What to Translate
+
+| Always Translate | Don't Translate |
+|-----------------|-----------------|
+| Headings and titles | HTML attributes (class, id, data-*) |
+| Button labels | Code paths and URLs |
+| Form labels and placeholders | Technical identifiers |
+| Error and success messages | Database values |
+| Help text and descriptions | CSS values |
+| Navigation labels | File names in code blocks |
+
+## Quality Checks
+
+Run before committing:
+
+```bash
+bundle exec i18n-tasks health    # Full health check (in CI)
+bundle exec i18n-tasks missing   # Find missing translations
+bundle exec i18n-tasks unused    # Find unused translations
+```
+
+## Adding New Translations
+
+1. **Add the key to the appropriate locale file** following the file structure
+2. **Use lazy lookup** (`.key`) in views and mailers where possible
+3. **Use full paths** in controllers for clarity
+4. **Run `i18n-tasks health`** to verify no missing or unused keys
+
+## Examples
+
+### View with Lazy Lookup
+
+```erb
+<%# app/views/users/show.html.erb %>
+<h1><%= t(".heading") %></h1>
+<p><%= t(".description", name: @user.name) %></p>
+```
+
+```yaml
+# config/locales/en/views/users.yml
+en:
+  users:
+    show:
+      heading: "User Profile"
+      description: "Welcome, %{name}!"
+```
+
+### Controller Flash Message
+
+```ruby
+# app/controllers/users_controller.rb
+def create
+  @user = User.create!(user_params)
+  redirect_to @user, notice: t("controllers.users.create.notice")
+end
+```
+
+```yaml
+# config/locales/en/controllers.yml
+en:
+  controllers:
+    users:
+      create:
+        notice: "User created successfully"
+```
+
+### Form Labels
+
+```erb
+<%= form.label :email, t(".email_label") %>
+<%= form.text_field :email, placeholder: t(".email_placeholder") %>
+```
+
+## Common Patterns
+
+### Pluralization
+
+```yaml
+en:
+  messages:
+    count:
+      one: "1 message"
+      other: "%{count} messages"
+```
+
+```ruby
+t("messages.count", count: @messages.size)
+```
+
+### Defaults
+
+When a key might not exist, provide a default:
+
+```erb
+<%= t(".title", default: "Default Title") %>
+```
@@ -0,0 +1,149 @@
+---
+description: Madmin admin panel conventions
+globs: ["app/madmin/**/*.rb", "app/controllers/madmin/**/*.rb"]
+---
+
+# Madmin Standards
+
+## Overview
+
+Madmin is the admin panel at `/madmin`. All admin CRUD operations go through Madmin resources.
+
+## Creating Resources
+
+```bash
+rails generate madmin:resource ModelName
+```
+
+This creates `app/madmin/resources/model_name_resource.rb`
+
+## Resource Configuration
+
+```ruby
+# app/madmin/resources/user_resource.rb
+class UserResource < Madmin::Resource
+  # Attributes displayed in admin
+  attribute :id, form: false
+  attribute :email
+  attribute :name
+  attribute :created_at, form: false
+  attribute :updated_at, form: false
+
+  # Customize index columns
+  def self.index_attributes
+    [:id, :email, :name, :created_at]
+  end
+
+  # Customize form fields
+  def self.form_attributes
+    [:email, :name]
+  end
+
+  # Customize show page
+  def self.show_attributes
+    [:id, :email, :name, :created_at, :updated_at]
+  end
+
+  # Scopes for filtering
+  def self.scopes
+    [
+      Madmin::Scope.new(:all),
+      Madmin::Scope.new(:recent, ->(resources) { resources.where("created_at > ?", 1.week.ago) })
+    ]
+  end
+end
+```
+
+## Custom Fields
+
+Create custom fields in `app/madmin/fields/`:
+
+```ruby
+# app/madmin/fields/json_field.rb
+class JsonField < Madmin::Field
+  def to_s
+    JSON.pretty_generate(value) if value.present?
+  end
+end
+```
+
+Usage:
+```ruby
+attribute :metadata, field: "JsonField"
+```
+
+## Custom Actions
+
+Add member actions to resources:
+
+```ruby
+class AdminResource < Madmin::Resource
+  member_action :send_magic_link, method: :post do
+    admin = Admin.find(params[:id])
+    AdminMailer.magic_link(admin).deliver_later
+    redirect_to madmin_admin_path(admin), notice: "Magic link sent!"
+  end
+end
+```
+
+## Authentication
+
+```ruby
+# app/controllers/madmin/application_controller.rb
+class Madmin::ApplicationController < Madmin::BaseController
+  before_action :authenticate_admin!
+
+  private
+
+  def authenticate_admin!
+    redirect_to main_app.new_admins_session_path unless current_admin
+  end
+
+  def current_admin
+    @current_admin ||= Admin.find_by(id: session[:admin_id]) if session[:admin_id]
+  end
+  helper_method :current_admin
+end
+```
+
+## Customizing Views
+
+Generate views to customize:
+
+```bash
+rails generate madmin:views
+rails generate madmin:views users  # For specific resource
+```
+
+Views go in `app/views/madmin/`
+
+## Sortable Columns (STRICT)
+
+**Every column in a Madmin index table MUST be sortable.** No exceptions.
+
+- Add the column name to `self.sortable_columns` in the resource
+- Use `<%= sortable :column_name, "Label" %>` in the `<th>` (never plain `<th>Text</th>`)
+- For computed columns (counts, sums), add custom sort logic in the controller's `scoped_resources`
+
+```ruby
+# Resource
+def self.sortable_columns
+  super + %w[owner_name members_count chats_count total_cost]
+end
+
+# Controller - custom sort for computed columns
+when "chats_count"
+  resources.left_joins(:chats).group("teams.id")
+    .reorder(Arel.sql("COUNT(chats.id) #{sort_direction}"))
+when "total_cost"
+  resources.left_joins(:chats).group("teams.id")
+    .reorder(Arel.sql("COALESCE(SUM(chats.total_cost), 0) #{sort_direction}"))
+```
+
+## Interface Separation
+
+**IMPORTANT:** Keep admin and user interfaces completely separate:
+- User interface: `/session/new`, `/home`, etc.
+- Admin interface: `/admins/session/new` (login), `/madmin` (panel)
+- **No links between user and admin interfaces**
+- Admin login is separate (different URLs, different styling)