Add Software Engineering Team Collection - AI Assistants for Multi-Disciplinary Development Teams (#478)

* Add Software Engineering Team collection with 7 specialized agents

Adds a complete Software Engineering Team collection with 7 standalone
agents covering the full development lifecycle, based on learnings from
The AI-Native Engineering Flow experiments.

New Agents (all prefixed with 'se-' for collection identification):
- se-ux-ui-designer: Jobs-to-be-Done analysis, user journey mapping,
  and Figma-ready UX research artifacts
- se-technical-writer: Creates technical documentation, blogs, and tutorials
- se-gitops-ci-specialist: CI/CD pipeline debugging and GitOps workflows
- se-product-manager-advisor: GitHub issue creation and product guidance
- se-responsible-ai-code: Bias testing, accessibility, and ethical AI
- se-system-architecture-reviewer: Architecture reviews with Well-Architected
- se-security-reviewer: OWASP Top 10/LLM/ML security and Zero Trust

Key Features:
- Each agent is completely standalone (no cross-dependencies)
- Concise display names for GitHub Copilot dropdown ("SE: [Role]")
- Fills gaps in awesome-copilot (UX design, content creation, CI/CD debugging)
- Enterprise patterns: OWASP, Zero Trust, WCAG, Well-Architected Framework

Collection manifest, auto-generated docs, and all agents follow
awesome-copilot conventions.

Source: https://github.com/niksacdev/engineering-team-agents
Learnings: https://medium.com/data-science-at-microsoft/the-ai-native-engineering-flow-5de5ffd7d877

* Fix Copilot review comments: table formatting and code block syntax

- Fix table formatting in docs/README.collections.md by converting multi-line
  Software Engineering Team entry to single line
- Fix code block language in se-gitops-ci-specialist.agent.md from yaml to json
  for package.json example (line 41-51)
- Change comment syntax from # to // to match JSON conventions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fix model field capitalization to match GitHub Copilot convention

- Change all agents from 'model: gpt-5' to 'model: GPT-5' (uppercase)
- Aligns with existing GPT-5 agents in the repo (blueprint-mode, gpt-5-beast-mode)
- Addresses Copilot reviewer feedback on consistency

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Add ADR and User Guide templates to Technical Writer agent

- Add Architecture Decision Records (ADR) template following Michael Nygard format
- Add User Guide template with task-oriented structure
- Include references to external best practices (ADR.github.io, Write the Docs)
- Update Specialized Focus Areas to reference new templates
- Keep templates concise without bloating agent definition

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fix inconsistent formatting: DevOps/CI-CD to DevOps/CI/CD

- Change "DevOps/CI-CD" (hyphen) to "DevOps/CI/CD" (slash) for consistency
- Fixed in collection manifest, collection docs, and README
- Aligns with standard industry convention and agent naming

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Shorten collection description per maintainer feedback

- Brief description in table: "7 specialized agents covering the full software
  development lifecycle from UX design and architecture to security and DevOps."
- Move detailed context (Medium article, design principles, agent list) to
  usage section following edge-ai-tasks pattern
- Addresses @aaronpowell feedback: descriptions should be brief for table display

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Nik Sachdeva
2025-12-11 17:12:10 -05:00
committed by GitHub
parent 2e605eab42
commit 095323704f
11 changed files with 1711 additions and 0 deletions

View File

@@ -0,0 +1,42 @@
id: software-engineering-team
name: Software Engineering Team
description: 7 specialized agents covering the full software development lifecycle from UX design and architecture to security and DevOps.
tags: [team, enterprise, security, devops, ux, architecture, product, ai-ethics]
items:
- path: agents/se-ux-ui-designer.agent.md
kind: agent
usage: |
## About This Collection
This collection of 7 agents is based on learnings from [The AI-Native Engineering Flow](https://medium.com/data-science-at-microsoft/the-ai-native-engineering-flow-5de5ffd7d877) experiments at Microsoft, designed to augment software engineering teams across the entire development lifecycle.
**Key Design Principles:**
- **Standalone**: Each agent works independently without cross-dependencies
- **Enterprise-ready**: Incorporates OWASP, Zero Trust, WCAG, and Well-Architected frameworks
- **Lifecycle coverage**: From UX research → Architecture → Development → Security → DevOps
**Agents in this collection:**
- **SE: UX Designer** - Jobs-to-be-Done analysis and user journey mapping
- **SE: Tech Writer** - Technical documentation, blogs, ADRs, and user guides
- **SE: DevOps/CI** - CI/CD debugging and deployment troubleshooting
- **SE: Product Manager** - GitHub issues with business context and acceptance criteria
- **SE: Responsible AI** - Bias testing, accessibility (WCAG), and ethical development
- **SE: Architect** - Architecture reviews with Well-Architected frameworks
- **SE: Security** - OWASP Top 10, LLM/ML security, and Zero Trust
You can use individual agents as needed or adopt the full collection for comprehensive team augmentation.
- path: agents/se-technical-writer.agent.md
kind: agent
- path: agents/se-gitops-ci-specialist.agent.md
kind: agent
- path: agents/se-product-manager-advisor.agent.md
kind: agent
- path: agents/se-responsible-ai-code.agent.md
kind: agent
- path: agents/se-system-architecture-reviewer.agent.md
kind: agent
- path: agents/se-security-reviewer.agent.md
kind: agent
display:
ordering: manual
show_badge: true