chiron 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b1bedffbe29eddeb944137d4f3e986b45d20acfac3ddefa8d5f731efa1c7bc76
+  data.tar.gz: 1c710a2bb2eb67b01ae126f38d2853edc0527c7536832a6a691a94d896d4d79c
+SHA512:
+  metadata.gz: f1a40196a2c48302fec0be7bdba442d21386bcd8e0b2f3b88174e32f2927bec876c5673ee018e9c23cf1dd46b299ae1a628acc9b831b26c12d4da86c801913ea
+  data.tar.gz: 93668d0ac4144e80aa5b80172bad66706db730d1068f6250a2e18e3ee621479d1ca09ae118abc6b615f4b05e6b332342a53913c09fb1c392b633fa2275316344

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rspec_status

@@ -0,0 +1,7 @@
+example_id                             | status | run_time        |
+-------------------------------------- | ------ | --------------- |
+./spec/claude_rails_setup_spec.rb[1:1] | passed | 0.00042 seconds |
+./spec/cli_spec.rb[1:1:1]              | failed | 0.02051 seconds |
+./spec/cli_spec.rb[1:1:2]              | failed | 0.00553 seconds |
+./spec/cli_spec.rb[1:1:3]              | failed | 0.00268 seconds |
+./spec/cli_spec.rb[1:2:1]              | passed | 0.00101 seconds |

data/.rubocop.yml

@@ -0,0 +1,24 @@
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'bin/**/*'
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: single_quotes
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Layout/LineLength:
+  Max: 120

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+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.1.0] - 2025-01-21
+
+### Added
+- Initial release of Chiron gem (renamed from claude_rails_setup)
+- CLI command `chiron init` to initialize Claude AI workflows in Rails projects
+- PRD workflow templates for structured feature development
+- Task generation and management system
+- Development journal functionality
+- Quality assurance workflows and pre-commit checklists
+- Migration tool from `.cursor` to `.claude` directory structure
+- Comprehensive test suite with RSpec
+- GitHub Actions CI/CD pipeline
+- Support for Ruby 3.0+ and Rails projects
+
+### Features
+- **Quick Setup**: Initialize Claude workflow with one command
+- **PRD Workflow**: Structured Product Requirements Document creation
+- **Task Management**: Generate and track implementation tasks
+- **Development Journal**: Track progress and maintain project history
+- **Migration Tool**: Easy migration from `.cursor` to `.claude` structure
+- **Quality Checks**: Pre-commit checklists and TDD workflows
+- **Customizable**: Adapt workflows to your team's needs
+
+[Unreleased]: https://github.com/ebrett/chiron/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/ebrett/chiron/releases/tag/v0.1.0

data/CLAUDE.md

@@ -0,0 +1,108 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Chiron is a Ruby gem that initializes Claude AI development workflows, PRD templates, and journaling system for Rails projects. Named after the wise centaur who mentored heroes, Chiron helps developers set up structured development processes that integrate seamlessly with Claude Code.
+
+## Development Commands
+
+**Important**: Always use bundle exec for consistency in gem development.
+
+```bash
+# Setup
+bundle install
+
+# Testing
+bundle exec rspec                    # Run all tests
+bundle exec rspec spec/cli_spec.rb   # Run specific test file
+
+# Code quality
+bundle exec rubocop                  # Linting
+bundle exec rubocop --autocorrect    # Auto-fix correctable violations
+
+# Gem development
+gem build chiron.gemspec            # Build gem
+gem install chiron-*.gem            # Install locally
+```
+
+## Architecture Overview
+
+### Core Classes
+- `Chiron::CLI` - Thor-based command line interface
+- `Chiron::VERSION` - Gem version constant
+
+### Key Features
+- Template copying system for Claude workflows
+- ERB template processing for customizable files
+- Interactive project setup with TTY::Prompt
+- Migration support from .cursor to .claude structure
+
+## Technical Stack
+
+- **Framework**: Ruby gem with Thor CLI framework
+- **Dependencies**: 
+  - `thor` - Command line interface framework
+  - `tty-prompt` - Interactive command line prompts
+  - `colorize` - Terminal output coloring
+- **Testing**: RSpec with comprehensive test coverage
+- **Code Quality**: RuboCop for style enforcement
+- **CI/CD**: GitHub Actions for Ruby 3.0-3.3
+
+## Gem Structure
+
+```
+lib/
+├── chiron.rb                    # Main entry point
+└── chiron/
+    ├── version.rb              # Version constant
+    ├── cli.rb                  # CLI implementation
+    └── templates/              # Template files for Rails projects
+        ├── CLAUDE.md.erb       # Rails project CLAUDE.md template
+        ├── claude/settings.json
+        ├── commands/           # Workflow command templates
+        └── development_journal.md.erb
+```
+
+## Development Patterns
+
+### CLI Commands
+- `init` - Initialize Claude workflow in Rails project
+- `migrate-cursor` - Migrate from .cursor to .claude structure
+- `add-workflow` - Add specific workflow templates
+- `update` - Update workflows to latest version
+- `doctor` - Health check for Claude setup
+- `version` - Display gem version
+
+### Template System
+- ERB templates with project-specific variables
+- Modular command structure (workflows, conventions, context, journal, quality)
+- Customizable file copying with conditional logic
+
+### PRD Workflow
+- Use `.claude/commands/workflows/create-prd.md` for structured feature development
+- PRDs should be saved in `/tasks/` directory as `prd-[feature-name].md`
+- Follow the clarifying questions process before implementation
+
+### Code Quality
+- RuboCop for consistent styling
+- Comprehensive test coverage with RSpec
+- GitHub Actions CI for multi-Ruby version testing
+
+## Testing Standards
+
+- Write tests before implementation (TDD)
+- Maintain high test coverage
+- Mock file system operations in tests
+- Test CLI commands with temporary directories
+- Follow RSpec best practices
+
+## Important Reminders
+
+- Always run tests before committing
+- Use semantic commit messages
+- Update the development journal for significant changes
+- Follow the pre-commit checklist in `.claude/commands/quality/pre-commit.md`
+- Update CHANGELOG.md for notable changes
+- Test gem building and installation locally before releasing

data/Gemfile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in claude_rails_setup.gemspec
+gemspec
+
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.0'
+gem 'rubocop', '~> 1.21'
+
+# Development tools
+group :development do
+  gem 'pry'
+  gem 'yard'
+end

data/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: .
+  specs:
+    chiron (0.1.0)
+      colorize (~> 1.1)
+      thor (~> 1.3)
+      tty-prompt (~> 0.23)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    coderay (1.1.3)
+    colorize (1.1.0)
+    diff-lcs (1.6.2)
+    json (2.12.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    method_source (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    prism (1.4.0)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.0)
+    regexp_parser (2.10.0)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.4)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.4)
+    rubocop (1.77.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.45.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.45.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    thor (1.3.2)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.2)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    wisper (2.0.1)
+    yard (0.9.37)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  chiron!
+  pry
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.21)
+  yard
+
+BUNDLED WITH
+   2.6.4

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Brett McHargue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,155 @@
+# Chiron
+
+A Ruby gem that initializes Claude AI development workflows, PRD templates, and journaling system for Rails projects. Named after the wise centaur who mentored heroes, Chiron helps you quickly set up a structured development process that integrates seamlessly with Claude Code.
+
+## Features
+
+- 🚀 **Quick Setup**: Initialize Claude workflow with one command
+- 📋 **PRD Workflow**: Structured Product Requirements Document creation
+- ✅ **Task Management**: Generate and track implementation tasks
+- 📓 **Development Journal**: Track progress and maintain project history
+- 🔄 **Migration Tool**: Easy migration from `.cursor` to `.claude` structure
+- 🎯 **Quality Checks**: Pre-commit checklists and TDD workflows
+- 🛠️ **Customizable**: Adapt workflows to your team's needs
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'chiron'
+```
+
+And then execute:
+```bash
+bundle install
+```
+
+Or install it yourself as:
+```bash
+gem install chiron
+```
+
+## Usage
+
+### Initialize Claude Workflow
+
+In your Rails project root:
+
+```bash
+chiron init
+```
+
+This will:
+- Create `.claude/commands/` directory with workflow templates
+- Generate `CLAUDE.md` with project-specific configuration
+- Set up `tasks/` directory for PRDs and task lists
+- Initialize development journal in `docs/`
+- Update `.gitignore` appropriately
+
+### Command Options
+
+```bash
+# Initialize with options
+chiron init --project-name="MyApp" --with-viewcomponents
+
+# Migrate from .cursor to .claude
+chiron migrate-cursor
+
+# Add specific workflow
+chiron add-workflow test-driven
+
+# Update workflows to latest version
+chiron update
+
+# Check setup health
+chiron doctor
+```
+
+## Workflow Structure
+
+After initialization, you'll have:
+
+```
+your-rails-app/
+├── .claude/
+│   ├── commands/
+│   │   ├── workflows/      # Development workflows
+│   │   │   ├── create-prd.md
+│   │   │   ├── generate-tasks.md
+│   │   │   └── process-tasks.md
+│   │   ├── conventions/    # Language/framework rules
+│   │   │   └── rails.md
+│   │   ├── context/        # Context commands
+│   │   │   ├── quickstart.md
+│   │   │   └── catchup.md
+│   │   ├── journal/        # Journal management
+│   │   │   ├── instructions.md
+│   │   │   └── template.md
+│   │   └── quality/        # Quality assurance
+│   │       ├── pre-commit.md
+│   │       └── test-driven.md
+│   └── settings.json       # Claude permissions
+├── CLAUDE.md              # Project-specific Claude instructions
+├── tasks/                 # PRDs and task lists
+└── docs/
+    └── development_journal.md
+```
+
+## Key Workflows
+
+### 1. Creating a PRD
+When starting a new feature, Claude will:
+- Ask clarifying questions
+- Generate a structured PRD
+- Save it as `tasks/prd-[feature-name].md`
+
+### 2. Generating Tasks
+From a PRD, Claude will:
+- Create high-level tasks
+- Break them into subtasks
+- Save as `tasks/tasks-prd-[feature-name].md`
+
+### 3. Development Journal
+Claude maintains a journal with:
+- Daily work summaries
+- Technical decisions
+- Bug fixes and features
+- Multi-developer collaboration tracking
+
+### 4. Quality Checks
+Before committing:
+- Run the pre-commit checklist
+- Follow TDD workflow
+- Update documentation
+
+## Example Claude Commands
+
+After setup, you can tell Claude:
+
+- "Create a PRD for user authentication"
+- "Generate tasks from prd-user-auth.md"
+- "Catchup" (for project status)
+- "Update the journal"
+- "Run pre-commit checks"
+
+## Customization
+
+All templates are customizable. After initialization:
+1. Edit files in `.claude/commands/` to match your workflow
+2. Modify `CLAUDE.md` for project-specific instructions
+3. Add custom workflows as needed
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/ebrett/chiron.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/docs/development_journal.md

@@ -0,0 +1,60 @@
+# Development Journal - Chiron Gem
+
+## Project Overview
+Chiron is a Ruby gem that helps Rails developers set up Claude AI workflows, PRD templates, and development journaling systems.
+
+---
+
+## 2025-01-21 - Initial Setup and Module Rename
+
+### What was accomplished today:
+- Set up complete gem development infrastructure
+- Initialized git repository with proper .gitignore
+- Created comprehensive RSpec test suite (5 tests, all passing)
+- Set up GitHub Actions CI for Ruby 3.0-3.3
+- Added CHANGELOG.md and MIT LICENSE
+- Updated README with chiron branding and examples
+- Added RuboCop configuration and fixed style issues
+- Renamed module from `ClaudeRailsSetup` to `Chiron` throughout codebase
+- Updated email to GitHub no-reply address
+- Added Claude workflows to the gem itself (meta!)
+
+### Technical decisions made:
+- **Module Naming**: Changed from `ClaudeRailsSetup` to `Chiron` for better branding
+- **File Structure**: Moved `lib/claude_rails_setup/` to `lib/chiron/`
+- **Testing Strategy**: Used temporary directories and mocked TTY::Prompt for CLI tests
+- **CI/CD**: GitHub Actions with matrix testing across Ruby versions
+- **Code Quality**: RuboCop with single quotes, 120 character line length
+
+### Bugs fixed:
+- Fixed missing `Date` require in CLI for ERB template processing
+- Fixed missing `version` method in CLI class
+- Updated all module references after rename
+- Fixed test directory handling by using `Dir.chdir` instead of mocking
+
+### Features added:
+- Complete gem development infrastructure
+- Module rename from old name to Chiron
+- Self-hosting: Added Claude workflows to the gem itself using its own templates
+
+### Code quality metrics:
+- RSpec: 5 examples, 0 failures
+- RuboCop: 15 minor style violations (mostly method length, acceptable for CLI)
+- Test Coverage: CLI functionality well covered
+
+### Next steps:
+- Create GitHub repository and push code
+- Test gem building and installation
+- Consider adding more comprehensive CLI tests
+- Add contribution guidelines
+- Prepare for RubyGems publishing
+
+### Notes:
+- The gem now "eats its own dog food" by using Claude workflows for its own development
+- All original functionality preserved during module rename
+- Ready for GitHub publication and RubyGems release
+
+---
+
+*Template: [Entry Date] - [Brief Summary]*
+*What was accomplished, technical decisions, bugs fixed, features added, next steps*

data/exe/chiron

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'chiron'
+
+Chiron::CLI.start(ARGV)