Skip to content

Instantly share code, notes, and snippets.

View galligan's full-sized avatar
🧪
Tinkering

Matt Galligan galligan

🧪
Tinkering
View GitHub Profile
@galligan
galligan / gitbutler-agentic-analysis-prompt.md
Created October 24, 2025 16:00
Comprehensive prompt for analyzing GitButler in agentic development workflows

GitButler for Agentic Development: Comprehensive Analysis and Ideation

Context

I've been evaluating GitButler as a replacement for Graphite in my AI-agent-driven development workflows. Through extensive hands-on testing with multiple AI agents (Claude Code and Droid), we've documented GitButler's capabilities, limitations, and potential for agentic collaboration.

Materials Provided

You have access to:

  • GITBUTLER.md: Comprehensive CLI reference and workflow patterns
@galligan
galligan / GITBUTLER-FEEDBACK.md
Last active October 24, 2025 15:51
GitButler Multi-Agent Workflow Feedback - Comprehensive testing by Claude (Anthropic) & Droid (OpenAI Codex)

GitButler Feedback: Multi-Agent Workflow Testing

  • From: Claude (Anthropic) + Droid (OpenAI Codex)
  • Human-in-the-loop: Matt Galligan ([email protected])
  • Date: 2025-10-24
  • Context: Evaluated GitButler as Graphite alternative for AI agent workflows
  • Testing Duration: ~90 minutes of intensive CLI usage
  • Test Scenario: Two independent AI agents working concurrently in same repository

@galligan
galligan / documentation-refactoring-synopsis.md
Created October 23, 2025 16:03
Comprehensive documentation refactoring: Simplifying AI agent instructions for the q CLI project

Documentation Refactoring: Simplifying Agent Instructions

Overview

This document chronicles a comprehensive refactoring of the q CLI project's documentation structure, transforming a sprawling set of overlapping files into a clean, hierarchical system optimized for AI agent consumption.

Initial State

The project had documentation scattered across multiple locations with significant duplication:

@galligan
galligan / amp-review-blz.md
Created October 22, 2025 20:58
Amp's Review of BLZ (Blaze): An AI agent's honest feedback on local-first documentation search

Amp's Review of BLZ (Blaze)

An AI agent's honest feedback on local-first documentation search


TL;DR

Rating: ⭐ 9.7/10

Blaze is production-grade infrastructure for AI documentation retrieval. It's a semantic documentation database with AI-native tooling, featuring millisecond search across 1M+ lines, Boolean queries, multi-range retrieval, and revolutionary --prompt self-documentation for agents.

@galligan
galligan / inquire-migration-issue.md
Created October 20, 2025 19:50
Linear Issue: Migrate CLI prompts from dialoguer to inquire

Migrate CLI prompts from dialoguer to inquire

Overview

Replace dialoguer with inquire for interactive CLI prompts to gain better API ergonomics, type safety, and enhanced features.

Current State

We currently use dialoguer = "0.11" in 3 files with 7 total usages:

  • remove.rs: Single Confirm prompt (line 152)

Factory × Linear Integration — Early Feedback & Suggestions

  • Author: Matt Galligan
  • Date: October 15, 2025
  • Reference: docs.factory.ai/changelog/1-8#linear-integration

TL;DR

  • Assigning a Linear issue to the Factory agent consistently results in a reply of “What would you like to do next?”, despite droid sessions showing an initial instruction like “Implement all the required work to finish this Linear Ticket.” (see Screenshot 1 and Screenshot 2
  • Status transitions are not automated. Tickets remain in Triage or To Do even while work is underway or a PR is opened.

BLZ: Comprehensive Review & Testing Report

Date: October 9, 2025 Tester: Claude (Sonnet 4.5) - AI Coding Assistant Testing Context: Evaluating BLZ as a documentation tool for AI agent workflows Version Tested: Latest (as of Oct 2025)


Executive Summary

Get Agents to try BLZ

Step 1: Install blz

Install the blz CLI tool. See the Quickstart doc.

Step 2: Prompt your agent to try using it

I want you to try using blz, a CLI tool for docs search that can download, index, and query llms.txt files locally. You can start by running the command "blz --prompt".
@galligan
galligan / outfitter-climb-considerations.md
Created September 28, 2025 18:42
@outfitter/climb CLI Setup Library - Design Considerations

@outfitter/climb Design Considerations

Based on analysis of waymark/, carabiner/, and rulesets/ projects

Common Patterns Across Projects

Core Stack

  • Runtime: Bun (all projects use Bun as primary runtime and package manager)
  • Monorepo: Bun workspaces with packages/* and apps/* structure
  • Build: Turbo for task orchestration