🤖 Agent Starter Kit

A general-purpose starter kit for AI coding agents — providing a comprehensive structure for instructions, skills, workflows, templates, and agent configuration that covers the full end-to-end development lifecycle.

📁 Folder Structure

agent-starter-kit/
├── agents/                                # Agent configuration
│   ├── coding.agent.md                    # General coding agent
│   ├── agent-builder.agent.md             # Agent customization specialist
│   ├── api-designer.agent.md              # API design specialist
│   ├── architect.agent.md                 # Architecture specialist
│   ├── product-discovery.agent.md         # Product discovery and prioritization specialist
│   ├── code-reviewer.agent.md             # Code review specialist
│   ├── database-engineer.agent.md         # Database specialist
│   ├── devops.agent.md                    # DevOps specialist
│   ├── incident-coordinator.agent.md      # Incident command and communication specialist
│   ├── performance-engineer.agent.md      # Performance specialist
│   ├── security-auditor.agent.md          # Security specialist
│   ├── sre.agent.md                       # Reliability/SRE specialist
│   ├── tech-writer.agent.md               # Documentation specialist
│   ├── tester.agent.md                    # Testing specialist
│   └── doc.agent.md                       # Agent catalog and quick guide
├── instructions/                          # Guidelines & standards
│   ├── general.intructions.md
│   ├── agent-authoring.intructions.md
│   ├── architecture.intructions.md
│   ├── api-design.intructions.md
│   ├── database.intructions.md
│   ├── security.intructions.md
│   ├── performance.intructions.md
│   ├── logging-monitoring.intructions.md
│   ├── code-review.intructions.md
│   ├── git-conventions.intructions.md
│   └── ai-coding-patterns.intructions.md
├── skills/                                # Skill templates
│   ├── agent-authoring/
│   │   └── SKILL.md
│   ├── api-integration/
│   │   └── SKILL.md
│   ├── code-generation/
│   │   └── SKILL.md
│   ├── database-management/
│   │   └── SKILL.md
│   ├── debugging/
│   │   └── SKILL.md
│   ├── documentation/
│   │   └── SKILL.md
│   ├── performance-optimization/
│   │   └── SKILL.md
│   ├── refactoring/
│   │   └── SKILL.md
│   ├── security-audit/
│   │   └── SKILL.md
│   └── testing/
│       └── SKILL.md
├── workflows/                             # Step-by-step workflows
│   ├── setup-project.md
│   ├── feature-development.md
│   ├── bug-fix.md
│   ├── code-review.md
│   ├── deployment.md
│   ├── database-migration.md
│   ├── release.md
│   ├── incident-response.md
│   └── ai-assisted-development.md
├── templates/                             # Ready-to-use templates
│   ├── ci-cd.yml
│   ├── dockerfile
│   ├── docker-compose.yml
│   ├── env.example
│   ├── pr-template.md
│   ├── issue-template.md
│   ├── adr-template.md
│   ├── prd-template.md
│   ├── fsd-template.md
│   ├── ttd-template.md
│   └── hooks/
├── .github/
│   └── copilot-instructions.md
├── .cursorrules
├── .windsurfrules
├── .clinerules
├── CLAUDE.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── SECURITY.md
├── SUPPORT.md
└── README.md

🤖 Available Agents

Agent	File	Best Used For
Coding Agent	agents/coding.agent.md	Daily coding tasks across domains
Agent Builder Agent	agents/agent-builder.agent.md	Creating and refining agent customization packages (agent, skill, instructions, prompt)
API Designer Agent	agents/api-designer.agent.md	API design, versioning, contract consistency
Architect Agent	agents/architect.agent.md	System design, ADRs, architecture trade-offs
Product Discovery Agent	agents/product-discovery.agent.md	Product discovery, requirement shaping, and prioritization
Code Reviewer Agent	agents/code-reviewer.agent.md	Review quality, risks, and maintainability
Database Engineer Agent	agents/database-engineer.agent.md	Data modeling, migrations, query tuning
DevOps Agent	agents/devops.agent.md	CI/CD, IaC, deployment automation
Incident Coordinator Agent	agents/incident-coordinator.agent.md	Incident command, stakeholder communication, and response coordination
Performance Engineer Agent	agents/performance-engineer.agent.md	Profiling and performance optimization
Security Auditor Agent	agents/security-auditor.agent.md	Threat modeling and security hardening
SRE Agent	agents/sre.agent.md	Reliability, SLO/SLI, and incident handling
Tech Writer Agent	agents/tech-writer.agent.md	Technical docs, runbooks, release notes
Tester Agent	agents/tester.agent.md	Testing strategy and quality assurance
Doc Agent	agents/doc.agent.md	Agent catalog, quick selection guidance, and onboarding reference

🧭 Onboarding: When to Use Which Agent

Use this quick map to help new team members choose the right specialist agent from day one.

If You Need To...	Primary Agent	Collaborate With	Expected Output
Clarify user problems, scope, and priorities	Product Discovery Agent	Architect Agent, API Designer Agent	Problem statement, success metrics, MVP scope
Design system architecture and make technical trade-offs	Architect Agent	Product Discovery Agent, Database Engineer Agent	Architecture proposal + ADR-ready decisions
Define or improve API contracts	API Designer Agent	Architect Agent, Coding Agent	Consistent API contract and versioning plan
Implement features and fixes	Coding Agent	Tester Agent, Code Reviewer Agent	Working code aligned with project standards
Design schema, migrations, and query strategy	Database Engineer Agent	Coding Agent, Architect Agent	Data model changes and migration plan
Build test strategy and expand test coverage	Tester Agent	Coding Agent, Code Reviewer Agent	Unit/integration/E2E test plan and cases
Run structured quality and risk review before merge	Code Reviewer Agent	Security Auditor Agent, Performance Engineer Agent	Review findings with severity and recommendations
Investigate latency/throughput bottlenecks	Performance Engineer Agent	SRE Agent, Coding Agent	Performance analysis and optimization actions
Audit security risks and hardening gaps	Security Auditor Agent	Code Reviewer Agent, DevOps Agent	Security findings and remediation backlog
Improve CI/CD, infra automation, and release pipelines	DevOps Agent	SRE Agent, Security Auditor Agent	Safer, repeatable delivery workflow
Improve production reliability and SLO operations	SRE Agent	DevOps Agent, Incident Coordinator Agent	SLO/SLI plan, alerts, and reliability improvements
Coordinate active incidents and stakeholder communication	Incident Coordinator Agent	SRE Agent, DevOps Agent, Security Auditor Agent	Incident timeline, decisions, updates, and follow-ups
Write docs, runbooks, and release communication	Tech Writer Agent	Any domain agent above	Clear, actionable documentation artifacts
Create or refine agent customization packages	Agent Builder Agent	Doc Agent, Coding Agent	Aligned agent + skill + instruction + prompt set
Pick the right specialist when unsure where to start	Doc Agent	Any domain agent above	Fast agent selection and role guidance

Recommended Handoff Flow For New Teams

1. Start with Product Discovery Agent to confirm problem, scope, and success metrics.
2. Move to Architect Agent and/or API Designer Agent for design and contract decisions.
3. Execute implementation with Coding Agent, supported by Database Engineer Agent when data changes are involved.
4. Validate with Tester Agent and Code Reviewer Agent before merge.
5. Productionize with DevOps Agent and SRE Agent, then document outcomes with Tech Writer Agent.
6. During live production incidents, appoint Incident Coordinator Agent as command lead.

🚀 How to Use

1. Clone the Template

git clone <repository-url> my-project/.agents
# or copy this folder into your project

2. Customize the Agent

Edit agents/coding.agent.md to adjust the agent's persona and rules for your project.

3. Add/Edit Instructions

Modify files in instructions/ to add project-specific guidelines.

4. Add Skills

Create a new skills/<name>/SKILL.md file to add new capabilities.

5. Add Workflows

Create a new .md file in workflows/ to add project-specific workflows.

6. Use Templates

Copy files from templates/ into your project and customize them.

📝 Conventions

Folder	Purpose	File Naming
instructions/	Static guidelines that always apply	<topic>.md
skills/	Specific capabilities the agent can invoke	<name>/SKILL.md
workflows/	Step-by-step procedures for specific tasks	<action>.md
templates/	Ready-to-use project templates	Varies by type
agents/	Agent identity and behavior config	coding.agent.md and <role>.agent.md

🔧 Customization

This template is designed to be flexible. You can:

• Add/remove instructions based on project needs
• Create new skills for specific domains
• Add workflows for custom business processes
• Modify the agent persona in agents/coding.agent.md
• Use agents/doc.agent.md as a quick selection guide for specialist agents
• Add project-specific templates

🧭 Project Governance Docs

For project collaboration, safety, and support channels, refer to:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md
• SUPPORT.md

💬 Contributing & Requests

This is an open-source project — contributions and requests from the community are welcome!

🙋 Requesting New Content

Have an idea for a new agent, skill, workflow, or template? Here's how to request it:

1. Open an Issue — Go to the Issues tab and create a new issue
2. Use the appropriate label:
   • request: agent — Request a new agent configuration (e.g., Database Engineer, Security Auditor)
   • request: skill — Request a new skill (e.g., GraphQL, Kubernetes management)
   • request: workflow — Request a new workflow (e.g., hotfix process, A/B testing)
   • request: template — Request a new template (e.g., Terraform config, K8s manifest)
   • request: instruction — Request a new instruction/guideline
3. Describe your request — Include:
   • What you need and why it's useful
   • Example use cases
   • Any reference materials or best practices to consider

🤝 Contributing Directly

Want to contribute directly? We'd love your help!

1. Fork the repository
2. Create a branch — feature/add-<name>-agent or feature/add-<name>-skill
3. Follow the conventions — Match the existing file structure and format
4. Submit a Pull Request — Use the PR template in templates/pr-template.md

Contribution Guidelines

• Follow the naming conventions in the Conventions table above
• Each file should be self-contained and well-documented
• Use best practices and cite references where applicable
• Keep content language/framework-agnostic unless it's a specific implementation template
• Test your workflows and templates before submitting

💡 Ideas We'd Love to See

Here are some areas where community contributions would be especially valuable:

Category	Ideas
Agents	Database Engineer, Security Auditor, Performance Engineer, Data Engineer
Skills	GraphQL, Kubernetes, Terraform, Monitoring setup
Workflows	Hotfix, A/B testing, Load testing, Disaster recovery
Templates	Terraform modules, K8s manifests, Monitoring dashboards

📢 Feedback & Discussions

• Bug reports → Open an issue with the bug label
• General questions → Use the Discussions tab
• Feature ideas → Open an issue with the enhancement label

📄 License

This project is open-source. See the LICENSE file for details.