code-agent

name	code-agent
description	Write production-quality code from specs — reads requirements, researches patterns, implements with tests, and iterates until verification passes. Use when implementing features, fixing bugs with known root causes, or building new modules.
domain	agents
tags	["agent","ai-agent","automation","code","orchestration"]

Code Agent

When to Use

Trigger phrases:

• "code agent"

• "Implementing a new feature from a spec or plan"

• "Fixing a bug with a known root cause"

• "Writing a new module, service, or library"

• Implementing a new feature from a spec or plan

• Fixing a bug with a known root cause

• Writing a new module, service, or library

• Adding API endpoints with validation and error handling

• Implementing data processing pipelines

• Creating CLI tools or scripts

• Writing configuration or infrastructure code

When NOT to Use

• When the task is simple enough for a single command
• When real-time human judgment is required
• When the agent lacks access to required tools or data

Overview

Code Agent is an AI agent skill for agent orchestration. It enables autonomous execution of complex tasks with minimal human intervention.

Capabilities

• Autonomous operation — Execute multi-step code agent workflows independently
• Context awareness — Adapt behavior based on current state and history
• Error recovery — Handle failures gracefully with retry and fallback logic
• Integration — Connect with external tools and services as needed

Workflow

# Example: Agent orchestration
from dataclasses import dataclass

@dataclass
class Task:
    name: str
    priority: int
    assigned_agent: str

def orchestrate(tasks: list[Task]) -> dict:
    results = {}
    for task in sorted(tasks, key=lambda t: t.priority):
        results[task.name] = execute(task)
    return results

1. Initialize — Set up the agent context and load required resources
2. Plan — Break down the task into executable steps
3. Execute — Run each step, monitoring for errors and adapting as needed
4. Verify — Validate results against acceptance criteria
5. Report — Summarize outcomes and suggest next steps

Configuration

• Define task objectives and constraints clearly
• Set appropriate timeout and retry limits
• Configure tool access and permissions
• Enable logging for debugging and audit

Anti-Rationalization

Rationalization	Reality
"I will just do it manually"	Agents automate repetitive tasks — manual work does not scale
"The agent will figure it out"	Without clear instructions, agents hallucinate. Give explicit context.
"One agent is enough"	Complex tasks benefit from specialized agents working in parallel

Process

1. Design — Define interface, identify patterns, plan implementation
2. Implement — Write code following existing conventions, add tests
3. Verify — Run tests, check integration, validate behavior

Verification

• All steps executed successfully
• Results validated against acceptance criteria
• Error handling tested with edge cases
• Documentation updated with findings