example-agents

AI-driven SDLC pipeline agents for taskflow-app.

Each agent is a standalone Python script triggered by GitHub Actions. Together they automate the full software development lifecycle:

GitHub Issue
     │
     ▼
┌─────────────┐
│  spec-agent │  Turns issue description into a structured spec comment
└──────┬──────┘
       │ posts spec → triggers tdd-agent workflow
       ▼
┌─────────────┐
│  tdd-agent  │  Generates failing tests based on the spec
└──────┬──────┘
       │ posts tests → triggers code-agent workflow
       ▼
┌─────────────┐
│  code-agent │  Writes implementation to make the tests pass
└──────┬──────┘
       │ opens PR → triggers review-agent workflow
       ▼
┌──────────────┐
│ review-agent │  Reviews the PR for correctness, style, and security
└──────┬───────┘
       │ approves / requests changes
       ▼
┌──────────────┐
│ deploy-agent │  Runs smoke tests and posts deploy checklist on merge
└──────────────┘

Repository layout

example-agents/
├── .github/
│   └── workflows/
│       ├── spec-agent.yml
│       ├── tdd-agent.yml
│       ├── code-agent.yml
│       ├── review-agent.yml
│       └── deploy-agent.yml
├── agents/
│   ├── spec_agent/
│   │   ├── agent.py
│   │   └── prompts.py
│   ├── tdd_agent/
│   │   ├── agent.py
│   │   └── prompts.py
│   ├── code_agent/
│   │   ├── agent.py
│   │   └── prompts.py
│   ├── review_agent/
│   │   ├── agent.py
│   │   └── prompts.py
│   └── deploy_agent/
│       ├── agent.py
│       └── prompts.py
├── shared/
│   ├── claude_client.py
│   └── github_client.py
├── requirements.txt
└── README.md

Required secrets (set in baskard/taskflow-app repository settings)

Secret	Description
ANTHROPIC_API_KEY	Your Anthropic API key
AGENTS_GH_TOKEN	GitHub PAT with repo and issues scopes

Running an agent locally

pip install -r requirements.txt

# Spec agent on issue #42
python -m agents.spec_agent.agent --repo baskard/taskflow-app --issue 42

# TDD agent on issue #42
python -m agents.tdd_agent.agent --repo baskard/taskflow-app --issue 42

# Code agent on issue #42
python -m agents.code_agent.agent --repo baskard/taskflow-app --issue 42

# Review agent on PR #7
python -m agents.review_agent.agent --repo baskard/taskflow-app --pr 7

# Deploy agent on PR #7 after merge
python -m agents.deploy_agent.agent --repo baskard/taskflow-app --pr 7

Set ANTHROPIC_API_KEY and GITHUB_TOKEN (or AGENTS_GH_TOKEN) in your environment or in a .env file before running.

Model

All agents use claude-opus-4-8 (Claude Opus 4.8) — Anthropic's latest and most capable model — with adaptive thinking enabled for highest-quality output.