envoy

Envoy

Professional .NET/React/Azure development workflows for Claude Code and GitHub Copilot.

Overview

Envoy provides a streamlined workflow from idea to merged PR:

brainstorm → pickup → review → finalize → cleanup

Key features:

• Brainstorming: Turn ideas into designs + implementation plans through Socratic dialogue
• Pickup: Plan writing, worktree setup, and TDD-enforced implementation in one phase
• Review: 5-layer local review (Cleanup, Lint, Sonnet AI, Visual, Docs) with complexity tiers
• Finalization: Create PR, handle GitHub CodeRabbit comments, verify, ship
• Cleanup: Remove worktrees and branches, clear session state, sync wiki
• Hooks: Config protection, batch lint, cost tracking, learning extraction
• Self-learning: Graduated patterns, cross-PR CodeRabbit aggregation, user correction detection
• Token optimization: ~60% cost savings via Sonnet AI review, selective stack loading, regex-first parsing
• Advanced patterns: Eval harness, search-first, iterative retrieval, completion signals

Installation

Claude Code

# Add the marketplace
/plugin marketplace add RutgerDijk/envoy

# Install the plugin
/plugin install envoy@envoy-marketplace

GitHub Copilot

Run the install script from your project root:

/path/to/envoy/adapters/copilot/install.sh

This copies Envoy workflow templates into your project's .github/ directory:

• .github/copilot-instructions.md — Always-active workflow instructions
• .github/prompts/*.prompt.md — Slash commands (/brainstorm, /pickup, /review, etc.)
• .github/instructions/*.instructions.md — Stack-specific guidance (auto-activates by file type)
• .github/agents/*.agent.md — Specialized agents (code-reviewer, security-auditor, test-writer)

Commit the .github/ directory and you're ready to use Envoy in GitHub Copilot Chat.

See adapters/copilot/INSTALL.md for full details and options.

How It Works

Architecture

envoy/
├── .claude-plugin/        # Plugin configuration
│   ├── plugin.json        # Plugin metadata
│   └── marketplace.json   # Marketplace registration
├── hooks/                 # Session lifecycle hooks & automation
│   ├── hooks.json         # Hook registration (profile-annotated)
│   ├── hook-runner.js     # Profile-aware hook execution
│   ├── session-start.sh   # Auto-loads Envoy on startup
│   ├── config-protection.js    # Blocks linter config modifications
│   ├── post-edit-accumulator.js # Tracks edits for batched lint
│   ├── stop-batch-lint.js      # Runs lint once across all edits
│   ├── post-pr-poll.js         # Triggers CodeRabbit polling
│   ├── cost-tracker.js         # Async JSONL token logging
│   └── learning-extractor.js   # Async review pattern learning
├── memory/                # Team learnings (committed, shared via git)
│   ├── review-learnings.md     # Graduated patterns from AI review
│   ├── coderabbit-patterns.md  # Cross-PR CodeRabbit categories
│   └── corrections.md          # Team coding preferences
├── lib/                   # Shared utilities
│   ├── skills-core.js     # Skill discovery & shadowing
│   ├── stack-loader.js    # Stack detection, selective loading
│   ├── coderabbit-parser.js    # Regex-first CodeRabbit comment parser
│   ├── learning-loader.js      # Load confirmed patterns & corrections
│   ├── automation-suggester.js # Suggest hooks/rules for 5x patterns
│   └── loop-safeguards.js      # Completion signal threshold for loops
├── contexts/              # Phase-specific context fragments
│   ├── review.md               # Review phase constraints
│   ├── implement.md            # Implementation phase constraints
│   ├── research.md             # Research phase constraints
│   └── iterative-retrieval.md  # Multi-cycle retrieval protocol
├── commands/              # Entry points for /envoy:* commands
├── agents/                # Specialized agent definitions
├── skills/                # 23 workflow skills
├── stacks/                # 26 technology profiles
├── docs/                  # Anti-patterns & authoring guides
└── adapters/              # Platform adapters
    └── copilot/           # GitHub Copilot (prompts, instructions, agents)

Session Start Hook

When you start Claude Code, Envoy automatically:

1. Loads the using-envoy skill - Claude knows about all Envoy capabilities
2. Detects your tech stack - Scans for .csproj, package.json, tsconfig.json, etc.
3. Reports detected stacks - Shows which profiles are relevant

Detected stacks: dotnet, react, typescript, entity-framework, tailwind

When implementing or reviewing code, load the relevant stack profiles
from `stacks/<stack-name>.md` for best practices and common mistakes.

Skills System

Skills are structured workflows that Claude follows. Each skill has: