Label the issue
Code Shepherd listens for signed issue label events and continues only when the configured ready label is present.
AI coding-agent workflow
Code Shepherd
Guide. Review. Protect. Ship.
Code Shepherd turns approved GitHub issues into focused draft pull requests. Label an issue as ready, let the configured agent work in an isolated workspace, and review the result before anything ships.
Draft PRs Only
Isolated Workspaces
Allow Repositories Only
Draft
pull requests stay human-reviewed
Label
agent runs only after explicit approval
Scoped
repositories are allowed by configuration
Issue to pull request
A controlled path from ready issue to reviewable branch.
Run the configured agent
The agent command receives issue context in an isolated working directory without production credentials in its environment.
Open a draft PR
When code changes exist, Shepherd commits to a focused branch, pushes it, and opens a draft pull request for human review.
Report back on the issue
The original issue receives a sanitized success or failure summary so maintainers can see what happened without hunting through logs.
Conservative by default
Automation that stops before the risky parts.
Shepherd is built for teams that want coding-agent leverage without handing over merge buttons, deployments, or unrestricted repository access.
agent/issue-42
Human gate
Draft PR waiting for review
Creates a branch and opens a draft pull request.
Never merges automatically or pushes directly to main.
Never deploys applications or infrastructure.
Runs only on repositories explicitly allowed in configuration.
Operator controls
The workflow is configured, observable, and intentionally narrow.
Trigger label
Choose the issue label that means work is approved for an agent run.
AGENT_TRIGGER_LABEL=agent-ready
Focused branches
Use predictable branch names that map each run back to its issue.
AGENT_BRANCH_PREFIX=agent/issue-
Agent command
Run the coding agent your team already trusts in a clean workspace.
AGENT_COMMAND=...
Optional tests
Run a configured verification command before the draft PR is opened.
AGENT_TEST_COMMAND=...
Ready for approved issues
Let the agent do the first pass. Keep the final say.
Code Shepherd helps teams move from backlog intent to draft pull request without skipping review, safety, or repository boundaries.
Request Access