Copilot & Agent configuration

[tmikula-dev]

Overview

Adds detailed agent role definitions for DevOps Engineer, Reviewer, SDET, Senior Developer, and Specification Master in the .github/agents/ directory. Introduces copilot-instructions.md file to have copilot instruction setted for the project.

Release Notes

• Copilot configuration
• Agents project specific configuration

Related

Closes #107

Summary by CodeRabbit

• Documentation

  • Added project guidelines and architecture overview for code standards and structure.
  • Introduced formal role specifications for team collaboration and quality requirements.

• Chores

  • Added local quality gate script for validating code formatting, linting, type checking, and test coverage locally before submission.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[github-actions]

AquaSec has completed a full security repository scan ✅ You can find the analysis results for this PR branch on this overview.
Below is the summary of the findings:

AQUASEC	CRITICAL	HIGH	MEDIUM	LOW	TOTAL
sast	0	4	2	0	6
vulnerabilities	0	0	0	0	0
iacMisconfigurations	1	2	2	10	15
secrets	0	0	0	0	0
pipelineMisconfigurations	0	0	0	16	16
license	0	0	0	0	0
➡️ Total	1	6	4	26	37

[coderabbitai]

Walkthrough

This PR adds AI agent role specifications and copilot configuration to the repository. It introduces five agent documentation files defining roles (DevOps Engineer, Reviewer, SDET, Senior Developer, Specification Master), a copilot instructions guide for the EventGate project, and a local CI quality gates shell script.

Changes

Cohort / File(s)	Summary
Agent Role Documentation \.github/agents/devops-engineer.agent.md, \.github/agents/reviewer.agent.md, \.github/agents/sdet.agent.md, \.github/agents/senior-developer.agent.md, \.github/agents/specification-master.agent.md	Introduces five agent specification files (~35–43 lines each) defining roles, missions, responsibilities, quality gates, collaboration guidelines, and Definition of Done for automated CI/CD and code review workflows.
Project Copilot Configuration \.github/copilot-instructions.md	Adds project-level copilot instructions (~63 lines) documenting architecture, file structure, testing approach, quality gates, route dispatch mechanism, and EventGate patterns to guide AI-assisted development.
Local CI Script ci_local.sh	Introduces a shell script implementing local CI quality gate checks: Black formatting, Pylint linting (min 9.5 score), Mypy type checking, and Pytest coverage validation (≥80%). Enables strict error handling and exits on first failure.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

• lsulak
• petr-pokorny-absa
• oto-macenauer-absa

Poem

🐰 A warren of agents now guard the gate,
With specs and scripts to keep code great,
Copilot whispers wisdom anew,
Quality gates standing strong and true,
Together we build, together we create! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Copilot & Agent configuration' accurately describes the main changes: adding Copilot instructions and agent role definitions.
Description check	✅ Passed	The PR description follows the template with Overview, Release Notes, and Related sections. It clearly describes the additions and references the linked issue #107.
Linked Issues check	✅ Passed	All requirements from issue #107 are met: copilot-instructions.md is added to .github/, and five agent role definitions are included for project-specific configuration.
Out of Scope Changes check	✅ Passed	All changes are in-scope: the PR adds documentation files (.github/agents/*.md, copilot-instructions.md) and a CI script aligned with the stated objectives from issue #107.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@ci_local.sh`:
- Around line 9-16: The shell invocation currently expands unquoted $(git
ls-files '*.py') which breaks on filenames with whitespace; change the two calls
that pass $(git ls-files '*.py') to Black and Pylint to use NUL-delimited file
lists instead (e.g. use git ls-files -z '*.py' | xargs -0 black --check or git
ls-files -z '*.py' | xargs -0 pylint --fail-under=9.5) or capture into a
NUL-aware array (mapfile -d '' FILES < <(git ls-files -z '*.py') && black
--check "${FILES[@]}"); update the occurrences referencing black and pylint so
filenames are handled safely.

🧹 Nitpick comments (1)

.github/agents/reviewer.agent.md (1)

21-21: Consider the maintenance implications of hardcoded implementation details.

The reference to ROUTE_HANDLERS in event_gate_lambda.py provides clear guidance but will require updates if the implementation pattern changes. Consider adding a note that this specification should be reviewed when architectural changes occur.