syncopated-context

syncopated-context

Features

• Adaptive convention detection — automatically detects Ruby conventions from .rubocop.yml, standard in Gemfile, or .rubysmith config; generates compliant code with explicit target stated
• Multi-platform session recall — aggregates AI interactions from Claude Code, Hermes, Gemini CLI, and OpenCode with temporal correlation and cross-platform synthesis
• Shared-root plugin architecture — agents, references, and scripts shared across skills eliminate duplication while maintaining modularity
• Convention mode switching — single-file stdlib scripts receive minimal output; complex projects activate full conventions with Zeitwerk compliance and structured logging
• Terminal UI scaffolding — generates BubbleTea/Lipgloss/Huh interfaces from validated templates with complete keyboard handling and component hierarchy
• LLM pipeline integration — covers chatbots, tool-calling agents, vector search, DSPy reasoning modules, and MCP server scaffolding
• GitHub activity correlation — synchronizes session timelines with commit history and PR activity using gh cli integration
• SIFT Protocol QA audits — structured code quality reports with weighted rubrics and file:line evidence citations

Installation

claude plugin add syncopated-context

claude plugin add syncopated-context/rubysmithing
claude plugin add syncopated-context/notebook

git clone https://github.com/b08x/syncopated-context
cd syncopated-context

# Install both plugins
claude plugin add ./plugins/rubysmithing
claude plugin add ./plugins/notebook

cd plugins/rubysmithing
bundle install

# Install dependencies
brew install shellcheck bats-core gum
# or
sudo apt install shellcheck bats gum

Usage

Command Synopsis

# Ruby development workflows
rubysmithing:plan           # Hub orchestrator for all Ruby tasks
rubysmithing:scaffold       # Project initialization via rubysmith/gemsmith
rubysmithing:refactor       # Convention fixes and Zeitwerk compliance
rubysmithing:genai          # LLM, RAG, embeddings, MCP servers
rubysmithing:tui            # Terminal UI scaffolding

# Multi-platform session analysis
recall yesterday            # Cross-platform session retrieval
recall --github owner/repo  # Correlate with GitHub activity
recall platform:claude debugging session

# Repository-level workflows  
/implement                  # Implementation planning and execution
/refactor                   # Code refactoring workflows
/containerize              # Docker deployment automation

Ruby Development Options

Basic Operations

• rubysmithing:analyse: Static analysis with Gemba Walk methodology and root-cause tracing
• rubysmithing:context: Gem API verification using Context7 MCP with SQLite caching
• rubysmithing:sift: QA audits with weighted rubric and evidence citations
• rubysmithing:yardoc: Documentation generation with type inference

Advanced Workflows

• rubysmithing:genai: LLM and RAG pipeline scaffolding
• rubysmithing:tui: BubbleTea/Lipgloss terminal interface generation
• rubysmithing:scaffold: New project initialization with convention detection

Session Recall Options

Platform-Specific Recall

• recall platform:hermes <query>: Search Hermes session database
• recall platform:gemini <query>: Parse Gemini CLI session files
• recall platform:opencode <query>: Analyze OpenCode structured logs

Integrated Analysis

• --github <owner/repo>: Correlate sessions with commit history
• --backup <path>: Include restic backup diff analysis
• <timeframe>: Natural language time expressions (yesterday, last week, 2025-03-25)

Examples

Ruby Project Scaffolding:

# Generate convention-compliant Ruby project
rubysmithing:scaffold -- cli tool for API monitoring with circuit breakers

# Build terminal dashboard with TUI framework
rubysmithing:tui -- two-panel interface: file browser left, content preview right

Code Quality Analysis:

# Run comprehensive QA audit
rubysmithing:sift -- audit lib/ directory