agents. View on GitHub

An open-source agent playbook

Good work.
Clear roles.
Better agents.

Give your AI collaborators a shared way to work. Reusable roles, practical prompts, and explicit standards for building software with more clarity.

Find your starting point Read the docs

MIT licensedDocs & workflow helpersMade to adapt

A small toolkit.
A shared standard.
16defined agent roles
4files in every role package
Yoursto read, adapt, and extend

01 / A little structure goes a long way

Less guesswork.
More shared understanding.

When every task starts from a blank prompt, expectations drift. Agents gives developers and teams a common starting point for the work, the boundaries, and what “done” means.

[ 01 ]

Give the work a role.

Choose a developer, tester, reviewer, planner, or orchestrator. Each definition describes its mission, inputs, outputs, constraints, and checks.

Explore the roles
[ 02 ]

Start from a real prompt.

Use blank and filled templates, worked input/output examples, and standalone role guides. Adapt them to your project and your AI tool.

Open a template
[ 03 ]

Keep the handoff clear.

Shared policies cover local or Linear tracking, structured handoffs, and worktree behavior. Reusable skills add helpers for checks, testing, and coordination.

Browse the skills

02 / Meet your next collaborator

A role for the work ahead.

All 16 roles on GitHub

A few places to start. These are instructions for your AI tool; choose a role, read its contract, and bring your own project context.

Showing all 6 featured roles.

A+Create

Agent Making Agent

Create a new role package with explicit boundaries, useful examples, and a visible quality rubric.

agent-making-agent
</>Build

Fullstack Developer

Work across frontend and backend with task boundaries, validation checks, and a structured handoff.

fullstack-developer
⌕Review

Deep Code Review

Use a read-only review workflow to surface prioritized findings and actionable remediation tasks.

deep-code-review-agent
Test

Frontend Tester

Verify UI changes, address coverage gaps, and report results with evidence and clear next steps.

frontend-tester
≡Plan

Product Manager

Turn a product goal into a documented plan with atomic tasks and explicit acceptance criteria.

product-manager
⌘Coordinate

Sprint Orchestrator

Coordinate the developer, tester, and reviewer lifecycle using shared tracking and handoff contracts.

sprint-orchestrator-agent

03 / From intent to instructions

A better brief.
A clearer path.

  1. 01

    Choose the right role

    Read its mission and boundaries. Check which skills or connected tools it needs.

  2. 02

    Bring your context

    Adapt the usage template with your goal, repository, constraints, and acceptance criteria.

  3. 03

    Work, verify, hand off

    Give the prompt to your AI tool. Review its output against the role’s checks before continuing.

A prompt with a purpose
# Adapted from the Agent Making template
Agent: agent-making-agent

Goal: Create an agent that drafts
release notes from merged pull requests.

Inputs: Use the Agent Making README
as the standards source. Group release
notes by feature area.

Constraints: Documentation only.
No application code edits.

Output: README.md, USAGE_TEMPLATE.md,
EXAMPLES.md, and USER_GUIDE.html.
See the full template and example

Built in the open

Useful today.
Getting more consistent.

This is a living toolkit. The role packages and helpers are available now; the broader standardization work is ongoing.

Available now
  • 16 role packages with templates and examples
  • Shared policies and handoff schemas
  • Reusable skills and workflow helpers
  • MCP setup docs and config examples
Planned hardening
  • More consistent machine-readable contracts
  • Repository-wide docs quality checks
  • Compatibility and migration guidance
  • Clearer discovery and versioning
Read the project scope

04 / Make it your own

Your next agent
starts here.

Clone the toolkit, pick a role, and tell your AI tool where to find it. Start with one useful workflow.

Full setup instructions
01 / GET THE TOOLKIT
git clone https://github.com/slobodanmargetic988/Agents.git

02Read a role. Adapt its template.Start with Agent Making Agent.03Add tools when your role needs them.Skill installation and MCP setup are separate.

Role definitions work as local instructions. Workflow helpers may need additional tools, configuration, and permissions. Review each role before running it.

MCP setup guide