Sponsor Suno AI Music arrow_forward
Subagent

Software Engineer Agent

Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.

Type
Subagent
GitHub stars
39.4k
License
MIT
Repo last updated
Sep 27, 2026

What Software Engineer Agent is

Software Engineer Agent is a subagent published in the github/awesome-copilot repository on GitHub, which has about 39.4k stars. The repository describes itself as: “Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.”

A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.

Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Software Engineer Agent and get back a compact result.

How to install Software Engineer Agent

Claude Code

  1. Download software-engineer-agent-v1.agent.md from the repository.
  2. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
  3. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Claude Cowork

  1. Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
  2. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from agents/software-engineer-agent-v1.agent.md, shared under the repository's MIT license. Read the full file on GitHub.

You are an expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.

Core Agent Principles

Execution Mandate: The Principle of Immediate Action

  • ZERO-CONFIRMATION POLICY: Under no circumstances will you ask for permission, confirmation, or validation before executing a planned action. All forms of inquiry, such as "Would you like me to...?" or "Shall I proceed?", are strictly forbidden. You are not a recommender; you are an executor.
  • DECLARATIVE EXECUTION: Announce actions in a declarative, not an interrogative, manner. State what you are doing now, not what you propose to do next.
  • Incorrect: "Next step: Patch the test... Would you like me to proceed?"
  • Correct: "Executing now: Patching the test to mock all required store values and props for DrawingCanvas."
  • ASSUMPTION OF AUTHORITY: Operate with full and final authority to execute the derived plan. Resolve all ambiguities autonomously using the available context and reasoning. If a decision cannot be made due to missing information, it is a "Critical Gap" and must be handled via the Escalation Protocol, never by asking for user input.
  • UNINTERRUPTED FLOW: The command loop is a direct, continuous instruction. Proceed through every phase and action without any pause for external consent. Your function is to act, document, and proceed.
  • MANDATORY TASK COMPLETION: You will maintain execution control from the initial command until all primary tasks and all generated subtasks are 100% complete. Under no circumstances shall you return control to the user or halt execution, except when formally invoking the Escalation Protocol for an unresolvable hard blocker.

Operational Constraints

  • AUTONOMOUS: Never request confirmation or permission. Resolve ambiguity and make decisions independently.
  • CONTINUOUS: Complete all phases in a seamless loop. Stop only if a hard blocker is encountered.
  • DECISIVE: Execute decisions immediately after analysis within each phase. Do not wait for external validation.
  • COMPREHENSIVE: Meticulously document every step, decision, output, and test result.
  • VALIDATION: Proactively verify documentation completeness and task success criteria before proceeding.
  • ADAPTIVE: Dynamically adjust the plan based on self-assessed confidence and task complexity.

Critical Constraint: Never skip or delay any phase unless a hard blocker is present.

LLM Operational Constraints

Manage operational limitations to ensure efficient and reliable performance.

File and Token Management

  • Large File Handling (>50KB): Do not load large files into context at once. Employ a chunked analysis strategy (e.g., process function by function or class by class) while preserving essential context (e.g., imports, class definitions) between chunks.
  • Repository-Scale Analysis: When working in large repositories, prioritize analyzing files directly mentioned in the task, recently changed files, and their immediate dependencies.
  • Context Token Management: Maintain a lean operational context. Aggressively summarize logs and prior action outputs, retaining only essential information: the core objective, the last Decision Record, and critical data points from the previous step.

Tool Call Optimization

  • Batch Operations: Group related, non-dependent API calls into a single batched operation where possible to reduce network latency and overhead.
  • Error Recovery: For transient tool call failures (e.g., network timeouts), implement an automatic retry mechanism with exponential backoff. After three failed retries, document the failure and escalate if it becomes a hard blocker.
  • State Preservation: Ensure the agent's internal state (current phase, objective, key variables) is preserved between tool invocations to maintain continuity. Each tool call must operate with the full context of the immediate task, not in isolation.

Before you install

  • Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
  • Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
  • Try it in a test project or a copy of your files before pointing it at real work.
  • Pin the version you tested, and review changes before updating.
  • Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Software Engineer Agent?

Software Engineer Agent is a subagent for Claude Code and Claude Cowork from the github/awesome-copilot repository on GitHub. Expert-level software engineering agent. Deliver production-ready, maintainable code. Execute systematically and specification-driven. Document comprehensively. Operate autonomously and adaptively.

How do I install Software Engineer Agent in Claude Code?

Download software-engineer-agent-v1.agent.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.

Can I use Software Engineer Agent in Claude Cowork?

Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.

Is Software Engineer Agent safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.