railstart 0.4.3 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19e0e8c63924f2843dc08337513ca8febb437e05b3980c08bd82187ba2df7b5a
-  data.tar.gz: 1eb0505613f463b428b885518cf1a60fbc4ccfae34a365ecf703779231bc1a2a
+  metadata.gz: 335bb58fb0448ef183a5dab96d9d866e212d75a09310db0ed4c017d9e27cf327
+  data.tar.gz: 42fea9cfc2d16dc6b167eb8580f108d43a940f6809de97c308cc64d467bb5056
 SHA512:
-  metadata.gz: 9b4b40a19194ff3eba2e11f364c70b394ac5ce2d58df45f40b7efa74629ae7533ed1619ee3b01672133cb5000258f4caf99b2b9d91053689f4cf33456cd26720
-  data.tar.gz: e87d1cec832d42aca5b77276198b76baa0acd6fa1a8b1e92af28be6202671288fcc4cc773f15ee16c87d7a61f2ac986fa2d84ff58671a723c56f41847396220e
+  metadata.gz: a7b8a26a4060fc6e1c449ab759d5dbbf8911ceba0166a8ce5b094fe81f069ee70b38c9ee88671f38e91eb4f1a6cb4f334815c8457efccc570a9fc57d94f7bf12
+  data.tar.gz: 29d65e728974f716e6d514135f574b48a7b335842c9330e6457553462bf943dcc5b9beead5e5c5bcfb4212a8c6b30301f689df342e861e2e7f83bfce345f6729

data/CHANGELOG.md

@@ -5,6 +5,27 @@ 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.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.4.5] - 2026-04-30
+
+### Added
+- **Example configs**: Added copyable `examples/` YAML files for global defaults, API apps, standard PostgreSQL apps, minimal SQLite apps, Vite/Bun apps, and template post-actions
+
+### Changed
+- **Agent guidance**: Tracked `AGENTS.md` in git while excluding it from gem builds
+
+## [0.4.4] - 2026-04-30
+
+### Changed
+- **Agent skill**: Refactored `.agents/skills/railstart-coder/` into a lean skill with focused reference files for CLI usage, presets, post-actions, and gem development
+- **Agent metadata**: Added `agents/openai.yaml` metadata for the railstart skill
+- **Gem packaging**: Excluded local `.omx/` orchestration state from gem builds
+- **README**: Updated the skill section to describe the agent-oriented skill layout
+
+### Removed
+- **Redundant preset skill doc**: Removed `docs/railstart-preset-builder/SKILL.md`; preset authoring guidance now lives in `.agents/skills/railstart-coder/references/`
+
 ## [0.4.3] - 2026-01-04
 
 ### Added
@@ -26,7 +47,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **CRITICAL ARCHITECTURE FIX**: Fixed `multi_select` question defaults to use stable choice **values** (internal IDs like "action_mailer") instead of fragile display **names** (like "Action Mailer"). This prevents preset breakage when display text changes.
   - Updated `lib/railstart/generator.rb` `ask_multi_select` method to transform values → names at the TTY::Prompt boundary
   - Updated `config/presets/api-only.yaml` to use values in defaults
-  - Updated all examples in `docs/railstart-preset-builder/SKILL.md` to use values
+  - Updated preset documentation examples to use values
   - Added comprehensive test coverage (3 new tests) validating transformation and storage behavior
 - **Documentation**: Corrected SKILL.md to explain values-based approach with stability rationale
 - Improved discoverability of configuration options - users no longer need to guess what can be configured

data/README.md

@@ -143,15 +143,15 @@ railstart new my_app --preset api-only --default
 
 ## Creating Custom Presets
 
-Presets are powerful tools for defining opinionated Rails configurations for specific stacks or team standards. For comprehensive guidance on creating presets, see **[Creating Presets Guide](docs/railstart-preset-builder/SKILL.md)**.
+Presets are powerful tools for defining opinionated Rails configurations for specific stacks or team standards.
 
 ### Quick Preset Creation
 
-Create a new preset file in `config/presets/{name}.yaml`:
+Create a new preset file in `~/.config/railstart/presets/{name}.yaml`:
 
 ```yaml
 ---
-# My Team Preset - PostgreSQL + RSpec + Vite
+# My Team Preset - PostgreSQL + Tailwind + Importmap
 
 questions:
   - id: database
@@ -160,23 +160,21 @@ questions:
         value: postgresql
         default: true
 
-  - id: javascript
+  - id: css
     choices:
-      - name: Vite (via vite_rails gem)
-        value: vite
+      - name: Tailwind
+        value: tailwind
         default: true
 
-  - id: test_framework
+  - id: javascript
     choices:
-      - name: RSpec
-        value: rspec
+      - name: Importmap
+        value: importmap
         default: true
+        rails_flag: "--javascript=importmap"
 
 post_actions:
-  - id: setup_vite
-    enabled: true
-
-  - id: setup_rspec
+  - id: init_git
     enabled: true
 ```
 
@@ -198,16 +196,29 @@ Railstart includes several ready-to-use presets:
 - **`api-only`** - Minimal Rails for JSON APIs (no views, no frontend)
 - **`vite-bun`** - Modern SPA with Vite + Bundlebun
 
-### Learn More
+### Example YAML Files
+
+This repository also includes copyable YAML examples in `examples/`:
+
+- `examples/config.yml` - global defaults for `~/.config/railstart/config.yaml`
+- `examples/presets/api-postgresql.yml` - JSON API service with PostgreSQL
+- `examples/presets/standard-postgresql.yml` - full-stack PostgreSQL app
+- `examples/presets/minimal-sqlite.yml` - lightweight local prototype app
+- `examples/presets/vite-bun.yml` - Vite, Bun, Tailwind, and PostgreSQL
+- `examples/presets/template-action.yml` - template post-action reference
+
+Use a preset example directly by passing its path:
 
-For detailed documentation including:
-- Available questions and post-actions
-- ID-based merging system
-- Step-by-step workflow
-- Real-world examples
-- Best practices and troubleshooting
+```bash
+railstart new my_app --preset ./examples/presets/standard-postgresql.yml --default
+```
 
-See the comprehensive **[Creating Presets Guide](docs/railstart-preset-builder/SKILL.md)**.
+Or copy one into your user presets directory:
+
+```bash
+cp examples/presets/standard-postgresql.yml ~/.config/railstart/presets/standard-postgresql.yml
+railstart new my_app --preset standard-postgresql --default
+```
 
 ## Configuration
 
@@ -411,6 +422,10 @@ Merging is by `id` for both `questions` and `post_actions`, allowing surgical ov
 - **Command Builder** (`lib/railstart/command_builder.rb`) - Translates answers to `rails new` flags
 - **CLI** (`lib/railstart/cli.rb`) - Thor command interface with `--preset` option
 
+## AI Agent Skill
+
+Railstart ships with an agent skill at `.agents/skills/railstart-coder/` for Codex- and Claude-style coding agents. The skill is structured as a lean `SKILL.md` plus focused reference files covering CLI usage, config layering, preset authoring, template post-actions, and gem development.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/dpaluy/railstart.
@@ -418,3 +433,5 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/dpaluy
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+Supported by [Majestic Labs](https://majesticlabs.dev/).

data/lib/railstart/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railstart
-  VERSION = "0.4.3"
+  VERSION = "0.4.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railstart
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.5
 platform: ruby
 authors:
 - dpaluy