Complete development workflow: research → plan → implement → validate → ship. Includes research agents, planning tools, handoff system, Linear integration, and PM commands.
This document defines the standard pattern for commands that should automatically discover recent documents from workflow context.
Context management and workflow tools using Linear documents.
Monitor a PR through CI, run the test plan against the deployment preview, and update the PR when done
Create conventional commits for session changes
Create handoff document for passing work to another session
This directory contains markdown files that define specialized research agents for Claude Code.
Analyzes codebase implementation details. Call the codebase-analyzer agent when you need to find detailed information about specific components. As always, the more detailed your request prompt, the better! :)
Locates files, directories, and components relevant to a feature or task. Call `codebase-locator` with human language prompt describing what you're looking for. Basically a "Super Grep/Glob/LS tool" — Use it if you find yourself desiring to use one of these tools more than once.
codebase-pattern-finder is a useful subagent_type for finding similar implementations, usage examples, or existing patterns that can be modeled after. It will give you concrete code examples based on what you're looking for! It's sorta like codebase-locator, but it will not only tell you the location of files, it will also give you code details!
Research external GitHub repositories, frameworks, and libraries using DeepWiki and Exa. Call when you need to understand how popular repos implement features, learn framework patterns, or research best practices from open-source projects. Use Exa for web search when docs are insufficient.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Threading Needles' development workflow for Claude Code, open sourced and packaged as a Claude Code plugin marketplace.
Awl is the workflow we use daily at Threading Needles for AI-assisted development. It's battle-tested on real projects and optimized for efficient, context-aware AI collaboration.
Awl integrates with your development tools through MCP servers and CLI tools:
awl-dev, automatic OAuth)
awl-dev: Core research agents and workflow commandsawl-pm: Advanced PM workflows (cycle analysis, milestone tracking, backlog grooming)gh)
awl-dev: PR creation, branch management, worktree workflowsawl-debugging: PostHog error tracking MCP integrationawl-analytics: PostHog MCP integration (~40k tokens when enabled)awl-dev: Built-in, always availableawl-dev: Built-in, always availableawl-dev: External research agentWhy CLI + lightweight MCP? Most development sessions don't need heavy integrations:
awl-dev (~3.5k tokens): Core workflow + Linear + GitHubawl-analytics when analyzing user behavior (~+40k tokens)awl-debugging when investigating production errors (~+20k tokens)This keeps your typical session lean while having powerful tools available when needed.
Awl is a 5-plugin system for Claude Code focused on token efficiency, session-aware MCP management, and persistent context through parallel agent research, structured handoffs, and shared memory systems.
awl-dev (Core - Always enabled)
awl-pm (Optional - Enable for project management)
awl-analytics (Optional - Enable when needed)
awl-debugging (Optional - Enable when needed)
awl-meta (Optional - For advanced users)
Get started in 5 minutes with the unified setup script:
# Download the setup script
curl -O https://raw.githubusercontent.com/Threading-Needles/awl/main/setup-awl.sh
chmod +x setup-awl.sh
# Run it (requires interactive input)
./setup-awl.sh
This script will guide you through:
Then install the plugins:
# In Claude Code:
/plugin marketplace add Threading-Needles/awl
/plugin install awl-dev
# Restart Claude Code
You're ready! Try /awl-dev:research-codebase in your next session.
Recommended: Add the Awl workflow snippet to your project's CLAUDE.md. See CLAUDE.md Setup for the copy-paste snippet.
See QUICKSTART.md for detailed setup instructions.
Alternatively, install plugins manually via Claude Code plugin system:
# Add the marketplace repository
/plugin marketplace add Threading-Needles/awl
# Install core workflow (required)
/plugin install awl-dev
# Optional: Install PM plugin (Linear project management)
/plugin install awl-pm
npx claudepluginhub threading-needles/awl --plugin awl-devProduction error monitoring with PostHog MCP integration. Enable when debugging errors, analyzing stack traces, and investigating incidents. Provides error tracking, session replay, and HogQL queries.
Product analytics with PostHog MCP integration. Enable when analyzing user behavior, conversion metrics, and product usage. ~40k context tokens when enabled.
Linear-focused project management plugin with cycle management, milestone tracking, initiative analysis, status updates, backlog grooming, and team analytics
Workflow discovery and creation tools: learn from community patterns and extend Awl with new workflows.
Autonomous development methodology: PRD interviews → agent execution → automated review
AI-native BizDevOps rhythm manager for Claude Code — multi-role collaboration, change impact analysis, quality gates, goal-to-code traceability, and cross-session continuity
Context-Driven Development plugin that transforms Claude Code into a project management tool with structured workflow: Context → Spec & Plan → Implement
12 PM-specific agent skills, 6 workflow commands, 3 automation hooks for Product Managers
Corca Workflow Framework — consolidated hooks and skill orchestration for structured development sessions
Implementation planning, execution, and PR creation workflows with multi-agent collaboration