From 89bad1ff9255134ab4b9df5531e891753ba207ba Mon Sep 17 00:00:00 2001
From: Christopher Horrell <christopher@horrell.ca>
Date: Tue, 10 Feb 2026 18:56:20 -0500
Subject: [PATCH 1/2] Add AGENTS.md and AI-CONTRIBUTIONS.md documentation

Creates two complementary documentation files:

AGENTS.md - Instructions FOR AI agents on how to work on this codebase:
- Project overview and tech stack
- Setup and testing commands
- Project structure and development workflow
- Code style and conventions
- CI/CD configuration details
- Comprehensive dos and don'ts
- Git commit and PR guidelines
- Security considerations
- Debugging tips and common issues
- Links to external resources

AI-CONTRIBUTIONS.md - Historical record OF AI agent contributions:
- Overview of 11 PRs merged with AI assistance
- Detailed breakdown by category (bugs, performance, testing)
- Before/after metrics showing impact
- Technology stack updates
- Methodology and best practices
- Links to all pull requests

This follows the standard AGENTS.md format (instructions for future AI work)
while preserving transparency about past AI contributions in a separate file.

Benefits:
- Future AI agents have clear guidance on project conventions
- Reduces iteration cycles and improves AI code quality
- Maintains transparency about AI collaboration
- Provides debugging resources and common patterns
- Documents security considerations and best practices

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 AGENTS.md           | 315 ++++++++++++++++++++++++++++++++++++++++++++
 AI-CONTRIBUTIONS.md | 208 +++++++++++++++++++++++++++++
 2 files changed, 523 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 AI-CONTRIBUTIONS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..540f1d3
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,315 @@
+# AGENTS.md
+
+Instructions for AI coding agents working on this project.
+
+## Project Overview
+
+This is a Serverspec-based testing framework for validating Docker images. The project tests Node.js Docker images built from custom Dockerfiles by creating containers, running Serverspec tests against them, and cleaning up resources.
+
+**Tech Stack:**
+- Ruby 3.4+ and Ruby 4.0+
+- Serverspec 2.43+
+- Docker API gem 2.4+
+- RSpec 3.13+
+- Docker BuildKit
+
+**Current Node.js versions tested:**
+- Node.js 22.22.0 (Maintenance LTS)
+- Node.js 24.13.0 (Active LTS)
+
+## Setup Commands
+
+```bash
+# Install dependencies locally (no sudo required)
+bundle install
+
+# Docker BuildKit is enabled by default in Rakefile
+# Verify Docker is running
+docker info
+```
+
+## Running Tests
+
+```bash
+# Run all tests in parallel (~18 seconds)
+bundle exec rake
+
+# Run tests for a specific Node.js version
+bundle exec rspec spec/22/Dockerfile_spec.rb
+bundle exec rspec spec/24/Dockerfile_spec.rb
+
+# Run with verbose output
+bundle exec rake --trace
+```
+
+## Project Structure
+
+```
+.
+├── 22/                          # Node.js 22 Dockerfile
+├── 24/                          # Node.js 24 Dockerfile
+├── spec/
+│   ├── 22/Dockerfile_spec.rb   # Tests for Node.js 22
+│   ├── 24/Dockerfile_spec.rb   # Tests for Node.js 24
+│   ├── spec_helper.rb          # Helper methods (create_image, delete_image)
+│   ├── node_tests.rb           # Shared Node.js version tests
+│   └── npm_tests.rb            # Shared npm tests
+├── Rakefile                     # Test runner with parallel execution
+├── Gemfile                      # Ruby dependencies
+└── .github/workflows/ruby.yml   # CI with Ruby 3.4 & 4.0 matrix
+```
+
+## Development Workflow
+
+### Adding a New Node.js Version
+
+1. Create new directory: `mkdir XX/` (where XX is the version)
+2. Copy Dockerfile from existing version and update `NODE_VERSION`
+3. Create test spec: `spec/XX/Dockerfile_spec.rb`
+4. Update Rakefile to include new task
+5. Test locally: `bundle exec rake`
+6. Update README.md to mention new version
+
+### Modifying Dockerfiles
+
+- Always update the `NODE_VERSION` environment variable
+- Verify GPG keys are current from nodejs/docker-node
+- Test on both amd64 and arm64 if possible
+- Use Debian trixie-slim as base image
+
+### Updating Dependencies
+
+```bash
+# Update specific gem
+bundle update <gem-name>
+
+# Update all gems (be careful)
+bundle update
+
+# Always remove BUNDLED WITH section from Gemfile.lock for CI compatibility
+```
+
+## Testing Instructions
+
+### What Tests Validate
+
+1. **Node.js Version**: Correct version is installed
+2. **npm Functionality**: npm commands work correctly
+3. **Global Package Installation**: Can install global npm packages
+4. **Package Execution**: Installed packages run correctly
+
+### Writing Tests
+
+- Use shared test helpers in `spec/node_tests.rb` and `spec/npm_tests.rb`
+- Tests run inside Docker containers via docker-api gem
+- Each test spec must include proper setup/teardown:
+
+```ruby
+before(:all) do
+  create_image(tag)  # Builds Docker image
+end
+
+after(:all) do
+  delete_image  # Cleans up containers and images
+end
+```
+
+### Test Execution
+
+- Tests run in PARALLEL by default (Rake multitask)
+- Each test gets isolated `ENV['TARGET_HOST']`
+- Containers are automatically cleaned up after tests
+- Images are removed only if tests pass
+
+## Code Style and Conventions
+
+### Ruby Style
+
+- Use 2 spaces for indentation
+- Follow existing patterns in spec files
+- Use double quotes for strings
+- Keep helper methods in `spec_helper.rb`
+
+### Serverspec Patterns
+
+```ruby
+# Use shared test methods
+test_node("24.13.0")  # Preferred
+test_npm              # Preferred
+
+# Resource types commonly used
+describe command("node --version")
+describe package("curl")
+describe file("/usr/local/bin/node")
+```
+
+### Dockerfile Conventions
+
+- Use multi-line RUN with `&&` for layer efficiency
+- Always verify GPG signatures
+- Clean up apt cache: `rm -rf /var/lib/apt/lists/*`
+- Install CA certificates for HTTPS downloads
+
+## CI/CD Configuration
+
+### GitHub Actions Matrix
+
+Tests run on:
+- Ruby 3.4 (current stable)
+- Ruby 4.0 (latest stable)
+
+Both versions must pass before merge.
+
+### Environment Variables
+
+- `DOCKER_BUILDKIT=1`: Always enabled (set in workflow and Rakefile)
+- `TARGET_HOST`: Set per test for isolation (handled automatically)
+
+## Dos and Don'ts
+
+### DO ✅
+
+- Test all changes locally before committing
+- Run full test suite: `bundle exec rake`
+- Keep Node.js versions on LTS releases
+- Update README.md when changing versions
+- Use version pinning in Gemfile (`~>` operator)
+- Clean up Docker resources properly
+- Use parallel test execution (Rake multitask)
+- Handle errors gracefully in helper methods
+
+### DON'T ❌
+
+- Don't stop all Docker containers (only test containers)
+- Don't use `sudo` for bundle install (use local path)
+- Don't hardcode image IDs (use @image variable)
+- Don't skip the `after(:all)` cleanup block
+- Don't add BUNDLED WITH section to Gemfile.lock
+- Don't test EOL (End of Life) Node.js versions
+- Don't modify .bundle/config (project-level config)
+- Don't disable Docker BuildKit without good reason
+
+## Git Commit Guidelines
+
+### Commit Message Format
+
+```
+<type>: <short summary>
+
+<detailed description>
+
+<optional breaking changes>
+
+Co-authored-by: <AI agent or human collaborator>
+```
+
+### Types
+
+- `fix`: Bug fixes
+- `feat`: New features
+- `perf`: Performance improvements
+- `test`: Test-only changes
+- `docs`: Documentation updates
+- `chore`: Dependency updates, tooling
+
+### Example
+
+```
+feat: Add Node.js 26 LTS support
+
+- Create 26/Dockerfile with NODE_VERSION=26.x.x
+- Add spec/26/Dockerfile_spec.rb with version tests
+- Update Rakefile to include node26 task
+- Update README.md to list version 26
+
+Tests pass on Ruby 3.4 and 4.0.
+```
+
+## Pull Request Guidelines
+
+1. **One change per PR**: Keep PRs focused
+2. **Test coverage**: Ensure all tests pass locally and in CI
+3. **Update docs**: Update README.md if user-facing changes
+4. **Commit history**: Squash commits for cleaner history
+5. **Co-authorship**: Add co-author tags for collaborators
+
+## Security Considerations
+
+### Dockerfile Security
+
+- Always verify GPG signatures for Node.js downloads
+- Use specific Debian versions (not `latest`)
+- Minimize installed packages
+- Clean up package manager cache
+
+### Dependency Security
+
+- Keep gems updated for security patches
+- Review CVEs for docker-api and other dependencies
+- Use `bundle audit` to check for vulnerabilities
+
+### Container Isolation
+
+- Tests create isolated containers per version
+- Containers are removed after tests complete
+- Only stop containers created by tests (not system-wide)
+
+## Debugging
+
+### Common Issues
+
+**Tests fail with "container not found"**
+- Check that Docker daemon is running
+- Verify container cleanup in after(:all) block
+
+**Image build fails**
+- Verify Node.js version exists on nodejs.org
+- Check GPG key servers are accessible
+- Review Docker BuildKit logs
+
+**Bundler version conflicts**
+- Remove BUNDLED WITH section from Gemfile.lock
+- Let CI use its native Bundler version
+
+**Performance Issues**
+- Ensure Docker BuildKit is enabled
+- Verify parallel execution (multitask) is working
+- Check if Docker daemon has resource constraints
+
+### Debug Commands
+
+```bash
+# List Docker images created by tests
+docker images | grep test
+
+# Check running containers
+docker ps -a
+
+# View Docker BuildKit cache
+docker buildx du
+
+# Run with verbose Rake output
+bundle exec rake --trace
+
+# Run single test with RSpec output
+bundle exec rspec spec/24/Dockerfile_spec.rb --format documentation
+```
+
+## Resources
+
+- **Serverspec Documentation**: http://serverspec.org/resource_types.html
+- **Docker API Gem**: https://github.com/swipely/docker-api
+- **Node.js Releases**: https://nodejs.org/en/about/previous-releases
+- **Ruby Releases**: https://www.ruby-lang.org/en/downloads/releases/
+
+## Questions?
+
+When working on this project:
+1. Check existing patterns in similar files
+2. Run tests locally before committing
+3. Review CI output for multi-version compatibility
+4. Keep changes focused and well-tested
+
+---
+
+**Note**: For historical information about AI contributions to this project, see [AI-CONTRIBUTIONS.md](./AI-CONTRIBUTIONS.md).
diff --git a/AI-CONTRIBUTIONS.md b/AI-CONTRIBUTIONS.md
new file mode 100644
index 0000000..886000c
--- /dev/null
+++ b/AI-CONTRIBUTIONS.md
@@ -0,0 +1,208 @@
+# AI Agent Contributions
+
+This document tracks improvements made to this project with the assistance of AI agents.
+
+> **Note**: For instructions on how AI agents should work on this codebase, see [AGENTS.md](./AGENTS.md).
+
+## Overview
+
+Between February 2026, this project underwent a comprehensive modernization effort with AI assistance. The collaboration resulted in 11 merged pull requests that transformed the codebase from having critical bugs and outdated dependencies to being a modern, efficient, and future-proof testing infrastructure.
+
+## Improvements Summary
+
+### 🔒 Critical Bug Fixes
+
+**PR #56: Fixed Unsafe Container Cleanup**
+- **Issue**: `delete_image` was stopping ALL Docker containers on the system, including unrelated ones
+- **Fix**: Updated to only stop containers created from the test image
+- **Impact**: Prevented dangerous system-wide container disruptions
+
+### ⚡ Performance Enhancements
+
+**PR #58: Parallel Test Execution**
+- **Change**: Implemented Rake multitask for parallel test execution
+- **Improvement**: ~47% faster test runs (35s → 18s)
+- **Method**: Tests run in separate subprocesses with isolated environments
+
+**PR #62: Docker BuildKit**
+- **Change**: Enabled Docker BuildKit for image builds
+- **Benefits**: Faster builds, better caching, improved layer management
+
+### 📦 Dependency Updates
+
+**PR #57: Updated Gem Dependencies**
+- Updated to latest stable versions with version pinning
+- Gems: docker-api ~> 2.4, rake ~> 13.0, rspec ~> 3.13, serverspec ~> 2.43
+- Includes security patches and bug fixes
+
+**PR #63: Logger Gem for Ruby 4.0**
+- Added explicit `logger` gem dependency
+- Fixes Ruby 4.0 deprecation warning
+- Ensures forward compatibility
+
+### 🧪 Testing Improvements
+
+**PR #64: Ruby Version Matrix**
+- Implemented GitHub Actions matrix testing
+- Tests on Ruby 3.4 (maintenance) and Ruby 4.0 (latest)
+- Ensures compatibility across Ruby versions
+- fail-fast: false allows all versions to complete
+
+**PR #65: Node.js LTS Updates**
+- Updated from Node.js 20 & 22 to 22 & 24
+- Node.js 22.22.0 (Maintenance LTS)
+- Node.js 24.13.0 (Active LTS "Krypton")
+- Includes latest security patches (January 2026)
+
+### 🛡️ Reliability & Error Handling
+
+**PR #61: Comprehensive Error Handling**
+- Added try/catch blocks in `create_image` and `delete_image`
+- Guards against nil @image references
+- Clear error messages for debugging
+- Informative status messages
+
+**PR #60: Removed Redundant Tagging**
+- Removed unused `@image.tag()` call
+- Simplified image lifecycle management
+
+### 🔧 Developer Experience
+
+**PR #59: Bundler Config & .gitignore**
+- Added `.bundle/config` for local gem installation
+- Created `.gitignore` to exclude vendor/bundle, .DS_Store, etc.
+- Enables `bundle install` without sudo
+- Cleaner repository
+
+### 📚 Documentation
+
+**PR #66: Updated README**
+- Updated directory references from (20 and 22) to (22 and 24)
+- Keeps documentation in sync with code changes
+
+## Metrics
+
+### Before AI Assistance
+- Critical container cleanup bug (system-wide impact)
+- Sequential test execution (~35 seconds)
+- Outdated dependencies
+- No Ruby version matrix testing
+- Node.js 20 & 22 (outdated)
+- No error handling
+- Deprecation warnings
+- Sudo required for gem installation
+
+### After AI Assistance
+- Safe, isolated container cleanup
+- Parallel test execution (~18 seconds, 47% faster)
+- Latest stable dependencies with version pinning
+- Multi-version Ruby testing (3.4 & 4.0)
+- Node.js 22.22.0 & 24.13.0 LTS with latest security patches
+- Comprehensive error handling
+- Zero deprecation warnings
+- Easy local setup without sudo
+
+## Technology Stack Updates
+
+### Ruby Versions Tested
+- Ruby 3.4.x (Stable maintenance)
+- Ruby 4.0.x (Latest stable)
+
+### Node.js Versions Tested
+- Node.js 22.22.0 (Maintenance LTS "Jod")
+- Node.js 24.13.0 (Active LTS "Krypton")
+
+### Gem Versions
+- docker-api ~> 2.4
+- rake ~> 13.0
+- rspec ~> 3.13
+- serverspec ~> 2.43
+- logger (explicit for Ruby 4.0 compatibility)
+
+## AI Agent Methodology
+
+### Analysis Phase
+1. Comprehensive code review of existing implementation
+2. Identification of bugs, inefficiencies, and technical debt
+3. Prioritization of issues by severity and impact
+4. Research of current best practices and latest versions
+
+### Implementation Phase
+1. Incremental improvements via focused pull requests
+2. Testing at each step before proceeding
+3. CI/CD validation for all changes
+4. Clear documentation in commit messages and PR descriptions
+
+### Verification Phase
+1. Local testing before each commit
+2. GitHub Actions CI validation
+3. Multi-version compatibility testing
+4. Security patch verification
+
+## Pull Request Links
+
+All improvements are documented in individual pull requests:
+- [PR #56](../../pull/56) - Fixed unsafe container cleanup
+- [PR #57](../../pull/57) - Updated gem dependencies
+- [PR #58](../../pull/58) - Parallel test execution
+- [PR #59](../../pull/59) - Bundler config & .gitignore
+- [PR #60](../../pull/60) - Removed redundant tagging
+- [PR #61](../../pull/61) - Error handling
+- [PR #62](../../pull/62) - Docker BuildKit
+- [PR #63](../../pull/63) - Logger gem
+- [PR #64](../../pull/64) - Ruby version matrix
+- [PR #65](../../pull/65) - Node.js LTS updates
+- [PR #66](../../pull/66) - README updates
+
+## Best Practices Demonstrated
+
+### Code Quality
+- Comprehensive error handling
+- Resource cleanup in all code paths
+- Clear, informative logging
+- No technical debt
+
+### Testing
+- Multi-version testing (Ruby 3.4 & 4.0)
+- Multi-platform testing (Node.js 22 & 24)
+- Parallel execution for efficiency
+- CI/CD automation
+
+### Dependencies
+- Version pinning for reproducibility
+- Regular updates for security
+- Explicit dependencies (no implicit defaults)
+- Forward compatibility considerations
+
+### Documentation
+- Clear commit messages
+- Detailed PR descriptions
+- Updated README
+- This AGENTS.md file for transparency
+
+## Lessons Learned
+
+1. **Incremental changes are safer**: Small, focused PRs are easier to review and rollback if needed
+2. **Testing is critical**: Multi-version testing catches compatibility issues early
+3. **Security matters**: Regular dependency updates include important security patches
+4. **Developer experience**: Simple setup (no sudo) encourages contribution
+5. **Documentation ages**: Keep docs in sync with code changes
+
+## Future Considerations
+
+While the project is now in excellent shape, potential future improvements could include:
+- Additional Node.js LTS version testing (e.g., v26 when released)
+- Ruby 4.1 when it enters LTS
+- Container image caching between test runs
+- Performance benchmarking automation
+
+## Acknowledgments
+
+This project benefited from AI assistance using Factory's Droid agent, which helped identify issues, research solutions, implement fixes, and ensure comprehensive testing. All changes were reviewed and approved by the project maintainer.
+
+---
+
+**Last Updated**: February 2026  
+**AI Agent**: Factory Droid  
+**Total PRs**: 11  
+**Impact**: Project transformed from legacy code to modern, production-ready infrastructure

From 2dde5c36765158b9f91bff60d339efd812363b44 Mon Sep 17 00:00:00 2001
From: Christopher Horrell <christopher@horrell.ca>
Date: Tue, 10 Feb 2026 19:01:18 -0500
Subject: [PATCH 2/2] Add markdownlint configuration and fix all linting issues

Adds markdownlint enforcement and documentation standards to the project.

Changes:

.markdownlint.json - Configuration for markdown linting:
- Line length: 120 chars (excludes code blocks and tables)
- Enforces blank lines around headings and lists
- Requires language specs for fenced code blocks
- Standard markdown best practices

AGENTS.md - Updated with markdown requirements:
- Added "Documentation Standards" section
- Instructions for running markdownlint
- Added to DO list: lint markdown files before commit
- Fixed all linting issues:
  - Split long lines
  - Added language specs to code blocks (text, bash)
  - Converted bold text to proper headings (####)
  - Proper blank lines around lists and headings

AI-CONTRIBUTIONS.md - Fixed all linting issues:
- Split long lines for readability
- Converted PR titles from bold to proper headings (####)
- Added blank lines around sections
- Improved document structure

All *.md files now pass: npx markdownlint-cli *.md

Benefits:
- Consistent markdown formatting across the project
- Better readability and maintainability
- Catches common markdown issues automatically
- Standard enforced for human and AI contributors

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
---
 .markdownlint.json  | 10 ++++++++
 AGENTS.md           | 60 ++++++++++++++++++++++++++++++++++++---------
 AI-CONTRIBUTIONS.md | 57 ++++++++++++++++++++++++++++++++----------
 3 files changed, 102 insertions(+), 25 deletions(-)
 create mode 100644 .markdownlint.json

diff --git a/.markdownlint.json b/.markdownlint.json
new file mode 100644
index 0000000..04245a0
--- /dev/null
+++ b/.markdownlint.json
@@ -0,0 +1,10 @@
+{
+  "default": true,
+  "MD013": {
+    "line_length": 120,
+    "code_blocks": false,
+    "tables": false
+  },
+  "MD033": false,
+  "MD041": false
+}
diff --git a/AGENTS.md b/AGENTS.md
index 540f1d3..6be3e75 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -4,9 +4,13 @@ Instructions for AI coding agents working on this project.
 
 ## Project Overview
 
-This is a Serverspec-based testing framework for validating Docker images. The project tests Node.js Docker images built from custom Dockerfiles by creating containers, running Serverspec tests against them, and cleaning up resources.
+This is a Serverspec-based testing framework for validating Docker images.
+The project tests Node.js Docker images built from custom Dockerfiles by
+creating containers, running Serverspec tests against them, and cleaning up
+resources.
 
 **Tech Stack:**
+
 - Ruby 3.4+ and Ruby 4.0+
 - Serverspec 2.43+
 - Docker API gem 2.4+
@@ -14,6 +18,7 @@ This is a Serverspec-based testing framework for validating Docker images. The p
 - Docker BuildKit
 
 **Current Node.js versions tested:**
+
 - Node.js 22.22.0 (Maintenance LTS)
 - Node.js 24.13.0 (Active LTS)
 
@@ -44,7 +49,7 @@ bundle exec rake --trace
 
 ## Project Structure
 
-```
+```text
 .
 ├── 22/                          # Node.js 22 Dockerfile
 ├── 24/                          # Node.js 24 Dockerfile
@@ -89,6 +94,30 @@ bundle update
 # Always remove BUNDLED WITH section from Gemfile.lock for CI compatibility
 ```
 
+## Documentation Standards
+
+### Markdown Linting
+
+All markdown files must pass markdownlint validation before committing.
+
+```bash
+# Check all markdown files
+npx markdownlint-cli *.md
+
+# Auto-fix issues where possible
+npx markdownlint-cli --fix *.md
+```
+
+**Configuration**: See `.markdownlint.json` for project rules.
+
+**Key Rules**:
+
+- Line length: 120 characters max (code blocks excluded)
+- Blank lines around headings and lists
+- Language specified for fenced code blocks
+- No bare URLs (use markdown links)
+- Use proper headings (not bold text as headings)
+
 ## Testing Instructions
 
 ### What Tests Validate
@@ -155,6 +184,7 @@ describe file("/usr/local/bin/node")
 ### GitHub Actions Matrix
 
 Tests run on:
+
 - Ruby 3.4 (current stable)
 - Ruby 4.0 (latest stable)
 
@@ -171,6 +201,7 @@ Both versions must pass before merge.
 
 - Test all changes locally before committing
 - Run full test suite: `bundle exec rake`
+- Lint markdown files: `npx markdownlint-cli *.md`
 - Keep Node.js versions on LTS releases
 - Update README.md when changing versions
 - Use version pinning in Gemfile (`~>` operator)
@@ -193,7 +224,7 @@ Both versions must pass before merge.
 
 ### Commit Message Format
 
-```
+```text
 <type>: <short summary>
 
 <detailed description>
@@ -214,7 +245,7 @@ Co-authored-by: <AI agent or human collaborator>
 
 ### Example
 
-```
+```text
 feat: Add Node.js 26 LTS support
 
 - Create 26/Dockerfile with NODE_VERSION=26.x.x
@@ -258,20 +289,24 @@ Tests pass on Ruby 3.4 and 4.0.
 
 ### Common Issues
 
-**Tests fail with "container not found"**
+#### Tests fail with "container not found"
+
 - Check that Docker daemon is running
 - Verify container cleanup in after(:all) block
 
-**Image build fails**
+#### Image build fails
+
 - Verify Node.js version exists on nodejs.org
 - Check GPG key servers are accessible
 - Review Docker BuildKit logs
 
-**Bundler version conflicts**
+#### Bundler version conflicts
+
 - Remove BUNDLED WITH section from Gemfile.lock
 - Let CI use its native Bundler version
 
-**Performance Issues**
+#### Performance Issues
+
 - Ensure Docker BuildKit is enabled
 - Verify parallel execution (multitask) is working
 - Check if Docker daemon has resource constraints
@@ -297,14 +332,15 @@ bundle exec rspec spec/24/Dockerfile_spec.rb --format documentation
 
 ## Resources
 
-- **Serverspec Documentation**: http://serverspec.org/resource_types.html
-- **Docker API Gem**: https://github.com/swipely/docker-api
-- **Node.js Releases**: https://nodejs.org/en/about/previous-releases
-- **Ruby Releases**: https://www.ruby-lang.org/en/downloads/releases/
+- **Serverspec Documentation**: <http://serverspec.org/resource_types.html>
+- **Docker API Gem**: <https://github.com/swipely/docker-api>
+- **Node.js Releases**: <https://nodejs.org/en/about/previous-releases>
+- **Ruby Releases**: <https://www.ruby-lang.org/en/downloads/releases/>
 
 ## Questions?
 
 When working on this project:
+
 1. Check existing patterns in similar files
 2. Run tests locally before committing
 3. Review CI output for multi-version compatibility
diff --git a/AI-CONTRIBUTIONS.md b/AI-CONTRIBUTIONS.md
index 886000c..a108084 100644
--- a/AI-CONTRIBUTIONS.md
+++ b/AI-CONTRIBUTIONS.md
@@ -6,49 +6,59 @@ This document tracks improvements made to this project with the assistance of AI
 
 ## Overview
 
-Between February 2026, this project underwent a comprehensive modernization effort with AI assistance. The collaboration resulted in 11 merged pull requests that transformed the codebase from having critical bugs and outdated dependencies to being a modern, efficient, and future-proof testing infrastructure.
+Between February 2026, this project underwent a comprehensive modernization
+effort with AI assistance. The collaboration resulted in 11 merged pull requests
+that transformed the codebase from having critical bugs and outdated dependencies
+to being a modern, efficient, and future-proof testing infrastructure.
 
 ## Improvements Summary
 
 ### 🔒 Critical Bug Fixes
 
-**PR #56: Fixed Unsafe Container Cleanup**
+#### PR #56: Fixed Unsafe Container Cleanup
+
 - **Issue**: `delete_image` was stopping ALL Docker containers on the system, including unrelated ones
 - **Fix**: Updated to only stop containers created from the test image
 - **Impact**: Prevented dangerous system-wide container disruptions
 
 ### ⚡ Performance Enhancements
 
-**PR #58: Parallel Test Execution**
+#### PR #58: Parallel Test Execution
+
 - **Change**: Implemented Rake multitask for parallel test execution
 - **Improvement**: ~47% faster test runs (35s → 18s)
 - **Method**: Tests run in separate subprocesses with isolated environments
 
-**PR #62: Docker BuildKit**
+#### PR #62: Docker BuildKit
+
 - **Change**: Enabled Docker BuildKit for image builds
 - **Benefits**: Faster builds, better caching, improved layer management
 
 ### 📦 Dependency Updates
 
-**PR #57: Updated Gem Dependencies**
+#### PR #57: Updated Gem Dependencies
+
 - Updated to latest stable versions with version pinning
 - Gems: docker-api ~> 2.4, rake ~> 13.0, rspec ~> 3.13, serverspec ~> 2.43
 - Includes security patches and bug fixes
 
-**PR #63: Logger Gem for Ruby 4.0**
+#### PR #63: Logger Gem for Ruby 4.0
+
 - Added explicit `logger` gem dependency
 - Fixes Ruby 4.0 deprecation warning
 - Ensures forward compatibility
 
 ### 🧪 Testing Improvements
 
-**PR #64: Ruby Version Matrix**
+#### PR #64: Ruby Version Matrix
+
 - Implemented GitHub Actions matrix testing
 - Tests on Ruby 3.4 (maintenance) and Ruby 4.0 (latest)
 - Ensures compatibility across Ruby versions
 - fail-fast: false allows all versions to complete
 
-**PR #65: Node.js LTS Updates**
+#### PR #65: Node.js LTS Updates
+
 - Updated from Node.js 20 & 22 to 22 & 24
 - Node.js 22.22.0 (Maintenance LTS)
 - Node.js 24.13.0 (Active LTS "Krypton")
@@ -56,19 +66,22 @@ Between February 2026, this project underwent a comprehensive modernization effo
 
 ### 🛡️ Reliability & Error Handling
 
-**PR #61: Comprehensive Error Handling**
+#### PR #61: Comprehensive Error Handling
+
 - Added try/catch blocks in `create_image` and `delete_image`
 - Guards against nil @image references
 - Clear error messages for debugging
 - Informative status messages
 
-**PR #60: Removed Redundant Tagging**
+#### PR #60: Removed Redundant Tagging
+
 - Removed unused `@image.tag()` call
 - Simplified image lifecycle management
 
 ### 🔧 Developer Experience
 
-**PR #59: Bundler Config & .gitignore**
+#### PR #59: Bundler Config & .gitignore
+
 - Added `.bundle/config` for local gem installation
 - Created `.gitignore` to exclude vendor/bundle, .DS_Store, etc.
 - Enables `bundle install` without sudo
@@ -76,13 +89,15 @@ Between February 2026, this project underwent a comprehensive modernization effo
 
 ### 📚 Documentation
 
-**PR #66: Updated README**
+#### PR #66: Updated README
+
 - Updated directory references from (20 and 22) to (22 and 24)
 - Keeps documentation in sync with code changes
 
 ## Metrics
 
 ### Before AI Assistance
+
 - Critical container cleanup bug (system-wide impact)
 - Sequential test execution (~35 seconds)
 - Outdated dependencies
@@ -93,6 +108,7 @@ Between February 2026, this project underwent a comprehensive modernization effo
 - Sudo required for gem installation
 
 ### After AI Assistance
+
 - Safe, isolated container cleanup
 - Parallel test execution (~18 seconds, 47% faster)
 - Latest stable dependencies with version pinning
@@ -105,14 +121,17 @@ Between February 2026, this project underwent a comprehensive modernization effo
 ## Technology Stack Updates
 
 ### Ruby Versions Tested
+
 - Ruby 3.4.x (Stable maintenance)
 - Ruby 4.0.x (Latest stable)
 
 ### Node.js Versions Tested
+
 - Node.js 22.22.0 (Maintenance LTS "Jod")
 - Node.js 24.13.0 (Active LTS "Krypton")
 
 ### Gem Versions
+
 - docker-api ~> 2.4
 - rake ~> 13.0
 - rspec ~> 3.13
@@ -122,18 +141,21 @@ Between February 2026, this project underwent a comprehensive modernization effo
 ## AI Agent Methodology
 
 ### Analysis Phase
+
 1. Comprehensive code review of existing implementation
 2. Identification of bugs, inefficiencies, and technical debt
 3. Prioritization of issues by severity and impact
 4. Research of current best practices and latest versions
 
 ### Implementation Phase
+
 1. Incremental improvements via focused pull requests
 2. Testing at each step before proceeding
 3. CI/CD validation for all changes
 4. Clear documentation in commit messages and PR descriptions
 
 ### Verification Phase
+
 1. Local testing before each commit
 2. GitHub Actions CI validation
 3. Multi-version compatibility testing
@@ -142,6 +164,7 @@ Between February 2026, this project underwent a comprehensive modernization effo
 ## Pull Request Links
 
 All improvements are documented in individual pull requests:
+
 - [PR #56](../../pull/56) - Fixed unsafe container cleanup
 - [PR #57](../../pull/57) - Updated gem dependencies
 - [PR #58](../../pull/58) - Parallel test execution
@@ -157,24 +180,28 @@ All improvements are documented in individual pull requests:
 ## Best Practices Demonstrated
 
 ### Code Quality
+
 - Comprehensive error handling
 - Resource cleanup in all code paths
 - Clear, informative logging
 - No technical debt
 
 ### Testing
+
 - Multi-version testing (Ruby 3.4 & 4.0)
 - Multi-platform testing (Node.js 22 & 24)
 - Parallel execution for efficiency
 - CI/CD automation
 
 ### Dependencies
+
 - Version pinning for reproducibility
 - Regular updates for security
 - Explicit dependencies (no implicit defaults)
 - Forward compatibility considerations
 
 ### Documentation
+
 - Clear commit messages
 - Detailed PR descriptions
 - Updated README
@@ -191,6 +218,7 @@ All improvements are documented in individual pull requests:
 ## Future Considerations
 
 While the project is now in excellent shape, potential future improvements could include:
+
 - Additional Node.js LTS version testing (e.g., v26 when released)
 - Ruby 4.1 when it enters LTS
 - Container image caching between test runs
@@ -198,7 +226,10 @@ While the project is now in excellent shape, potential future improvements could
 
 ## Acknowledgments
 
-This project benefited from AI assistance using Factory's Droid agent, which helped identify issues, research solutions, implement fixes, and ensure comprehensive testing. All changes were reviewed and approved by the project maintainer.
+This project benefited from AI assistance using Factory's Droid agent, which
+helped identify issues, research solutions, implement fixes, and ensure
+comprehensive testing. All changes were reviewed and approved by the project
+maintainer.
 
 ---