chiron 0.1.0

data/lib/chiron/templates/commands/workflows/generate-tasks.md

@@ -0,0 +1,65 @@
+# Generating a Task List from a PRD
+
+## Goal
+
+To create a detailed, step-by-step task list in Markdown format based on an existing Product Requirements Document (PRD). The task list should guide a developer through implementation.
+
+## Output
+
+- **Format:** Markdown (`.md`)
+- **Location:** `/tasks/`
+- **Filename:** `tasks-[prd-file-name].md` (e.g., `tasks-prd-user-profile-editing.md`)
+
+## Process
+
+1. **Receive PRD Reference:** The user points you to a specific PRD file
+2. **Analyze PRD:** Read and analyze the functional requirements, user stories, and other sections of the specified PRD.
+3. **Phase 1: Generate Parent Tasks:** Based on the PRD analysis, create the file and generate the main, high-level tasks required to implement the feature. Use your judgement on how many high-level tasks to use. It's likely to be about 5. Present these tasks to the user in the specified format (without sub-tasks yet). Inform the user: "I have generated the high-level tasks based on the PRD. Ready to generate the sub-tasks? Respond with 'Go' to proceed."
+4. **Wait for Confirmation:** Pause and wait for the user to respond with "Go".
+5. **Phase 2: Generate Sub-Tasks:** Once the user confirms, break down each parent task into smaller, actionable sub-tasks necessary to complete the parent task. Ensure sub-tasks logically follow from the parent task and cover the implementation details implied by the PRD.
+6. **Identify Relevant Files:** Based on the tasks and PRD, identify potential files that will need to be created or modified. List these under the `Relevant Files` section, including corresponding test files if applicable.
+7. **Generate Final Output:** Combine the parent tasks, sub-tasks, relevant files, and notes into the final Markdown structure.
+8. **Save Task List:** Save the generated document in the `/tasks/` directory.
+
+## Output Format
+
+The generated task list _must_ follow this structure:
+
+```markdown
+## Relevant Files
+
+- `path/to/potential/file1.rb` - Brief description of why this file is relevant
+- `spec/path/to/file1_spec.rb` - Unit tests for file1
+- `app/controllers/example_controller.rb` - Controller for handling requests
+- `spec/requests/example_spec.rb` - Request specs for controller
+
+### Notes
+
+- Write tests before implementation (TDD approach)
+- Run `bin/rspec` to execute tests
+- Use `bin/rubocop --autocorrect` after implementation
+
+## Tasks
+
+- [ ] 1.0 Parent Task Title
+  - [ ] 1.1 [Sub-task description 1.1]
+  - [ ] 1.2 [Sub-task description 1.2]
+- [ ] 2.0 Parent Task Title
+  - [ ] 2.1 [Sub-task description 2.1]
+- [ ] 3.0 Parent Task Title (may not require sub-tasks if purely structural or configuration)
+```
+
+## Interaction Model
+
+The process explicitly requires a pause after generating parent tasks to get user confirmation ("Go") before proceeding to generate the detailed sub-tasks. This ensures the high-level plan aligns with user expectations before diving into details.
+
+## Target Audience
+
+Assume the primary reader of the task list is a **junior developer** who will implement the feature.
+
+## Important Notes
+
+- Include estimated time for complex tasks
+- Note dependencies between tasks
+- Mark critical path items
+- Update development journal after task completion

data/lib/chiron/templates/commands/workflows/process-tasks.md

@@ -0,0 +1,84 @@
+# Processing Task Lists
+
+## Goal
+
+To systematically work through task lists created from PRDs, ensuring proper implementation, testing, and documentation.
+
+## Process
+
+1. **Load Task List:** Read the relevant `tasks-*.md` file
+2. **Review Parent Tasks:** Understand the overall implementation plan
+3. **Select Next Task:** Choose the next uncompleted task in logical order
+4. **Mark In Progress:** Update task checkbox to indicate work has started
+5. **Implement:** Write code following TDD principles
+6. **Test:** Ensure all tests pass
+7. **Quality Check:** Run RuboCop and fix violations
+8. **Mark Complete:** Update task checkbox when done
+9. **Journal Entry:** Add development journal entry for significant work
+10. **Repeat:** Continue with next task
+
+## Task Status Indicators
+
+- `[ ]` - Not started
+- `[~]` - In progress (manually update)
+- `[x]` - Completed
+- `[!]` - Blocked (add note explaining blockage)
+
+## Best Practices
+
+### Before Starting a Task
+- Review related PRD section
+- Check for dependencies on other tasks
+- Ensure test environment is ready
+- Pull latest changes from main branch
+
+### During Implementation
+- Write tests first (TDD)
+- Commit frequently with clear messages
+- Update task status as you work
+- Note any discoveries or issues
+
+### After Completing a Task
+- Run full test suite
+- Check code quality with RuboCop
+- Update task list with completion
+- Add journal entry if significant
+- Consider creating follow-up tasks
+
+## Common Patterns
+
+### Feature Implementation
+1. Create model/migration
+2. Write model specs
+3. Implement model logic
+4. Create controller
+5. Write request specs
+6. Implement controller actions
+7. Create views/components
+8. Add system tests
+9. Style with TailwindCSS
+10. Add Stimulus controllers
+
+### Bug Fixes
+1. Reproduce the issue
+2. Write failing test
+3. Implement fix
+4. Verify test passes
+5. Check for regressions
+6. Update documentation
+
+## Task Dependencies
+
+When tasks have dependencies:
+- Note dependency in task description
+- Complete prerequisite tasks first
+- Update dependent tasks if scope changes
+- Communicate blockers in journal
+
+## Progress Tracking
+
+- Update task status immediately
+- Add time estimates and actuals
+- Note any scope changes
+- Track blockers and resolutions
+- Regular status updates in journal

data/lib/chiron/templates/development_journal.md.erb

@@ -0,0 +1,80 @@
+# <%= @project_name %> Development Journal
+
+This journal tracks significant development work, bug fixes, and feature implementations for <%= @project_name %>.
+
+## Recent Contributors (Last 30 Days)
+- **[Your Name]**: Project owner, initial setup
+- **Claude Code**: AI-assisted development
+
+## Active Branches & Ownership
+- `main`: Stable branch for production releases
+- `[feature-branch]`: [Developer Name] - [Feature description]
+
+---
+
+## <%= Date.today.strftime('%Y-%m-%d') %> - Initial Setup
+**Developer(s)**: [Your Name] & Claude Code | **Context**: Project initialization
+
+### What Was Done
+- Initialized Rails <%= Rails.version rescue "8.0.2" %> application
+- Set up Claude workflow with claude-rails-setup gem
+- Created initial project structure
+- Configured development environment
+
+### Why It Was Done
+- Starting new Rails project with AI-assisted development workflow
+- Establishing consistent development patterns from the beginning
+- Setting up for collaborative development
+
+### Technical Details
+- Rails <%= Rails.version rescue "8.0.2" %> with PostgreSQL database
+- Hotwire (Turbo + Stimulus) for frontend interactivity
+- TailwindCSS for styling
+- RSpec for testing framework
+- Claude AI workflow integration
+
+### Results
+- ✅ Rails application created and running
+- ✅ Claude workflow initialized with commands and templates
+- ✅ Development journal started
+- ✅ Git repository initialized
+
+### Next Steps
+- Configure database and run initial migrations
+- Set up continuous integration
+- Implement initial models based on requirements
+- Create first PRD for core functionality
+
+---
+
+<!-- 
+Journal Entry Template - Copy for new entries:
+
+## [YYYY-MM-DD] - [Brief Summary Title]
+**Developer(s)**: [Name] | **Context**: [How work was initiated]
+
+### What Was Done
+- [Specific actions taken]
+- [Files modified with line numbers]
+- [Commands run]
+
+### Why It Was Done  
+- [Problem being solved]
+- [User need addressed]
+
+### Technical Details
+- [Key implementation details]
+- [Architecture decisions]
+- [Testing approach]
+
+### Results
+- [What works now]
+- [Test results]
+- [Performance impacts]
+
+### Next Steps (if applicable)
+- [Follow-up tasks]
+- [Known issues]
+
+---
+-->

data/lib/chiron/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Chiron
+  VERSION = '0.1.0'
+end

data/lib/chiron.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative 'chiron/version'
+require_relative 'chiron/cli'
+
+module Chiron
+  class Error < StandardError; end
+
+  def self.root
+    File.expand_path('..', __dir__)
+  end
+
+  def self.templates_path
+    File.join(root, 'lib', 'chiron', 'templates')
+  end
+end

metadata

@@ -0,0 +1,174 @@
+--- !ruby/object:Gem::Specification
+name: chiron
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Brett McHargue
+bindir: exe
+cert_chain: []
+date: 2025-07-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: A Ruby gem that sets up Claude AI development workflows, PRD templates,
+  and journaling system for Rails projects
+email:
+- ebrett@users.noreply.github.com
+executables:
+- chiron
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rspec_status"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- docs/development_journal.md
+- exe/chiron
+- lib/chiron.rb
+- lib/chiron/cli.rb
+- lib/chiron/templates/CLAUDE.md.erb
+- lib/chiron/templates/claude/settings.json
+- lib/chiron/templates/commands/context/catchup.md
+- lib/chiron/templates/commands/context/prime.md
+- lib/chiron/templates/commands/context/quickstart.md
+- lib/chiron/templates/commands/conventions/rails.md
+- lib/chiron/templates/commands/journal/instructions.md
+- lib/chiron/templates/commands/journal/template.md
+- lib/chiron/templates/commands/quality/pre-commit.md
+- lib/chiron/templates/commands/quality/test-driven.md
+- lib/chiron/templates/commands/workflows/create-prd.md
+- lib/chiron/templates/commands/workflows/feature-complete.md
+- lib/chiron/templates/commands/workflows/generate-tasks.md
+- lib/chiron/templates/commands/workflows/process-tasks.md
+- lib/chiron/templates/development_journal.md.erb
+- lib/chiron/version.rb
+homepage: https://github.com/ebrett/chiron
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ebrett/chiron
+  source_code_uri: https://github.com/ebrett/chiron
+  changelog_uri: https://github.com/ebrett/chiron/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Initialize Claude AI workflow for Rails projects
+test_files: []