Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions agents/iannuttall__claude-agents/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# claude-agents

> A curated collection of seven drop-in Claude Code subagents covering the full software-development lifecycle.

**Author:** [iannuttall](https://github.com/iannuttall)
**Repository:** https://github.com/iannuttall/claude-agents
**License:** MIT
**Model:** Claude Sonnet (via Claude Code)

---

## What it does

`claude-agents` gives you a ready-made AI development team in your `.claude/agents/` folder. Each subagent owns a specific slice of the workflow — Claude Code automatically routes tasks to the right specialist.

## Available agents

| Agent | What it does |
|---|---|
| **security-auditor** | Full codebase security audit: auth, input validation, API security, dependency CVEs, infra config. Outputs a structured `security-report.md` with CVSS-prioritised findings and remediation checklists. |
| **code-refactorer** | Improves structure, naming, and cohesion without changing behaviour. Analyses duplication, complexity, design patterns, and function size before proposing changes. |
| **frontend-designer** | Converts Figma files, wireframes, or screenshots into component architectures and design-system specs for React, Vue, Next.js, etc. |
| **prd-writer** | Creates comprehensive Product Requirements Documents — business goals, personas, functional requirements, UX flows, success metrics, and user stories — saved as `prd.md`. |
| **project-task-planner** | Reads a PRD and generates a phased development roadmap (setup → backend → frontend → integration) saved as `plan.md`. |
| **content-writer** | Direct-response copywriter. Works in outline or write mode. 8th-grade reading level, rhythm-aware, never hallucinates. Outputs clean Markdown articles or blog posts. |
| **vibe-coding-coach** | Helps non-technical builders create apps through conversation and visual references — handles all technical complexity invisibly. |

## Installation

```bash
# Project-specific (recommended)
mkdir -p .claude/agents
cp agents/*.md .claude/agents/

# Global (all projects)
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/
```

Once installed, Claude Code detects and uses the agents automatically.

## Example usage

```
# In Claude Code, just describe what you need:
"Audit my codebase for security vulnerabilities"
→ security-auditor spins up automatically

"Refactor this 300-line auth module"
→ code-refactorer takes over

"I have a Figma mockup — turn it into React components"
→ frontend-designer handles the translation
```

## Why GAP?

This collection is listed in the [Open GAP registry](https://registry.gitagent.sh) so it can be discovered and run on any GAP-compatible runtime — not just Claude Code. The `agent.yaml` manifest and `SOUL.md` persona file (added via [PR #19](https://github.com/iannuttall/claude-agents/pull/19)) follow the [GitAgent Protocol v0.1.0](https://gitagent.sh) spec.
15 changes: 15 additions & 0 deletions agents/iannuttall__claude-agents/metadata.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"name": "claude-agents",
"author": "iannuttall",
"description": "Seven Claude Code subagents covering the full dev lifecycle: security auditing, code refactoring, frontend design, PRD writing, task planning, content writing, and vibe coding.",
"repository": "https://github.com/iannuttall/claude-agents",
"path": "",
"version": "1.0.0",
"category": "developer-tools",
"tags": ["claude-code", "subagents", "security", "refactoring", "frontend", "prd", "planning", "content", "vibe-coding"],
"license": "MIT",
"model": "claude-sonnet-4-5-20250929",
"adapters": ["claude-code", "system-prompt"],
"icon": false,
"banner": false
}
Loading