rails-ai-context 4.7.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c780366dc085c17be730aded4bbe8548b0e5e71c5c810caed96104a9379363fa
-  data.tar.gz: f5c46207b643df1a7dc1c5563c1d9e932f772ce5e27eb1839d9f14ddde116bd0
+  metadata.gz: 2fa1c4d8e9c153c1ad06c0be6824b5421638259b441f4fabc6318e2709315d4e
+  data.tar.gz: ecf8ae7d7cb2da0a649146940da643da4cc7c0d3b7ee955a22a0ab1964791ccf
 SHA512:
-  metadata.gz: 934c4d703203801494a8addde164c71e56119e5701dd454574b0362d2a6d68523b6f0830654ff81eaa1d36fac7eca457374960e4e9fe54731f32431fe23ea8a4
-  data.tar.gz: ca2bf9e27db44fb35b8d9bd984748b7fce1108a013ef7ea6ec5a01757c48187b6ce6985c529ee8bf4df7cc9abd59085da8c356b3c73052e5196b07cc9a9a3790
+  metadata.gz: 606d359a389873a99e361927e24a26c965491a16286ec22183e514dd6f89fcc14e2fdb1fe838b9fdde72b6cd0e6bb602196de45299afc226d5894c3ac7fdc286
+  data.tar.gz: 66101ebb71fd0f15229ccf480b0b280e4d01793bedbd70e2e8158ef9869799a2b29214257a1e51a37ec11da8d23f325e1b43436ab900aa0841e9f5c561996d88

data/CHANGELOG.md

@@ -5,6 +5,44 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.0.0] — 2026-04-05
+
+### Removed (BREAKING)
+
+This release removes the Design & Styling surface and the Accessibility rule surface. When AI assistants consumed pre-digested design/styling context (color palettes, Tailwind class strings, canonical HTML/ERB snippets), they produced poor UI/UX output by blindly copying class strings instead of understanding visual hierarchy. The accessibility surface was asymmetric (Claude-only static rule file, no live MCP tool) and provided generic best-practice rules that didn't earn their keep.
+
+**Design system:**
+- **Removed `rails_get_design_system` MCP tool** — tool count is now **38** (was 39). Tool class `RailsAiContext::Tools::GetDesignSystem` deleted.
+- **Removed `:design_tokens` introspector** — class `RailsAiContext::Introspectors::DesignTokensIntrospector` deleted.
+- **Removed `ui_patterns`, `canonical_examples`, `shared_partials` keys** from `ViewTemplateIntrospector` output. The introspector now returns only `templates` and `partials`.
+- **Removed `DesignSystemHelper` serializer module** — module `RailsAiContext::Serializers::DesignSystemHelper` deleted. Consumers no longer receive UI Patterns sections in rule files or compact output.
+- **Removed `"design"` option** from the `include:` parameter of `rails_get_context`. Valid options are now: `schema`, `models`, `routes`, `gems`, `conventions`.
+
+**Accessibility:**
+- **Removed `:accessibility` introspector** — class `RailsAiContext::Introspectors::AccessibilityIntrospector` deleted. `ctx[:accessibility]` no longer populated.
+- **Removed `discover_accessibility` cross-cut** from `rails_analyze_feature`. The tool no longer emits a `## Accessibility` section with per-feature a11y findings.
+- **Removed Accessibility line** from root-file Stack Overview (no more "Accessibility: Good/OK/Needs work" label).
+
+**Preset counts:** `:full` is now **31** (was 33); `:standard` is now **17** (was 19). Both lost `:design_tokens` and `:accessibility`.
+
+**Legacy rule files no longer generated:**
+- `.claude/rules/rails-ui-patterns.md`
+- `.cursor/rules/rails-ui-patterns.mdc`
+- `.github/instructions/rails-ui-patterns.instructions.md`
+- `.claude/rules/rails-accessibility.md`
+
+### Migration notes
+
+- **Legacy files are NOT auto-deleted.** On first run after upgrade (via `rake ai:context`, `rails-ai-context context`, install generator, or watcher), the gem detects stale `rails-ui-patterns.*` and `rails-accessibility.md` files and prompts interactively in TTY sessions, or warns (non-destructive) in non-TTY sessions. Answer `y` to remove, or delete the files manually.
+- **If you depended on `rails_get_design_system`**, replace with `rails_get_component_catalog` (component-based) or read view files directly with `rails_read_file` / `rails_search_code`.
+- **If you depended on `include: "design"`** in `rails_get_context`, remove that option.
+- **If you depended on `ctx[:accessibility]`** (custom tools / serializers), that key is gone. Use standard a11y linters (axe-core, lighthouse) in your test suite instead.
+- **The "Build or modify a view" workflow** in tool guides now starts with `rails_get_component_catalog` instead of `rails_get_design_system`.
+
+### Why
+
+AI assistants that consume pre-digested summaries produce worse output than AI that reads actual source files. For design systems, class-string copying defeats the mental model required for cohesive visual hierarchy. For accessibility, generic rules ("add alt text") are universal knowledge that AI already has — the static counts didn't add actionable context, and the asymmetric distribution (Claude-only rule file, no live tool) was incoherent with the gem's charter. The gem's charter is ground truth for Rails structure (schema, associations, routes, controllers) — design-system and accessibility summaries were adjacent to that charter and actively counterproductive or inert.
+
 ## [4.7.0] — 2026-04-05
 
 ### Added

data/CLAUDE.md

@@ -8,10 +8,11 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context.rb` — Main entry point, public API (Zeitwerk autoloaded)
 - `lib/rails_ai_context/configuration.rb` — User-facing config with presets (:standard, :full)
 - `lib/rails_ai_context/introspector.rb` — Orchestrates sub-introspectors
-- `lib/rails_ai_context/introspectors/` — 33 introspectors (schema, models, routes, jobs, gems, conventions, stimulus, database_stats, controllers, views, view_templates, design_tokens, turbo, i18n, config, active_storage, action_text, auth, api, tests, rake_tasks, assets, devops, action_mailbox, migrations, seeds, middleware, engines, multi_database, components, accessibility, performance, frontend_frameworks)
-- `lib/rails_ai_context/tools/` — 39 MCP tools using the official mcp SDK
+- `lib/rails_ai_context/introspectors/` — 31 introspectors (schema, models, routes, jobs, gems, conventions, stimulus, database_stats, controllers, views, view_templates, turbo, i18n, config, active_storage, action_text, auth, api, tests, rake_tasks, assets, devops, action_mailbox, migrations, seeds, middleware, engines, multi_database, components, performance, frontend_frameworks)
+- `lib/rails_ai_context/tools/` — 38 MCP tools using the official mcp SDK
 - `lib/rails_ai_context/cli/` — CLI tool runner (`tool_runner.rb`) — executes MCP tools from rake/Thor
-- `lib/rails_ai_context/serializers/` — Output formatters (claude, claude_rules, opencode, opencode_rules, cursor_rules, copilot, copilot_instructions, markdown, JSON, context_file_serializer, compact_serializer_helper, test_command_detection, tool_guide_helper, design_system_helper, stack_overview_helper)
+- `lib/rails_ai_context/serializers/` — Output formatters (claude, claude_rules, opencode, opencode_rules, cursor_rules, copilot, copilot_instructions, markdown, JSON, context_file_serializer, compact_serializer_helper, test_command_detection, tool_guide_helper, stack_overview_helper)
+- `lib/rails_ai_context/legacy_cleanup.rb` — prompts cleanup of legacy `rails-ui-patterns.*` files (v5.0.0 migration)
 - `lib/rails_ai_context/resources.rb` — MCP resources (static data AI clients read directly)
 - `lib/rails_ai_context/server.rb` — MCP server configuration (stdio + HTTP transports)
 - `lib/rails_ai_context/middleware.rb` — Rack middleware for auto-mounting MCP HTTP endpoint
@@ -35,40 +36,39 @@ structure to AI assistants via the Model Context Protocol (MCP).
 7. **Diff-aware** — context regeneration skips unchanged files
 8. **Per-assistant serializers** — each AI tool gets tailored output format
 9. **Zeitwerk autoloading** — files loaded on-demand, not all upfront
-10. **Introspector presets** — `:full` (33) default, `:standard` (19) for lightweight usage
+10. **Introspector presets** — `:full` (31) default, `:standard` (17) for lightweight usage
 11. **MCP auto-discovery** — `.mcp.json` generated by install generator
 12. **Compact by default** — context files ≤150 lines, MCP tools use `detail` parameter (summary/standard/full)
 13. **Per-tool split rules** — `.claude/rules/`, `.cursor/rules/`, `.github/instructions/`
 14. **Section markers** — root file content wrapped in `<!-- BEGIN/END rails-ai-context -->` to preserve user content
 15. **generate_root_files toggle** — when false, skip root files (CLAUDE.md, etc.), only generate split rules
-16. **custom_tools API** — `config.custom_tools` array lets users register additional MCP::Tool subclasses alongside the 39 built-in tools
-17. **Design system extraction** — view templates analyzed for canonical examples, color palette, typography, responsive patterns, interactive states, dark mode
+16. **custom_tools API** — `config.custom_tools` array lets users register additional MCP::Tool subclasses alongside the 38 built-in tools
+17. **Legacy cleanup prompting** — v5.0.0 removed `rails_get_design_system` tool + `:design_tokens` introspector + UI pattern rule files. `LegacyCleanup.prompt_legacy_files` detects stale `rails-ui-patterns.*` files at entry points (rake, CLI, watcher, install generator) and prompts (TTY) or warns (non-TTY)
 18. **skip_tools API** — `config.skip_tools` array lets users exclude specific built-in tools (e.g. `%w[rails_security_scan]`)
 19. **Security scanning** — optional Brakeman integration via `rails_security_scan` tool (graceful degradation if not installed)
 20. **tool_mode config** — `:mcp` (default, MCP primary + CLI fallback) or `:cli` (CLI only, no MCP server needed). Selected during install.
-21. **CLI tool access** — all 39 MCP tools callable from terminal: `rails ai:tool[schema]`, `rails-ai-context tool schema`. Tool name resolution: `schema` → `get_schema` → `rails_get_schema`.
+21. **CLI tool access** — all 38 MCP tools callable from terminal: `rails ai:tool[schema]`, `rails-ai-context tool schema`. Tool name resolution: `schema` → `get_schema` → `rails_get_schema`.
 22. **Shared ToolGuideHelper** — serializers use a shared module for tool reference sections, rendering MCP or CLI syntax based on `tool_mode`
 23. **Component catalog** — ViewComponent/Phlex introspection: props, slots, previews, sidecar assets, usage examples via `rails_get_component_catalog`
-24. **Accessibility scanning** — ARIA attributes, semantic HTML, screen reader text, alt text, landmark roles, accessibility score via AccessibilityIntrospector
-25. **Performance analysis** — N+1 query risks, missing counter_cache, missing FK indexes, eager load candidates via `rails_performance_check`
-26. **Migration advisor** — migration code generation with duplicate/nonexistent column warnings, reversibility flags, table name normalization via `rails_migration_advisor`
-27. **Frontend framework detection** — auto-detects React/Vue/Svelte/Angular from package.json, Vite/Shakapacker/Webpacker config, TypeScript setup, monorepo layout, package manager via `rails_get_frontend_stack`
-28. **Install generator idempotency** — re-install preserves existing config, only adds new sections, updates ai_tools/tool_mode selections, prompts per-tool file cleanup for removed tools
-29. **Docs search** — bundled topic index with weighted keyword search, on-demand GitHub fetch
-30. **Safe SQL queries** — defense-in-depth: regex pre-filter + SET TRANSACTION READ ONLY + timeout
-31. **Log reading** — reverse file tail with level filtering and sensitive data redaction
-32. **Config validation** — `http_port`, `cache_ttl`, `max_tool_response_chars`, `query_row_limit` validated on assignment with clear error messages
-33. **Sensitive column redaction** — query tool redacts columns by name AND by suffix pattern (password, secret, token, key, digest, hash) to prevent alias bypass
-34. **Standalone mode** — `gem install rails-ai-context && rails-ai-context init` works without Gemfile entry. CLI pre-loads gem before Rails boot, restores `$LOAD_PATH` entries stripped by `Bundler.setup`. Config from `.rails-ai-context.yml`.
-35. **YAML config** — `.rails-ai-context.yml` as alternative to initializer. Supports all config options except `custom_tools` (Ruby classes) and `excluded_concerns` (regex). Precedence: initializer > YAML > defaults.
-36. **Config auto-loading** — `Configuration.auto_load!` checks `configured_via_block?` flag. If initializer ran, YAML is skipped. Corrupted YAML degrades gracefully with a warning.
-37. **Three install paths** — In-Gemfile (`rails generate rails_ai_context:install`), Standalone (`rails-ai-context init`), Zero config (just run `rails-ai-context serve` with defaults). Users can switch between paths freely; `.mcp.json` command is updated on re-init/re-install.
-38. **Anti-Hallucination Protocol** — 6-rule verification section embedded in every generated context file (CLAUDE.md, AGENTS.md, .claude/rules/, .cursor/rules/, .github/instructions/). Targets AI failure modes: statistical priors overriding facts, pattern completion beating verification, stale context. Toggleable via `config.anti_hallucination_rules` (default: true). Rendered by `tools_anti_hallucination_section` in `tool_guide_helper.rb`, placed between intro and detail_guidance in both full and compact render methods.
+24. **Performance analysis** — N+1 query risks, missing counter_cache, missing FK indexes, eager load candidates via `rails_performance_check`
+25. **Migration advisor** — migration code generation with duplicate/nonexistent column warnings, reversibility flags, table name normalization via `rails_migration_advisor`
+26. **Frontend framework detection** — auto-detects React/Vue/Svelte/Angular from package.json, Vite/Shakapacker/Webpacker config, TypeScript setup, monorepo layout, package manager via `rails_get_frontend_stack`
+27. **Install generator idempotency** — re-install preserves existing config, only adds new sections, updates ai_tools/tool_mode selections, prompts per-tool file cleanup for removed tools
+28. **Docs search** — bundled topic index with weighted keyword search, on-demand GitHub fetch
+29. **Safe SQL queries** — defense-in-depth: regex pre-filter + SET TRANSACTION READ ONLY + timeout
+30. **Log reading** — reverse file tail with level filtering and sensitive data redaction
+31. **Config validation** — `http_port`, `cache_ttl`, `max_tool_response_chars`, `query_row_limit` validated on assignment with clear error messages
+32. **Sensitive column redaction** — query tool redacts columns by name AND by suffix pattern (password, secret, token, key, digest, hash) to prevent alias bypass
+33. **Standalone mode** — `gem install rails-ai-context && rails-ai-context init` works without Gemfile entry. CLI pre-loads gem before Rails boot, restores `$LOAD_PATH` entries stripped by `Bundler.setup`. Config from `.rails-ai-context.yml`.
+34. **YAML config** — `.rails-ai-context.yml` as alternative to initializer. Supports all config options except `custom_tools` (Ruby classes) and `excluded_concerns` (regex). Precedence: initializer > YAML > defaults.
+35. **Config auto-loading** — `Configuration.auto_load!` checks `configured_via_block?` flag. If initializer ran, YAML is skipped. Corrupted YAML degrades gracefully with a warning.
+36. **Three install paths** — In-Gemfile (`rails generate rails_ai_context:install`), Standalone (`rails-ai-context init`), Zero config (just run `rails-ai-context serve` with defaults). Users can switch between paths freely; `.mcp.json` command is updated on re-init/re-install.
+37. **Anti-Hallucination Protocol** — 6-rule verification section embedded in every generated context file (CLAUDE.md, AGENTS.md, .claude/rules/, .cursor/rules/, .github/instructions/). Targets AI failure modes: statistical priors overriding facts, pattern completion beating verification, stale context. Toggleable via `config.anti_hallucination_rules` (default: true). Rendered by `tools_anti_hallucination_section` in `tool_guide_helper.rb`, placed between intro and detail_guidance in both full and compact render methods.
 
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (1627 examples)
+bundle exec rspec           # Run specs (1563 examples)
 bundle exec rubocop         # Lint
 ```
 

data/CONTRIBUTING.md

@@ -19,8 +19,8 @@ The test suite uses [Combustion](https://github.com/pat/combustion) to boot a mi
 ```
 lib/rails_ai_context/
 ├── cli/               # CLI tool runner (tool_runner.rb) — executes MCP tools from rake/Thor
-├── introspectors/     # 33 introspectors (schema, models, routes, etc.)
-├── tools/             # 39 MCP tools with detail levels and pagination
+├── introspectors/     # 31 introspectors (schema, models, routes, etc.)
+├── tools/             # 38 MCP tools with detail levels and pagination
 ├── serializers/       # Per-assistant formatters + shared ToolGuideHelper
 ├── server.rb          # MCP server setup (stdio + HTTP)
 ├── live_reload.rb     # MCP live reload (file watcher + cache invalidation)

data/README.md

@@ -66,7 +66,7 @@ rails-ai-context serve    # start MCP server
 
 </div>
 
-Now your AI doesn't guess — it **asks your app directly.** 39 tools that query your schema, models, routes, controllers, views, and conventions on demand. It gets the right answer the first time.
+Now your AI doesn't guess — it **asks your app directly.** 38 tools that query your schema, models, routes, controllers, views, and conventions on demand. It gets the right answer the first time.
 
 <br>
 
@@ -147,7 +147,7 @@ rails ai:serve
 
 ### CLI
 
-Same 39 tools, no server needed. Works in any terminal, any AI tool.
+Same 38 tools, no server needed. Works in any terminal, any AI tool.
 
 ```bash
 rails 'ai:tool[search_code]' pattern="can_cook?" match_type=trace
@@ -215,14 +215,14 @@ rails 'ai:tool[validate]' files=app/controllers/cooks_controller.rb level=rails
 <br>
 
 ```bash
-# Get the design system
-rails 'ai:tool[design_system]' detail=standard
-# → your actual button classes, card patterns, color palette — copy-paste ready
-
 # Check existing view patterns
 rails 'ai:tool[view]' controller=dashboard
 # → templates with ivars, Turbo frames, Stimulus controllers, partial locals
 
+# See existing components + usage examples
+rails 'ai:tool[component_catalog]' detail=standard
+# → ViewComponent/Phlex props, slots, previews, sidecar assets
+
 # Get Stimulus data-attributes
 rails 'ai:tool[stimulus]' controller=chart
 # → correct HTML with dashes (not underscores) + reverse view lookup
@@ -232,7 +232,7 @@ rails 'ai:tool[stimulus]' controller=chart
 
 <br>
 
-## 39 Tools
+## 38 Tools
 
 Every tool is **read-only** and returns data verified against your actual app — not guesses, not training data.
 
@@ -286,7 +286,6 @@ Every tool is **read-only** and returns data verified against your actual app
 |:-----|:------------|
 | `get_view` | Templates with ivars, Turbo wiring, Stimulus refs, partial locals |
 | `get_stimulus` | HTML data-attributes (dashes!) + targets + values + actions |
-| `get_design_system` | Copy-paste HTML/ERB patterns for your actual components |
 | `get_partial_interface` | What locals to pass + what methods are called on them |
 | `get_turbo_map` | Broadcast → subscription wiring + mismatch warnings |
 | `get_frontend_stack` | React/Vue/Svelte/Angular, Hotwire, TypeScript, package manager |
@@ -372,7 +371,7 @@ Enabled by default. Disable with `config.anti_hallucination_rules = false` if yo
 │  Your Rails App                                          │
 │  models + schema + routes + controllers + views + jobs   │
 └────────────────────────┬────────────────────────────────┘
-                         │ introspects (33 introspectors)
+                         │ introspects (31 introspectors)
                          ▼
 ┌─────────────────────────────────────────────────────────┐
 │  rails-ai-context                                        │
@@ -382,7 +381,7 @@ Enabled by default. Disable with `config.anti_hallucination_rules = false` if yo
          ▼                  ▼              ▼
 ┌──────────────────┐ ┌────────────┐ ┌────────────────────┐
 │  Static Files     │ │  MCP Server │ │  CLI Tools          │
-│  CLAUDE.md        │ │  39 tools   │ │  Same 39 tools      │
+│  CLAUDE.md        │ │  38 tools   │ │  Same 38 tools      │
 │  .cursor/rules/   │ │  stdio/HTTP │ │  No server needed   │
 │  .github/instr... │ │  .mcp.json  │ │  rails 'ai:tool[X]' │
 └──────────────────┘ └────────────┘ └────────────────────┘
@@ -416,7 +415,7 @@ Both paths ask which AI tools you use and whether you want MCP or CLI mode. `.mc
 | In-Gemfile | Standalone | What it does |
 |:-----------|:-----------|:------------|
 | `rails ai:context` | `rails-ai-context context` | Generate context files |
-| `rails 'ai:tool[NAME]'` | `rails-ai-context tool NAME` | Run any of the 39 tools |
+| `rails 'ai:tool[NAME]'` | `rails-ai-context tool NAME` | Run any of the 38 tools |
 | `rails ai:tool` | `rails-ai-context tool --list` | List all available tools |
 | `rails ai:serve` | `rails-ai-context serve` | Start MCP server (stdio) |
 | `rails ai:doctor` | `rails-ai-context doctor` | Diagnostics + AI readiness score |
@@ -431,7 +430,7 @@ Both paths ask which AI tools you use and whether you want MCP or CLI mode. `.mc
 RailsAiContext.configure do |config|
   config.ai_tools   = %i[claude cursor]   # Which AI tools to generate for
   config.tool_mode   = :mcp               # :mcp (default) or :cli
-  config.preset      = :full              # :full (33 introspectors) or :standard (19)
+  config.preset      = :full              # :full (31 introspectors) or :standard (17)
 end
 ```
 
@@ -442,7 +441,7 @@ end
 
 | Option | Default | Description |
 |:-------|:--------|:------------|
-| `preset` | `:full` | `:full` (33 introspectors) or `:standard` (19) |
+| `preset` | `:full` | `:full` (31 introspectors) or `:standard` (17) |
 | `context_mode` | `:compact` | `:compact` (150 lines) or `:full` |
 | `generate_root_files` | `true` | Set `false` for split rules only |
 | `anti_hallucination_rules` | `true` | Embed 6-rule verification protocol in generated context files |
@@ -471,7 +470,7 @@ end
 ## About
 
 Built by a Rails developer with 10+ years of production experience.<br>
-1621 tests. 39 tools. 33 introspectors. Standalone or in-Gemfile.<br>
+1563 tests. 38 tools. 31 introspectors. Standalone or in-Gemfile.<br>
 MIT licensed. [Contributions welcome.](CONTRIBUTING.md)
 
 <br>

data/SECURITY.md

@@ -30,7 +30,7 @@ If you discover a security vulnerability in rails-ai-context, please report it r
 
 ## Security Design
 
-- All 39 MCP tools are **read-only** and never modify your application or database.
+- All 38 MCP tools are **read-only** and never modify your application or database.
 - **Sensitive file blocking** — configurable `sensitive_patterns` blocks access to `.env`, `*.key`, `*.pem`, `credentials.yml.enc` across all search and read tools. Patterns are checked in `rails_search_code`, `rails_get_edit_context`, and all new tools.
 - **Path traversal protection** — all file-reading tools validate paths with `File.realpath()` against `Rails.root` to prevent directory escape.
 - **Command injection prevention** — code search uses `Open3.capture2` with array arguments (never shell strings). The `--` flag separator prevents pattern injection.

data/docs/GUIDE.md

@@ -132,7 +132,7 @@ end
 
 `rails ai:context` generates **29 files** across all AI assistants:
 
-### Claude Code (6 files)
+### Claude Code (5 files)
 
 | File | Purpose | Notes |
 |------|---------|-------|
@@ -140,7 +140,6 @@ end
 | `.claude/rules/rails-schema.md` | Database table listing | Auto-loaded by Claude Code alongside CLAUDE.md. |
 | `.claude/rules/rails-models.md` | Model listing with associations | Auto-loaded by Claude Code alongside CLAUDE.md. |
 | `.claude/rules/rails-context.md` | Project context and conventions | Auto-loaded by Claude Code alongside CLAUDE.md. |
-| `.claude/rules/rails-ui-patterns.md` | UI patterns and design tokens | Auto-loaded by Claude Code alongside CLAUDE.md. |
 | `.claude/rules/rails-mcp-tools.md` | Full MCP tool reference | Parameters, detail levels, pagination, workflow guide. |
 
 ### OpenCode (3 files)
@@ -151,17 +150,16 @@ end
 | `app/models/AGENTS.md` | Model reference | Auto-loaded by OpenCode when reading files in `app/models/`. |
 | `app/controllers/AGENTS.md` | Controller reference | Auto-loaded by OpenCode when reading files in `app/controllers/`. |
 
-### Cursor (5 files)
+### Cursor (4 files)
 
 | File | Purpose | Notes |
 |------|---------|-------|
 | `.cursor/rules/rails-project.mdc` | Project overview | `alwaysApply: true` — loaded in every conversation. |
 | `.cursor/rules/rails-models.mdc` | Model reference | `globs: app/models/**/*.rb` — auto-attaches when editing models. |
 | `.cursor/rules/rails-controllers.mdc` | Controller reference | `globs: app/controllers/**/*.rb` — auto-attaches when editing controllers. |
-| `.cursor/rules/rails-ui-patterns.mdc` | UI patterns and design tokens | `globs: app/views/**/*.erb` — loaded when editing views. |
 | `.cursor/rules/rails-mcp-tools.mdc` | MCP tool reference | `alwaysApply: true` — always available. |
 
-### GitHub Copilot (6 files)
+### GitHub Copilot (5 files)
 
 | File | Purpose | Notes |
 |------|---------|-------|
@@ -169,7 +167,6 @@ end
 | `.github/instructions/rails-models.instructions.md` | Model context | `applyTo: app/models/**/*.rb` — loaded when editing models. |
 | `.github/instructions/rails-controllers.instructions.md` | Controller context | `applyTo: app/controllers/**/*.rb` — loaded when editing controllers. |
 | `.github/instructions/rails-context.instructions.md` | Project context and conventions | `applyTo: **/*` — loaded everywhere. |
-| `.github/instructions/rails-ui-patterns.instructions.md` | UI patterns and design tokens | `applyTo: app/views/**/*.erb` — loaded when editing views. |
 | `.github/instructions/rails-mcp-tools.instructions.md` | MCP tool reference | `applyTo: **/*` — loaded everywhere. |
 
 ### Generic (1 file)
@@ -261,7 +258,7 @@ rails ai:context:claude           # Use this instead (no quoting needed)
 
 ## CLI Tools
 
-All 39 MCP tools can be run directly from the terminal — no MCP server or AI client needed.
+All 38 MCP tools can be run directly from the terminal — no MCP server or AI client needed.
 
 ### Rake
 
@@ -325,7 +322,7 @@ The `tool_mode` is selected during `rails generate rails_ai_context:install`.
 
 ## MCP Tools — Full Reference
 
-All 39 tools are **read-only** and **idempotent** — they never modify your application or database.
+All 38 tools are **read-only** and **idempotent** — they never modify your application or database.
 
 ### rails_get_schema
 
@@ -707,33 +704,6 @@ rails_analyze_feature(feature: "orders")
 
 **Returns:** Markdown with sections for Models (with columns, associations, validations, scopes, enums), Controllers (with actions and filters), Routes, Services (with methods), Jobs (with queue/retry), Views (with partials and Stimulus refs), Stimulus controllers (with targets/values/actions), Tests (with counts), Related models, Concerns, Callbacks, Channels, Mailers, and Environment dependencies. Each section shows match counts.
 
-### rails_get_design_system
-
-Returns the app's design system: color palette with semantic roles, component patterns with real HTML examples from actual views, typography scale, layout conventions, responsive breakpoints, and interactive state patterns.
-
-**Parameters:**
-
-| Param | Type | Description |
-|-------|------|-------------|
-| `detail` | string | `summary` (palette + components), `standard` (+ canonical page examples + design rules, default), `full` (+ typography, responsive, dark mode, animations, design tokens) |
-
-**Examples:**
-
-```
-rails_get_design_system()
-  → Color palette (primary, danger, success), component patterns (buttons, cards, inputs),
-    canonical page examples (form page, list page), design rules
-
-rails_get_design_system(detail: "summary")
-  → Compact: color roles + component class strings only
-
-rails_get_design_system(detail: "full")
-  → Everything: + typography scale, responsive breakpoints, interactive states,
-    dark mode patterns, animations, icon system, design tokens, shared partials
-```
-
-**Returns:** Structured design system reference. Includes real HTML/ERB snippets from the app's actual views as canonical examples, semantic color roles (primary for CTAs, danger for destructive), component variants, typography hierarchy, spacing scale, and explicit design rules for AI to follow.
-
 ### rails_security_scan
 
 Runs Brakeman static security analysis on the Rails app. Detects SQL injection, XSS, mass assignment, command injection, and other vulnerabilities. Requires the `brakeman` gem — returns installation instructions if not present.
@@ -1148,7 +1118,7 @@ RailsAiContext.configure do |config|
 end
 ```
 
-Both transports are **read-only** — they expose the same 39 tools and never modify your app.
+Both transports are **read-only** — they expose the same 38 tools and never modify your app.
 
 ---
 
@@ -1159,7 +1129,7 @@ Both transports are **read-only** — they expose the same 39 tools and never mo
 RailsAiContext.configure do |config|
   # --- Introspectors ---
 
-  # Presets: :full (33 introspectors, default) or :standard (19)
+  # Presets: :full (31 introspectors, default) or :standard (17)
   config.preset = :full
 
   # Cherry-pick on top of a preset
@@ -1274,7 +1244,7 @@ end
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `preset` | Symbol | `:full` | Introspector preset (`:full` or `:standard`) |
-| `introspectors` | Array | 32 (full preset) | Which introspectors to run |
+| `introspectors` | Array | 31 (full preset) | Which introspectors to run |
 | `context_mode` | Symbol | `:compact` | `:compact` or `:full` |
 | `claude_max_lines` | Integer | `150` | Max lines for CLAUDE.md in compact mode |
 | `max_tool_response_chars` | Integer | `200_000` | Safety cap for MCP tool responses |
@@ -1332,7 +1302,7 @@ All split rules include an app overview file, so no context is lost when root fi
 
 ## Introspectors — Full List
 
-### Standard preset (19 introspectors)
+### Standard preset (17 introspectors)
 
 Core Rails structure only. Use `config.preset = :standard` for a lighter footprint.
 
@@ -1349,16 +1319,14 @@ Core Rails structure only. Use `config.preset = :standard` for a lighter footpri
 | `migrations` | Total count, schema version, pending migrations, recent migration history with detected actions (create_table, add_column, etc.), migration statistics. |
 | `config` | Cache store, session store, timezone, queue adapter, mailer settings, middleware stack, initializers, credentials status, CurrentAttributes classes. |
 | `stimulus` | Stimulus controllers with targets, values (with types), actions, outlets, classes. Extracted from JS/TS files. |
-| `view_templates` | View file contents, partial references, Stimulus data attributes, UI pattern extraction, model field usage in partials. |
-| `design_tokens` | Auto-detects CSS framework (Tailwind v3/v4, Bootstrap, Sass, plain CSS) and extracts design tokens from config files and built CSS. |
+| `view_templates` | View file contents, partial references, Stimulus data attributes, model field usage in partials. |
 | `components` | ViewComponent/Phlex components: props, slots, previews, sidecar assets, usage examples. |
 | `turbo` | Turbo Frames (IDs and files), Turbo Stream templates, model broadcasts (`broadcasts_to`, `broadcasts`). |
 | `auth` | Devise models with modules, Rails 8 built-in auth, has_secure_password, Pundit policies, CanCanCan, CORS config, CSP config. |
-| `accessibility` | ARIA attributes, semantic HTML elements, screen reader text, alt text coverage, landmark roles, accessibility score. |
 | `performance` | N+1 query risks, missing counter_cache, missing FK indexes, Model.all anti-patterns, eager load candidates. |
 | `i18n` | Default locale, available locales, locale files with key counts, backend class, parse errors. |
 
-### Full preset (33 introspectors) — default
+### Full preset (31 introspectors) — default
 
 Includes all standard introspectors plus:
 
@@ -1481,11 +1449,11 @@ OpenCode uses **per-directory lazy-loading**: when the agent reads a file, it wa
 
 | Setup | Coverage | Notes |
 |-------|----------|-------|
-| Rails full-stack (ERB + Hotwire) | 32/32 | All introspectors relevant |
-| Rails + Inertia.js (React/Vue) | ~25/32 | Views/Turbo partially useful, backend fully covered |
-| Rails API + React/Next.js SPA | ~23/32 | Schema, models, routes, API, auth, jobs — all covered |
-| Rails API + mobile app | ~23/32 | Same as SPA — backend introspection is identical |
-| Rails engine (mountable gem) | ~18/32 | Core introspectors (schema, models, routes, gems) work |
+| Rails full-stack (ERB + Hotwire) | 31/31 | All introspectors relevant |
+| Rails + Inertia.js (React/Vue) | ~25/31 | Views/Turbo partially useful, backend fully covered |
+| Rails API + React/Next.js SPA | ~23/31 | Schema, models, routes, API, auth, jobs — all covered |
+| Rails API + mobile app | ~23/31 | Same as SPA — backend introspection is identical |
+| Rails engine (mountable gem) | ~18/31 | Core introspectors (schema, models, routes, gems) work |
 
 Frontend introspectors (views, Turbo, Stimulus, assets) degrade gracefully — they report nothing when those features aren't present.
 

data/exe/rails-ai-context

@@ -23,7 +23,7 @@ class RailsAiContextCLI < Thor
     # Let Thor pass unknown options through to ToolRunner for the tool command
     stop_on_unknown_option! :tool
 
-    desc "tool [NAME]", "Run an MCP tool (39 available). Use --list to see all."
+    desc "tool [NAME]", "Run an MCP tool (38 available). Use --list to see all."
     option :json, type: :boolean, default: false, desc: "Output as JSON envelope"
     option :list, type: :boolean, default: false, desc: "List available tools"
     def tool(name = nil, *args)
@@ -74,6 +74,13 @@ class RailsAiContextCLI < Thor
     def context
       boot_rails!
 
+      if options[:format]
+        cleanup_tools = options[:format] == "all" ? nil : [ options[:format].to_sym ]
+      else
+        cleanup_tools = ::RailsAiContext.configuration.ai_tools
+      end
+      ::RailsAiContext::LegacyCleanup.prompt_legacy_files(cleanup_tools, root: Dir.pwd)
+
       $stderr.puts "Introspecting Rails app..."
 
       if options[:format]
@@ -151,6 +158,12 @@ class RailsAiContextCLI < Thor
       # --- Cleanup removed tools ---
       cleanup_removed_tools(previous_tools, ai_tools) if previous_tools&.any?
 
+      # --- One-time v5.0.0 legacy UI-pattern files cleanup prompt ---
+      # Boot Rails lazily: we need the gem loaded to access LegacyCleanup.
+      # But we avoid booting Rails here — require just the legacy_cleanup file.
+      require_relative "../lib/rails_ai_context/legacy_cleanup"
+      ::RailsAiContext::LegacyCleanup.prompt_legacy_files(ai_tools, root: Dir.pwd)
+
       # --- Write .rails-ai-context.yml ---
       write_yaml_config(ai_tools, tool_mode)
 
@@ -362,7 +375,7 @@ class RailsAiContextCLI < Thor
       $stderr.puts ""
       $stderr.puts "Commands:"
       $stderr.puts "  rails-ai-context context    # Regenerate context files"
-      $stderr.puts "  rails-ai-context tool NAME  # Run any of the 39 tools"
+      $stderr.puts "  rails-ai-context tool NAME  # Run any of the 38 tools"
       if tool_mode == :mcp
         $stderr.puts "  rails-ai-context serve      # Start MCP server"
       end

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

@@ -175,7 +175,7 @@ module RailsAiContext
             #   :full     — all #{RailsAiContext::Configuration::PRESETS[:full].size} introspectors (default)
             #   :standard — #{RailsAiContext::Configuration::PRESETS[:standard].size} core introspectors (schema, models, routes, jobs, gems,
             #               conventions, controllers, tests, migrations, stimulus,
-            #               view_templates, design_tokens, config, components)
+            #               view_templates, config, components)
             # config.preset = :full
 
             # Context mode: :compact (default, ≤150 lines) or :full (dumps everything)
@@ -429,6 +429,11 @@ module RailsAiContext
 
         require "rails_ai_context"
 
+        # One-time v5.0.0 legacy UI-pattern files cleanup prompt
+        RailsAiContext::LegacyCleanup.prompt_legacy_files(
+          @selected_formats, root: Rails.root
+        )
+
         @selected_formats.each do |fmt|
           begin
             result = RailsAiContext.generate_context(format: fmt)
@@ -454,9 +459,9 @@ module RailsAiContext
         say ""
         say "Commands:", :yellow
         say "  rails ai:context         # Regenerate context files"
-        say "  rails 'ai:tool[schema]'    # Run any of the 39 tools from CLI"
+        say "  rails 'ai:tool[schema]'    # Run any of the 38 tools from CLI"
         if @tool_mode == :mcp
-          say "  rails ai:serve           # Start MCP server (39 live tools)"
+          say "  rails ai:serve           # Start MCP server (38 live tools)"
         end
         say "  rails ai:doctor          # Check AI readiness"
         say "  rails ai:inspect         # Print introspection summary"

data/lib/rails_ai_context/configuration.rb

@@ -71,12 +71,12 @@ module RailsAiContext
 
     PRESETS = {
       standard: %i[schema models routes jobs gems conventions controllers tests migrations stimulus
-                   view_templates design_tokens config components
-                   turbo auth accessibility performance i18n],
-      full: %i[schema models routes jobs gems conventions stimulus database_stats controllers views view_templates design_tokens turbo
+                   view_templates config components
+                   turbo auth performance i18n],
+      full: %i[schema models routes jobs gems conventions stimulus database_stats controllers views view_templates turbo
                i18n config active_storage action_text auth api tests rake_tasks assets
                devops action_mailbox migrations seeds middleware engines multi_database
-               components accessibility performance frontend_frameworks]
+               components performance frontend_frameworks]
     }.freeze
 
     # MCP server settings
@@ -143,7 +143,7 @@ module RailsAiContext
     attr_accessor :max_file_size          # Per-file read limit for tools (default: 2MB)
     attr_accessor :max_test_file_size     # Test file read limit (default: 500KB)
     attr_accessor :max_schema_file_size   # schema.rb / structure.sql parse limit (default: 10MB)
-    attr_accessor :max_view_total_size    # Total aggregated view content for UI patterns (default: 5MB)
+    attr_accessor :max_view_total_size    # Total aggregated view content for template scanning (default: 5MB)
     attr_accessor :max_view_file_size     # Per-view file during aggregation (default: 500KB)
     attr_accessor :max_search_results     # Max search results per call (default: 100)
     attr_accessor :max_validate_files     # Max files per validate call (default: 20)
@@ -151,7 +151,7 @@ module RailsAiContext
     # Additional MCP tool classes to register alongside built-in tools
     attr_accessor :custom_tools
 
-    # Built-in tool names to skip (e.g. %w[rails_security_scan rails_get_design_system])
+    # Built-in tool names to skip (e.g. %w[rails_security_scan rails_query])
     attr_accessor :skip_tools
 
     # Which AI tools to generate context for (selected during install)

data/lib/rails_ai_context/introspector.rb

@@ -69,7 +69,6 @@ module RailsAiContext
       when :controllers    then Introspectors::ControllerIntrospector.new(app)
       when :views          then Introspectors::ViewIntrospector.new(app)
       when :view_templates then Introspectors::ViewTemplateIntrospector.new(app)
-      when :design_tokens  then Introspectors::DesignTokenIntrospector.new(app)
       when :turbo          then Introspectors::TurboIntrospector.new(app)
       when :i18n           then Introspectors::I18nIntrospector.new(app)
       when :config         then Introspectors::ConfigIntrospector.new(app)
@@ -88,7 +87,6 @@ module RailsAiContext
       when :engines         then Introspectors::EngineIntrospector.new(app)
       when :multi_database  then Introspectors::MultiDatabaseIntrospector.new(app)
       when :components      then Introspectors::ComponentIntrospector.new(app)
-      when :accessibility   then Introspectors::AccessibilityIntrospector.new(app)
       when :performance     then Introspectors::PerformanceIntrospector.new(app)
       when :frontend_frameworks then Introspectors::FrontendFrameworkIntrospector.new(app)
       else