# Agents Index

This file is the top-level index for the custom agents in this repository.

## Layout Convention

- Canonical agent file: `.github/agents/<agent-name>.agent.md`
- Canonical skills: `.github/skills/<skill-name>/SKILL.md`

The `agents` directory contains only agent definitions.
All skills are centralized under `.github/skills/`.

## Agent Overview

| Agent | Purpose | Canonical Agent File | Canonical Skills Dir | Tools |
|---|---|---|---|---|
| Branch Review Engineer | Reviews branch diffs, proposes improvements, checks TestLink coverage for changed autotests, and applies approved fixes | `branch-review.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo` |
| Docker Build & Test Engineer | Builds, validates, and repairs Docker images and container startup flows | `docker-build-test.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `ms-azuretools.vscode-containers/containerToolsConfig`, `todo` |
| OpenWrt VPN & Network Engineer | Designs and validates OpenWrt VPN routing with DNS policy, split tunneling, GeoIP/ASN selectors, and selective tunnel rules by destination IP/domain | `openwrt-network.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `web`, `io.github.upstash/context7/*`, `todo` |
| TestLink Autotest Engineer | Generates autotests from TestLink cases, reviews them, and stabilizes the resulting test runs | `testlink-autotest.agent.md` | `.github/skills/` | `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo` |

## Skills by Agent

### Branch Review Engineer

- Agent: [branch-review.agent.md](branch-review.agent.md)
- Tools: `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo`
- Skills:
  - `branch-review-read-code`
  - `branch-review-analyze`
  - `branch-review-check-testlink`
  - `branch-review-propose`
  - `branch-review-apply`
- Workflow shape:
  - read branch context and `pyproject.toml`
  - analyze improvements
  - optionally verify changed autotests against TestLink
  - propose improvements
  - apply only approved items
- Confirmation points:
  - before applying proposed fixes
  - when risky refactoring would exceed the changed scope

### Docker Build & Test Engineer

- Agent: [docker-build-test.agent.md](docker-build-test.agent.md)
- Tools: `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `ms-azuretools.vscode-containers/containerToolsConfig`, `todo`
- Skills:
  - `dockerfile-builder`
  - `dockerfile-tester`
- Workflow shape:
  - build draft container setup
  - validate build and runtime
  - loop on targeted repairs up to the retry limit
- Confirmation points:
  - after retry limit is hit
  - when required runtime inputs cannot be inferred

### TestLink Autotest Engineer

- Agent: [testlink-autotest.agent.md](testlink-autotest.agent.md)
- Tools: `execute`, `read`, `edit`, `search`, `io.github.upstash/context7/*`, `testlink/*`, `todo`
- Skills:
  - `testlink-decompose`
  - `autotest-writer`
  - `python-review`
  - `test-runner`
  - `testlink-to-autotest`
- Workflow shape:
  - fetch and decompose TestLink case
  - write autotests from mini-tests
  - review and improve test code
  - run and stabilize tests
- Confirmation points:
  - after mini-test decomposition
  - after optional green-tier suggestions from review

### OpenWrt VPN & Network Engineer

- Agent: [openwrt-network.agent.md](openwrt-network.agent.md)
- Tools: `execute`, `read`, `edit`, `search`, `web`, `io.github.upstash/context7/*`, `todo`
- Skills:
  - `openwrt-network-discovery`
  - `openwrt-vpn-routing`
  - `openwrt-network-hardening`
- Workflow shape:
  - discover topology, policy constraints, and MCP/webhook requirements
  - design VPN and routing for xray/sing-box/WireGuard/OpenVPN
  - harden deployment and validate split tunnel/GeoIP/ASN behavior
- Confirmation points:
  - after discovery summary and before config planning
  - before execution of routing changes
  - when MCP/webhook integration data is incomplete

## Canonical Paths

These are canonical and should remain stable:

- `.github/agents/branch-review.agent.md`
- `.github/agents/docker-build-test.agent.md`
- `.github/agents/openwrt-network.agent.md`
- `.github/agents/testlink-autotest.agent.md`
- `.github/skills/*`

## When to Update This File

Update this index when:

- a new agent is added
- an agent gains or loses skills
- confirmation points or workflow stages change materially
- compatibility exports are renamed or removed