engineer-agent

engineer-agent

A Claude Code plugin that automates senior software engineer tasks with an approval-gated workflow. The agent polls GitHub, Slack, ticket trackers (Jira or GitHub Issues), and Slite for work, drafts responses, and queues everything for human review before posting externally.

Features

• PR Reviews — Structured code reviews with severity levels (critical/important/suggestion)
• Slack Q&A — Drafts answers to questions in configured channels
• Ticket Implementation — Implements tickets (Jira or GitHub Issues) on feature branches, opens draft PRs
• Doc Reviews — Reviews Slite design documents with inline comments
• Spec Refinement — Analyzes PM feature specs and drafts clarifying questions
• Ticket Refinement — Analyzes existing tickets for scope clarity, feasibility, testability, and Fibonacci sizing
• Design Doc Generation — Creates engineering design docs from refined specs
• Ticket Breakdown — Breaks design docs into phased implementation tickets with dependencies
• QA Test Plans — Generates hybrid test plans (runnable scripts + manual checklists) from ticket acceptance criteria and branch code changes
• Code Audit — Proactive bug/security scan: Sonnet finds candidates across OWASP-style security, correctness, secrets, and dependency CVEs; Opus verifies each one before it enters the queue
• Pipeline Gap Audit — Bidirectional comparison of spec ↔ design doc ↔ tickets to detect mismatches
• Standup Generation — Creates daily standup updates from activity history
• Daily Digest — Summarizes all agent activity with approval metrics
• Push Notifications & Remote Approval — Optional ntfy integration pushes an alert when work is queued and lets you approve/reject from your phone without opening Claude Code

Everything goes through an approval queue — nothing is posted until you say so. One unified queue across all your projects. With ntfy configured, that approval can happen remotely from your phone, and safe actions (draft-PR creation) can be allowed to run hands-free.

Prerequisites

• Claude Code CLI installed and authenticated
• GitHub CLI (gh) — for PR reviews, code operations, and GitHub API access. Install from cli.github.com and run gh auth login
• Spy Slack CLI (spy) — for channel polling and message posting. Spy reuses your local Slack desktop session, so there's no OAuth or app install. Build it from github.com/tomharris/spy (go install ./cmd/spy), sign in to the Slack desktop app, then run spy auth to confirm. Set the workspace via agent.slack.workspace in config (required when multiple workspaces are signed in)
• Jira MCP integration (optional) — for ticket polling and implementation when using Jira as tracker (mcp__atlassian__*). Either Jira or GitHub Issues per project — GitHub Issues uses the gh CLI (already a prerequisite)
• Slite MCP integration (optional) — for document reviews (mcp__slite__*)
• ntfy (optional) — for push notifications and remote approval. No install needed to publish (uses curl against ntfy.sh or your self-hosted server); install the ntfy mobile app to receive alerts and tap Approve/Reject. The approval listener also needs jq on the host running it.

Installation

# For development (loads plugin for this session only)
claude --plugin-dir /path/to/engineer-agent

# For permanent installation
# Inside a Claude Code session, run:
#   /plugin marketplace add /path/to/engineer-agent
#   /plugin install engineer-agent

Then initialize from any project directory:

/engineer-agent setup

This creates the user-level config, queue directories, and installs automated polling in one step. It also registers the current project. After setup, edit ~/.claude/engineer-agent/engineer.yaml to configure your sources.

To register additional projects:

cd /path/to/another-project
/engineer-agent add-project

Configuration

Edit ~/.claude/engineer-agent/engineer.yaml: