18 Commits

  • Complete redesign of MASTER-PROMPT.md: Better structure, styling, readability
    MAJOR IMPROVEMENTS:
    
    1. One Continuous Copy-Paste Block
       - Fixed broken prompt sections
       - Single unbroken block for easy copying
       - Clear START/END markers
       - No more fragmented sections
    
    2. Enhanced Structure & Navigation
       - Added comprehensive table of contents
       - Clear section headers with emoji icons
       - Logical flow: Setup → Copy → Examples → Reference
       - Improved visual hierarchy
    
    3. Professional Styling
       - Unicode box-drawing characters for visual appeal
       - Clean markdown formatting throughout
       - Consistent spacing and layout
       - Tree-style department listings (├── └──)
       - Table boxes for summaries
    
    4. Improved Readability
       - Simplified language (removed verbose sections)
       - Bullet points (•) instead of numbered lists where appropriate
       - Clear visual separators (━━━ ═══)
       - Better code block formatting
       - Condensed examples (3 instead of 5)
    
    5. Streamlined Content
       - Removed redundant explanations
       - Consolidated Ralph hook (one clean version)
       - Cleaner agent lists with arrows (→)
       - Focused on what users need to know
       - Removed fluff while keeping all info
    
    6. Better UX for Readers
       - Quick Start guide at top
       - Clear API provider comparison (A vs B)
       - One-click copy section
       - Troubleshooting section
       - Quick reference commands
    
    VISUAL IMPROVEMENTS:
    - Before: 1295 lines, dense text, broken copy sections
    - After: 693 lines (47% reduction), clean layout, continuous block
    
    KEY FEATURES:
     One unbroken copy-paste section
     Table of contents for easy navigation
     Clear visual hierarchy with emojis
     Professional box-drawing characters
     Condensed but complete information
     Mobile-friendly layout
     Print-ready formatting
    
    Version: 3.0
    Last Updated: 2025-01-16
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Add skills installation to all 3 installers (manual, auto, prompt)
    FEATURES:
    - All 3 installation methods now include skills installation
    - Skills are user-invocable slash commands (like /ui-ux-pro-max)
    
    CHANGES:
    
    1. Interactive Installer (interactive-install-claude.sh)
       - Added skills directory creation
       - Automatic skills installation from repository
       - Copies all skills to ~/.claude/skills/
       - Makes Python scripts executable
       - Displays skills count in summary
    
    2. Master Prompt (MASTER-PROMPT.md)
       - Updated Step 1.5 with current repository structure
       - Simplified skills installation instructions
       - Removed deprecated external repository references
       - Uses local repository files
    
    3. Manual Installation (README.md)
       - Updated Step 4 with skills installation
       - Clear verification steps
       - Explains what skills provide
       - Proper chmod +x for scripts
    
    SKILLS NOW INCLUDED:
    - ui-ux-pro-max: Design patterns, colors, typography
    - 50+ design styles (minimalism, glassmorphism, etc.)
    - Search 8 domains: landing, style, product, color, typography
    - Python script search.py for design recommendations
    
    TESTING:
    - All 3 installers tested and working
    - Skills install to correct location: ~/.claude/skills/
    - Python scripts are executable
    - Skills count shows in installation summary
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Enhance Ralph hook with background task spawning
    BREAKING CHANGE: Ralph now runs as background process (non-blocking)
    
    Changes:
    - Enhanced ralph-auto-trigger.sh to spawn Ralph in background
    - Hook immediately returns to Claude Code (NON-BLOCKING)
    - Ralph runs via nohup (survives terminal close)
    - Added PID tracking: ~/.claude/ralph.pid
    - Added lock file: ~/.claude/ralph.lock
    - Added log file: ~/.claude/ralph-output.log
    - Added trigger log: ~/.claude/ralph-trigger.log
    - Added RALPH_MAX_ITERATIONS environment variable (default: 50)
    
    Features:
    - Background execution: Claude Code continues immediately
    - Process tracking: PID saved for monitoring/stopping
    - Lock mechanism: Prevents duplicate Ralph instances
    - Real-time monitoring: tail -f ~/.claude/ralph-output.log
    - Graceful cleanup: Auto-cleanup of dead process locks
    
    Updated files:
    - MASTER-PROMPT.md: Enhanced hook script + usage instructions
    - interactive-install-claude.sh: Enhanced install_ralph() function
    - ~/.claude/hooks/ralph-auto-trigger.sh: Updated local installation
    
    Usage:
    - Ralph auto-starts in background when agents are requested
    - Monitor: tail -f ~/.claude/ralph-output.log
    - Stop: kill $(cat ~/.claude/ralph.pid)
    - Configure: export RALPH_AUTO_MODE=agents|always|off
    - Configure: export RALPH_MAX_ITERATIONS=100
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Update MASTER-PROMPT: Add Ralph CLI to overview section
    Changes:
    - Update component count: 6 → 7 major components
    - Add Ralph CLI as component #6 with (Advanced - Optional) label
    - Shift claude-codex-settings to component #7
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Add Ralph CLI integration to MASTER-PROMPT (HYBRID approach)
    New Step 6: Configure Ralph CLI Autonomous Looping (Advanced - Optional)
    - Install Ralph CLI: npm install -g @iannuttall/ralph
    - Create ralph-auto-trigger.sh hook script
    - Configure hooks.json for auto-triggering
    - Control modes: always/agents/off (default: agents)
    - State persistence in .claude/ralph-loop.local.md
    - Cancel methods: /cancel-ralph, delete state file, set mode=off
    
    Key Features:
    - Autonomous looping until task completion
    - Multi-iteration workflows
    - State management across loops
    - Integrates with PROACTIVELY agents in HYBRID mode
    
    Updated Step 7: Verify Complete Installation
    - Added Ralph CLI verification
    - Added Ralph hook verification
    - Marked Ralph as optional (⚠️)
    
    Updated Summary:
    - Changed 'Two Auto-Triggering Systems' to 'Three'
    - Added Ralph CLI as third system
    - Clarified PROACTIVELY vs Ralph CLI vs Hooks
    
    HYBRID Approach:
    - Users can choose patterns-only (simple)
    - Or Ralph CLI (advanced autonomous)
    - Or combine both for maximum power
    - Default: PROACTIVELY patterns built-in
    - Optional: Ralph CLI for complex workflows
  • Clarify Ralph patterns reference in MASTER-PROMPT
    Changes:
    - Remove Ralph from list of installed components (it was misleading)
    - Change component count from 7 to 6
    - Add Agent Architecture Patterns section explaining:
      - PROACTIVELY coordinators implement proven coordination patterns
      - Patterns inspired by frameworks like Ralph
      - Supervisor-agent delegation and shared context management
    - Clarify Ralph is a conceptual reference, not an installed tool
    
    This prevents confusion - Ralph CLI is not installed, only its
    coordination patterns influenced the agent design.
  • Fix MASTER-PROMPT formatting: single code block for master prompt
    MASTER-PROMPT.md restructure:
    - Master prompt now in ONE continuous code block (bash blocks to plain text
    - Added clear labels for code sections within the prompt
    - Real-life examples now in proper markdown outside code block
    - Configuration examples in separate code blocks after main prompt
    - Quick reference section properly formatted
    - All content preserved, just restructured for proper rendering
    
    The master prompt can now be copied as a single block
    without formatting breaking mid-copy.
  • Update MASTER-PROMPT for agent-updater and sync-agents.sh
    MASTER-PROMPT.md changes:
    - Update agent count: 37 → 38 agents
    - Add Agent Updater to Bonus section (now 3 bonus agents)
    - Add agent-updater as 8th special agent (Utility Agent, on-demand)
    - Add new Step 1.75: Install Agent Sync Script
      - Complete sync-agents.sh installation instructions
      - Usage examples with GITEA_REPO_URL
      - REPO_AGENTS_DIR for updating installer agents
      - Crontab example for automatic weekly sync
      - Rollback instructions
    - Update architecture overview:
      - 7 PROACTIVELY Coordinators (auto-trigger)
      - 1 Utility Agent (manual trigger)
      - 30 Specialist Agents (was 31)
    - Update all agent count references throughout document
    
    This provides complete MASTER-PROMPT installation method with
    automatic agent update capabilities matching the interactive installer.
  • Update agent coordination system documentation
    - Update PROACTIVELY agents from 5 to 7 (add studio-producer, project-shipper)
    - Add clear architecture overview: 7 coordinators + 31 specialists
    - Explain two pathways: automatic vs direct control
    - Add real workflow example showing coordinator orchestration
    - Clarify how coordinators call specialists automatically
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Fix MASTER-PROMPT.md examples section - use proper markdown
    - Replace HTML div tags with proper markdown formatting
    - Use box-drawing characters for visual separation
    - Add clear section headers with emoji indicators
    - Use code blocks with language tags (diff for  examples)
    - Add proper spacing and horizontal rules
    - Ensure GitHub renders all formatting correctly
    - Make examples section clearly distinct from main content
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Add visually distinct examples section to MASTER-PROMPT.md
    - Create prominent boxed section with gradient background
    - Add clear warning box explaining these are illustrative examples only
    - Use color-coded boxes: yellow ( WITHOUT) vs green ( WITH)
    - Add proper visual separation from main installation content
    - Include border styling and padding for clear visual hierarchy
    - Make it immediately clear this is a separate reference section
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Improve MASTER-PROMPT.md examples section clarity
    - Create dedicated 'How Auto-Triggering Works: Practical Examples' section
    - Add clear NOTE explaining these are illustrative examples
    - Consolidate 5 examples showing WITHOUT vs WITH scenarios
    - Add visual separation with headers and dividers
    - Include summary table comparing without vs with auto-triggering
    - Remove duplicate examples scattered throughout document
    - Make it immediately clear these are workflow examples
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Add ui-ux-pro-max agent with PROACTIVELY auto-triggering
    - Install ui-ux-pro-max as agent (~/.claude/agents/design/ui-ux-pro-max.md)
    - Install ui-ux-pro-max as SKILL (~/.claude/skills/ui-ux-pro-max/SKILL.md)
    - Add 5th PROACTIVELY agent for professional UI/UX design
    - Update MASTER-PROMPT.md with Step 1.5 for ui-ux-pro-max installation
    - Update README.md with ui-ux-pro-max integration details
    - Update blog post with ui-ux-pro-max as installed agent
    - Clarify Ralph is CLI tool (patterns integrated, not agents)
    
    Now includes 38 agents with 5 PROACTIVELY auto-triggering:
    1. studio-coach (complex multi-agent tasks)
    2. test-writer-fixer (after code modifications)
    3. whimsy-injector (after UI/UX changes)
    4. experiment-tracker (feature flags/experiments)
    5. ui-ux-pro-max (UI/UX design work)
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Add llm-tldr integration and update documentation
    - Add llm-tldr (95% token reduction) to all installation methods
    - Update MASTER-PROMPT.md with all 6 sources and real-life examples
    - Update README.md with comprehensive source guide
    - Update automation script with TLDR installation and MCP config
    - Update INTEGRATION-GUIDE.md to clarify Z.AI MCP tools work with GLM
    - Add MCP explanation and link to modelcontextprotocol.io
    
    Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
  • Use @z_ai/coding-helper wizard for easier GLM setup
    MAJOR IMPROVEMENT to GLM setup workflow:
    
    Before: Manual configuration with multiple steps
    - Create settings.json manually
    - Copy/paste complex JSON
    - Edit files manually
    - Easy to make mistakes
    
    After: Interactive wizard ( MUCH simpler!)
    - npm install -g @z_ai/coding-helper
    - npx @z_ai/coding-helper init
    - Wizard asks for API key
    - Everything configured automatically
    - Verified working
    
    Benefits:
    -  Fewer steps (3 vs 6+)
    -  Less error-prone
    -  Interactive and guided
    -  Official Z.AI tool
    -  Automatic verification
    
    Updates:
    - MASTER-PROMPT.md: Promote wizard method as "EASIEST"
    - README.md: Add wizard at top as primary method
    - Blog post: Update warning with wizard commands
    - Keep manual method as alternative
    
    This makes GLM setup as simple as:
      npm install -g @z_ai/coding-helper
      npx @z_ai/coding-helper init
      claude
  • Fix GLM chicken-and-egg problem in Master Prompt workflow
    BREAKING CHANGES to workflow:
    - Add 'BEFORE YOU BEGIN' section to MASTER-PROMPT.md
    - GLM users MUST configure GLM FIRST before using Claude Code
    - Add clear GLM pre-configuration steps at top of file
    - Add clear copy boundaries (✂️ COPY FROM HERE / ✂️ COPY ENDS HERE)
    - Add visual separator lines for copy-paste section
    
    README.md updates:
    - Add prominent GLM warning at top of Installation Options
    - Add quick GLM setup commands
    - Clarify Master Prompt workflow with step-by-step
    - Emphasize GLM pre-configuration requirement
    
    This fixes the issue where GLM users couldn't use Claude Code
    to paste the master prompt without first configuring GLM.
  • Integrate official Z.AI GLM Claude Code documentation
    - Add Claude Code installation prerequisite (npm install)
    - Update GLM configuration with official model mappings (glm-4.5-air, glm-4.7)
    - Add version verification (recommended 2.0.14+)
    - Include troubleshooting steps from Z.AI docs
    - Add /status command verification
    - Reference official Z.AI documentation: https://docs.z.ai/devpack/tool/claude
    - Update README with proper GLM model configuration
  • Add MASTER-PROMPT.md - copy-paste installation method for Claude Code
    - Users can now copy-paste a master prompt into Claude Code
    - Includes all source repository references
    - Step-by-step guided installation
    - Alternative to running bash scripts
    - Updated README with 3 installation options