appydave-tools 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f220893e70bf53b9a6da3b1a46857c3221f2672aba453616e4bab5b87528d65
-  data.tar.gz: 1e5aef7918151c423393131dcfc8e2538cd6b95632b2a58dd8f23a1c864f1c06
+  metadata.gz: dfc47ae2c891b47ff973f7f5605c18f0d05f98f44045c7b40590d03d63fdf276
+  data.tar.gz: cd97470ff0937e41972b1777eabaaaf2da3321e2f0a8d1cd6845125b8a15d705
 SHA512:
-  metadata.gz: fe5e90a6677bcb82e0d1af5fde786eba72d2380f1dcbe291b4fe998b239f71c6381bd33b7dfa87755e2b9390d97241387422c84522d3763236e87688668ed861
-  data.tar.gz: 70abc6727a6e318d329097b42a72fc8de4061965d60e7d33d013fa361b00a1c6e3b9eabe94a7a15a5e993523ea6ba96b69231c83bdae0f030f16ad0ec4a1e50d
+  metadata.gz: c2ce45fd490af1172db2e274e733fdb329d9ef143078ada86f90aadc1cc4860bdde91c4ca19cf781dffd128de909118271ce9087657edfd6a7ad98c38ba68b94
+  data.tar.gz: 931ca82db8f193bb2b6f581d1691893ac8912949d37384d1a7f2baea35cf7fc90343c2234a259f73f69489a9405bd07c984699c0dc7716416103c65b9e8406bf

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.15.0](https://github.com/appydave/appydave-tools/compare/v0.14.1...v0.15.0) (2025-11-08)
+
+
+### Features
+
+* update claude and git leaks ([0b8212f](https://github.com/appydave/appydave-tools/commit/0b8212fa65a920c608876c4f4f37c166dc552039))
+
 ## [0.14.1](https://github.com/appydave/appydave-tools/compare/v0.14.0...v0.14.1) (2025-08-06)
 
 

data/CLAUDE.md

@@ -2,9 +2,48 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Project Purpose
+
+**AppyDave Tools** is a consolidated productivity toolkit built for AppyDave's YouTube content creation workflow. All utilities live in one repository for easier maintenance than managing separate codebases.
+
+**📖 See [docs/purpose-and-philosophy.md](./docs/purpose-and-philosophy.md) for complete philosophy and design principles.**
+
+**Key Points:**
+- **Consolidated toolkit** - One codebase for easier maintenance
+- **YouTube workflow** - Built specifically for content creator productivity
+- **Single-purpose tools** - Each tool solves one problem independently
+- **Shareable individually** - Tools can be featured in standalone videos
+- **Language flexible** - Currently Ruby, could be rewritten if needed
+
 ## Common Commands
 
 ### Development Setup
+
+**⚠️ IMPORTANT: Bundler Setup for Claude Code**
+
+This project requires Bundler 2.6.2. If you encounter `Could not find 'bundler' (2.6.2)` errors during Claude Code execution:
+
+**Automatic fix (recommended):**
+```bash
+eval "$(rbenv init -)" && gem install bundler:2.6.2
+```
+
+**Make permanent** - Add to your `.zshrc` or `.bashrc`:
+```bash
+# Add rbenv to PATH and initialize
+eval "$(rbenv init - zsh)"
+```
+
+**For Claude Code:** The `eval "$(rbenv init -)"` command is automatically prepended to bash commands when needed.
+
+**Manual verification:**
+```bash
+which ruby          # Should show: /Users/[user]/.rbenv/shims/ruby
+ruby --version      # Should show: ruby 3.4.2
+bundler --version   # Should show: Bundler version 2.6.2
+```
+
+**Standard setup:**
 ```bash
 bin/setup           # Install dependencies and setup development environment
 bin/console         # Interactive Ruby console for experimentation
@@ -16,15 +55,15 @@ bin/console         # Interactive Ruby console for experimentation
 
 #### Quick Reference Index
 
-| Command | Gem Command | Description |
-|---------|-------------|-------------|
-| **GPT Context** | `gpt_context` | Collect project files for AI context ⭐ |
-| **YouTube Manager** | `youtube_manager` | Manage YouTube video metadata via API |
-| **Subtitle Manager** | `subtitle_manager` | Process and join SRT subtitle files |
-| **Prompt Tools** | `prompt_tools` | AI prompt completion workflows |
-| **YouTube Automation** | `youtube_automation` | Automated YouTube workflows with GPT agents |
-| **Configuration** | `ad_config` | Manage appydave-tools configuration files |
-| **Move Images** | N/A (dev only) | Organize video project images (development tool) |
+| Command | Gem Command | Description | Status |
+|---------|-------------|-------------|--------|
+| **GPT Context** | `gpt_context` | Collect project files for AI context | ⭐ PRIMARY |
+| **YouTube Manager** | `youtube_manager` | CRUD operations on YouTube video metadata | ✅ ACTIVE |
+| **Subtitle Processor** | `subtitle_processor` | Transform SRT files (clean/merge) | ✅ ACTIVE |
+| **Configuration** | `ad_config` | Manage JSON configs (channels, paths, sequences) | ✅ ACTIVE |
+| **Move Images** | N/A (dev only) | Organize video asset images | ✅ ACTIVE |
+| **Prompt Tools** | `prompt_tools` | OpenAI Completion API wrapper | ⚠️ DEPRECATED API |
+| **YouTube Automation** | `youtube_automation` | Prompt sequence runner | ⚠️ INTERNAL USE |
 
 ---
 
@@ -73,21 +112,25 @@ bin/youtube_manager.rb update --video-id ID --category-id 28
 - Update video title, description, tags, and category
 - Generate detailed reports
 
-#### 3. Subtitle Manager (`bin/subtitle_manager.rb`)
+#### 3. Subtitle Processor (`bin/subtitle_processor.rb`)
 Process and manage SRT subtitle files:
 
 ```bash
 # Clean and normalize SRT files
-bin/subtitle_manager.rb clean -f input.srt -o cleaned.srt
+bin/subtitle_processor.rb clean -f input.srt -o cleaned.srt
 
 # Join multiple SRT files
-bin/subtitle_manager.rb join -d ./subtitles -f "*.srt" -o merged.srt
-bin/subtitle_manager.rb join -f "part1.srt,part2.srt" -s asc -b 100 -o final.srt
+bin/subtitle_processor.rb join -d ./subtitles -f "*.srt" -o merged.srt
+bin/subtitle_processor.rb join -f "part1.srt,part2.srt" -s asc -b 100 -o final.srt
 
 # Join with options
-bin/subtitle_manager.rb join -d ./subs -f "*.srt" -s inferred -b 200 -o output.srt -L detail
+bin/subtitle_processor.rb join -d ./subs -f "*.srt" -s inferred -b 200 -o output.srt -L detail
 ```
 
+**Operations:**
+- **clean**: Removes HTML tags (`<u>`), merges duplicate entries, normalizes spacing
+- **join**: Parses multiple SRT files, adjusts timestamps with buffer, merges timeline
+
 **Options:**
 - `-d, --directory` - Directory containing SRT files
 - `-f, --files` - File pattern or comma-separated list
@@ -95,22 +138,34 @@ bin/subtitle_manager.rb join -d ./subs -f "*.srt" -s inferred -b 200 -o output.s
 - `-b, --buffer` - Buffer between files in milliseconds (default: 100)
 - `-L, --log-level` - Log level: none, info, detail
 
-**Note:** Internal module is called `SubtitleMaster` but CLI tool is `subtitle_manager`
+**Use cases:** Cleaning YouTube auto-captions, merging FliVideo multi-part recording subtitles
 
-#### 4. Prompt Tools (`bin/prompt_tools.rb`)
-AI prompt completion workflows:
+**Note:** Renamed from `subtitle_manager` to `subtitle_processor` (accurate - processes files, doesn't manage state)
+
+#### 4. Prompt Tools (`bin/prompt_tools.rb`) ⚠️ DEPRECATED API
+OpenAI Completion API wrapper with template support:
 
 ```bash
-# Run AI prompt completion
-bin/prompt_tools.rb completion [options]
+# Run prompt from text
+bin/prompt_tools.rb completion -p "Your prompt" -o output.txt
+
+# Run prompt from file with placeholders
+bin/prompt_tools.rb completion -f template.md -k key1=value1,key2=value2 -c
 ```
 
-**Features:**
-- OpenAI GPT integration
-- Prompt execution and management
+**What it does:**
+- Sends prompts to OpenAI **Completion API** (older GPT-3 models like `davinci-codex`)
+- Supports template files with `{placeholder}` substitution
+- Outputs to file, clipboard, or stdout
+
+**Status:** ⚠️ **Not in active use** - Uses **deprecated OpenAI Completion API**
+
+**Modern alternative:** Use ChatGPT/Claude directly or migrate to OpenAI Chat API
+
+**Potential use cases:** Template-based content generation (if migrated to Chat API)
 
-#### 5. YouTube Automation (`bin/youtube_automation.rb`)
-Automated YouTube workflows using GPT agents:
+#### 5. YouTube Automation (`bin/youtube_automation.rb`) ⚠️ INTERNAL USE
+Prompt sequence runner for content workflows:
 
 ```bash
 # Run automation sequence
@@ -118,6 +173,21 @@ bin/youtube_automation.rb -s 01-1
 bin/youtube_automation.rb -s 01-1 -d  # with debug output
 ```
 
+**What it does:**
+- Loads sequence config from `~/.config/appydave/youtube_automation.json`
+- Reads prompt templates from Dropbox path (`_common/raw_prompts/`)
+- Executes OpenAI Completion API calls
+- Saves responses to output files
+
+**Requirements:**
+- Sequence definitions in JSON config
+- Prompt template files in configured Dropbox location
+- `OPENAI_ACCESS_TOKEN` environment variable
+
+**Status:** ⚠️ **Internal tool** - Hardcoded paths, deprecated API, not documented for external use
+
+**Relationship to Move Images:** These are separate tools - Move Images organizes downloaded images into video asset folders
+
 **Options:**
 - `-s, --sequence` - Sequence number (required, e.g., 01-1)
 - `-d, --debug` - Enable debug mode
@@ -140,9 +210,15 @@ bin/configuration.rb -e
 ```
 
 **Configuration Types:**
-- **settings** - General settings and paths
+- **settings** - General settings and paths (project folders: content, video, published, abandoned)
 - **channels** - YouTube channel definitions (code, name, youtube_handle)
-- **youtube_automation** - Automation workflow configurations
+- **youtube_automation** - Automation workflow configurations (prompt sequences)
+
+**Team Collaboration Features:**
+- **Shareable configs**: JSON files can be version-controlled (no secrets included)
+- **Per-developer paths**: Each team member customizes paths in their `~/.config/appydave/`
+- **Consistent structure**: Same channel codes/names across team
+- **Secrets separation**: API keys stored in `.env` files (gitignored), not in configs
 
 #### 7. Move Images (`bin/move_images.rb`)
 Organize and rename downloaded images into video project asset folders.
@@ -210,12 +286,20 @@ gem build           # Build gemspec into .gem file
 
 ## Architecture Overview
 
-This is a Ruby gem called `appydave-tools` that provides YouTube automation and content creation tools.
+`appydave-tools` is AppyDave's consolidated productivity toolkit for YouTube content creation. Single-purpose utilities in one repository for easier maintenance than separate codebases.
+
+**Philosophy:** See [docs/purpose-and-philosophy.md](./docs/purpose-and-philosophy.md) for project philosophy and design principles.
+
+**Tool Categories:**
+- AI & Context Management (GPT Context, Prompt Tools)
+- Content & Media (Subtitles, YouTube Manager, YouTube Automation, Move Images)
+- Configuration (Multi-channel config management)
 
 ### Core Structure
 - **CLI Tools**: Multiple executable scripts in `bin/` for different functionalities
 - **Modular Design**: Organized into focused modules under `lib/appydave/tools/`
-- **Configuration System**: Flexible config management with channel and project settings
+- **Independent Operation**: Each tool solves a specific problem standalone
+- **Configuration System**: Flexible config management for multi-project workflows
 - **Type System**: Custom type classes for data validation and transformation
 
 ### Key Components
@@ -242,7 +326,7 @@ This is a Ruby gem called `appydave-tools` that provides YouTube automation and
 - Caption/subtitle management
 - Detailed reporting capabilities
 
-#### Subtitle Management (`lib/appydave/tools/subtitle_manager/`)
+#### Subtitle Management (`lib/appydave/tools/subtitle_processor/`)
 - SRT file cleaning and normalization
 - Multi-part subtitle joining
 - Timeline synchronization

data/README.md

@@ -1,157 +1,333 @@
-# Appydave Tools
+# AppyDave Tools
 
-> AppyDave YouTube Automation Tools
+> **AppyDave's YouTube productivity toolkit** - Command-line utilities that automate the boring stuff so you can focus on creating content.
+
+## Why This Exists
+
+As a YouTuber, I got tired of repetitive tasks eating into my creative time. So I built tools to handle them.
+
+Instead of managing dozens of separate repositories, everything lives here - one codebase, easier maintenance, and each tool can be featured in its own video tutorial.
+
+**Quick wins:**
+- 🤖 Feed entire codebases to AI assistants in seconds
+- 📹 Batch update YouTube video metadata without clicking through the UI (update 50 videos in 5 minutes)
+- 📝 Process subtitle files - clean formatting, merge multi-part recordings, synchronize timelines
+- 🖼️ Organize downloaded images into project folders automatically (video asset workflow)
+- ⚙️ Manage multi-channel configurations from the command line (team-shareable JSON configs)
 
 ## Installation
 
-Add this line to your application's Gemfile:
+```bash
+gem install appydave-tools
+```
+
+Or add to your Gemfile:
 
 ```ruby
 gem 'appydave-tools'
 ```
 
-And then execute:
+## The Tools
+
+### 🤖 GPT Context Gatherer
+
+**The problem:** AI assistants need context about your code, but copying files is tedious.
+
+**The solution:** Automatically collect and format project files for AI context.
 
 ```bash
-bundle install
+# Gather all Ruby files, skip tests, save to clipboard
+gpt_context -i '**/*.rb' -e 'spec/**/*' -d
+
+# Get project structure as a tree
+gpt_context -i '**/*' -f tree -d
+
+# Multiple file types with custom output
+gpt_context -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -o context.txt
 ```
 
-Or install it yourself as:
+**Use cases:** Working with ChatGPT, Claude, or any AI assistant on your codebase.
+
+[Full documentation →](./docs/usage/gpt-context.md)
+
+---
+
+### 📹 YouTube Manager
+
+**The problem:** Updating video metadata through YouTube Studio is slow and repetitive, especially for bulk operations.
+
+**The solution:** Manage YouTube video metadata via API from your terminal - CRUD operations on videos.
 
 ```bash
-gem install appydave-tools
-```
+# Get video details (title, description, tags, category, captions)
+youtube_manager get --video-id YOUR_VIDEO_ID
 
-## Stories
+# Update title and description
+youtube_manager update --video-id YOUR_VIDEO_ID \
+  --title "New Title" \
+  --description "Updated description"
 
-### Main Story
+# Update tags (replaces existing tags)
+youtube_manager update --video-id YOUR_VIDEO_ID --tags "tutorial,productivity,automation"
 
-As a Content Creator, I want accellerate my video creation, so that I can improve speed and quality of my content
+# Update category
+youtube_manager update --video-id YOUR_VIDEO_ID --category-id 28
+```
 
-See all [stories](./STORIES.md)
+**Specific use cases:**
+- **Post-rebrand updates**: Changed channel name? Update 50 video descriptions in minutes
+- **Tag standardization**: Ensure consistent tagging across your entire catalog
+- **Metadata retrieval**: Export video details for analysis or backup
+- **Batch corrections**: Fix typos in titles across multiple videos
+- **Category changes**: Recategorize videos when YouTube updates categories
+- **Series updates**: Add series links to descriptions across episode batches
 
+**What it does:**
+- **Get**: Retrieves complete video metadata including captions
+- **Update**: Modifies title, description, tags, or category via YouTube Data API v3
+- **Authorization**: Handles OAuth2 flow with local callback server
+- **Reporting**: Generates detailed reports of video metadata
 
-## Usage
+**Why use this vs YouTube Studio:**
+- **Speed**: Update 20 videos in 5 minutes vs 30+ minutes clicking through UI
+- **Scriptable**: Integrate into automation workflows
+- **Bulk operations**: Loop through video IDs from a CSV
+- **Version control**: Track metadata changes in Git
+- **Backup**: Export all video metadata as JSON
 
-### CLI Tools
+---
 
-This gem provides several command-line tools for content creation and YouTube automation:
+### 📝 Subtitle Processor
 
-#### GPT Context Gatherer
-Collect and organize project files for AI context analysis:
+**The problem:** Raw subtitle files need cleanup, and multi-part recordings need merged subtitles.
 
-```bash
-# Basic usage - gather all Ruby files, exclude specs
-gpt_context -i '**/*.rb' -e 'spec/**/*' -d -o context.txt
+**The solution:** Process and transform SRT files - clean formatting, merge duplicates, synchronize timelines.
 
-# Multiple patterns with tree and content output
-gpt_context -i 'lib/**/*.rb' -i 'bin/**/*.rb' -f tree,content -d
+```bash
+# Clean auto-generated subtitles (removes HTML tags, merges duplicates, normalizes spacing)
+subtitle_processor clean -f input.srt -o cleaned.srt
 
-# Advanced filtering for web projects  
-gpt_context -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -e '**/_generated/**/*' -d -f tree -o typescript-files.txt
+# Merge multiple subtitle files with timeline synchronization
+subtitle_processor join -d ./parts -f "*.srt" -o final.srt
 
-# Documentation and config files
-gpt_context -i 'docs/**/*' -i '**/*.json' -i '**/*.config.*' -e '**/node_modules/**/*' -d -f tree
+# Custom time buffer between merged sections (in milliseconds)
+subtitle_processor join -f "part1.srt,part2.srt" -b 200 -o merged.srt
 ```
 
-See detailed usage guide: [GPT Context Gatherer](./docs/usage/gpt-context.md)
+**What it does:**
+- **Clean**: Removes `<u>` tags, merges duplicate entries, normalizes line breaks and spacing
+- **Join**: Parses multiple SRT files, adjusts timestamps with buffers, merges into single timeline
 
-#### YouTube Manager
-```bash
-# Get video details
-bin/youtube_manager.rb get [options]
+**Use cases:** Cleaning messy YouTube auto-captions, merging FliVideo multi-part recording subtitles.
+
+**Note:** CLI command is `subtitle_processor` (renamed from `subtitle_manager` for accuracy - this tool *processes* files, not manages state).
+
+---
+
+### 🎯 Prompt Tools *(Experimental - Not actively used)*
+
+**The problem:** Running OpenAI prompts with placeholder substitution and output management.
+
+**The solution:** Execute OpenAI completion API calls with template support.
 
-# Update video metadata  
-bin/youtube_manager.rb update [options]
+```bash
+# Run prompt from text
+prompt_tools completion -p "Your prompt here" -o output.txt
+
+# Run prompt from file with placeholders
+prompt_tools completion -f prompt_template.md -k topic=Ruby,style=tutorial -c
+
+# Options:
+# -p, --prompt     Inline prompt text
+# -f, --file       Prompt template file
+# -k, --placeholders  Key-value pairs for {placeholder} substitution
+# -o, --output     Save to file
+# -c, --clipboard  Copy to clipboard
+# -m, --model      OpenAI model to use
 ```
 
-#### Subtitle Manager
+**What it does:**
+- Sends prompts to OpenAI Completion API (older GPT-3 models)
+- Supports template files with `{placeholder}` substitution
+- Outputs to file, clipboard, or stdout
+
+**Current status:** ⚠️ **Not in active use** - Uses deprecated OpenAI Completion API (`davinci-codex`). Modern alternative: Use ChatGPT or Claude directly, or migrate to Chat API.
+
+**Potential use cases:** Template-based content generation, automated prompt workflows (if migrated to Chat API).
+
+---
+
+### ⚡ YouTube Automation *(Internal/Experimental)*
+
+**The problem:** Video content creation workflows involve multiple steps: research → scripting → production.
+
+**The solution:** Run predefined prompt sequences against OpenAI API to automate research and content generation steps.
+
 ```bash
-# Clean subtitle files
-bin/subtitle_manager.rb clean [options]
+# Run automation sequence (requires configuration)
+youtube_automation -s 01-1
 
-# Join multiple subtitle parts
-bin/subtitle_manager.rb join [options]
+# With debug output
+youtube_automation -s 01-1 -d
 ```
 
-#### Prompt Tools
+**What it does:**
+- Loads sequence configuration from `~/.config/appydave/youtube_automation.json`
+- Reads prompt templates from Dropbox (`_common/raw_prompts/`)
+- Executes OpenAI API calls for each sequence step
+- Saves responses to output files
+
+**Configuration required:**
+- Sequence definitions in `youtube_automation.json`
+- Prompt template files in configured Dropbox path
+- `OPENAI_ACCESS_TOKEN` environment variable
+
+**Current status:** ⚠️ **Internal tool** - Hardcoded Dropbox paths, uses deprecated Completion API, not documented for external use.
+
+**Relationship to other tools:** This is separate from **Move Images** tool (which organizes downloaded images into video project asset folders).
+
+**Use cases:** Automated content research, script outline generation, multi-step prompt workflows.
+
+---
+
+### ⚙️ Configuration Manager
+
+**The problem:** Managing settings for multiple YouTube channels, project paths, and automation sequences gets messy.
+
+**The solution:** Centralized JSON-based configuration stored in `~/.config/appydave/`.
+
 ```bash
-# Run AI prompt completion
-bin/prompt_tools.rb completion [options]
+# List all configurations
+ad_config -l
+
+# Create missing config files with templates
+ad_config -c
+
+# Edit configurations in VS Code
+ad_config -e
+
+# View specific configuration values
+ad_config -p settings,channels
+
+# View all configurations
+ad_config -p
 ```
 
+**What it manages:**
+- **settings.json**: Project folder paths (content, video, published, abandoned)
+- **channels.json**: YouTube channel definitions (code, name, youtube_handle)
+- **youtube_automation.json**: Automation sequence configurations
 
-## Development
+**Use cases:**
+- **Multi-channel management**: Switch between different YouTube channels
+- **Team collaboration**: Share configuration files via Git/Dropbox (excluding secrets)
+- **Workflow standardization**: Consistent paths across team members
+- **Automation setup**: Define reusable prompt sequences
+
+**Team collaboration notes:**
+- Configuration files can be version-controlled (they contain no secrets)
+- Each team member can maintain their own `~/.config/appydave/` directory
+- Paths can be customized per developer machine
+- Secrets (API keys) stored separately in `.env` files (gitignored)
+
+---
 
-Checkout the repo
+### 🖼️ Move Images *(Development tool)*
+
+**The problem:** Downloaded images need organizing with proper naming.
+
+**The solution:** Batch move and rename to project folders.
 
 ```bash
-git clone https://github.com/appydave/appydave-tools
+# Organize intro images for video project
+bin/move_images.rb -f b40 intro b40
+# Result: b40-intro-1.jpg, b40-intro-2.jpg in assets/intro/
 ```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. 
+**Use cases:** B-roll organization, thumbnail preparation.
 
-You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+---
 
-```bash
-bin/console
+## Philosophy
 
-Appydave::Tools::VERSION
-# => "0.14.0"
+**One codebase, multiple tools.** Easier to maintain than dozens of repos.
 
-# Access configuration
-config = Appydave::Tools::Configuration::Config.new
-# => #<Appydave::Tools::Configuration::Config:...>
-```
+**Single-purpose utilities.** Each tool does one thing well.
+
+**YouTube workflow focus.** Built for content creators who code.
+
+**Language-agnostic.** Currently Ruby, but could be rewritten if needed.
+
+[Read the full philosophy →](./docs/purpose-and-philosophy.md)
 
-`appydave-tools` is setup with Guard, run `guard`, this will watch development file changes and run tests automatically, if successful, it will then run rubocop for style quality.
+---
 
-To release a new version, update the version number in `version.rb`, build the gem and push the `.gem` file to [rubygems.org](https://rubygems.org).
+## Development
 
 ```bash
-rake publish
-rake clean
+# Clone the repo
+git clone https://github.com/appydave/appydave-tools
+
+# Setup
+bin/setup
+
+# Run tests
+rake spec
+
+# Auto-run tests on file changes
+guard
+
+# Interactive console
+bin/console
 ```
 
-## Git helpers used by this project
+### Semantic Versioning
 
-Add the follow helpers to your `alias` file
+This project uses **automated versioning** via semantic-release. Don't manually edit version files.
 
+**Commit message format:**
 ```bash
-function kcommit()
-{
-  echo 'git add .'
-  git add .
-  echo "git commit -m "$1""
-  git commit -m "$1"
-  echo 'git pull'
-  git pull
-  echo 'git push'
-  git push
-  sleep 3
-  run_id="$(gh run list --limit 1 | grep -Eo "[0-9]{9,11}")"
-  gh run watch $run_id --exit-status && echo "run completed and successful" && git pull && git tag | sort -V | tail -1
-}
-function kchore     () { kcommit "chore: $1" }
-function kdocs      () { kcommit "docs: $1" }
-function kfix       () { kcommit "fix: $1" }
-function kfeat      () { kcommit "feat: $1" }
-function ktest      () { kcommit "test: $1" }
-function krefactor  () { kcommit "refactor: $1" }
+feat: add new feature    # Minor version bump
+fix: bug fix            # Patch version bump
+chore: maintenance      # No version bump
+
+# Breaking changes
+feat!: breaking change
 ```
 
+CI/CD automatically handles versioning, changelog, and RubyGems publishing.
+
+---
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/appydave/appydave-tools. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+**Welcome:**
+- 🐛 Bug fixes
+- 📝 Documentation improvements
+- ⚡ Performance enhancements
+- 🎯 New single-purpose tools that fit the workflow
+
+**Not looking for:**
+- ❌ Framework-style architectures
+- ❌ Tools that create dependencies between utilities
+- ❌ Enterprise complexity
+
+[Code of Conduct →](./CODE_OF_CONDUCT.md)
+
+---
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+MIT License - Copyright (c) David Cruwys
+
+See [LICENSE.txt](LICENSE.txt) for details.
 
-## Code of Conduct
+---
 
-Everyone interacting in the Appydave Tools project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/appydave/appydave-tools/blob/master/CODE_OF_CONDUCT.md).
+## Connect
 
-## Copyright
+- 🌐 Website: [appydave.com](http://appydave.com)
+- 📺 YouTube: [@AppyDave](https://youtube.com/@appydave)
+- 🐙 GitHub: [appydave](https://github.com/appydave)
 
-Copyright (c) David Cruwys. See [MIT License](LICENSE.txt) for further details.
+Built with ☕ by [David Cruwys](https://davidcruwys.com)