Agentic-BA-RE-Tester-Setup

Agentic-BA-RE-Tester-Setup provides an ARE-based orchestration environment for requirements engineering and testing activities. It layers specialized Agents (e.g., RequirementsEngineer, Testmanager, BusinessAnalyst, EnterpriseArchitekt, PowerBI) and domain Skills to analyze, draft, validate, and maintain requirements, test artifacts, and business insights. You can invoke domain prompts via the Copilot Agent interface (e.g., @RequirementsEngineer, @Testmanager) to perform tasks such as analyzing work items, generating test cases, researching topics, and creating architecture reviews. The included prompts enable rapid generation of management summaries, test plans, feature descriptions, and compliance checks against industry standards like IREB, ISTQB, and SHERPA, with results that can be fed back into your work item or documentation.

To use it effectively, interact with the Agents in your Copilot chat by prefixing with the agent name (e.g., @RequirementsEngineer) and request the appropriate domain task. You can also leverage the built-in prompts listed in the repository to perform targeted actions such as analyzing a WorkItem, creating test cases, or researching an ADO wiki topic. The system is designed to streamline elicitation, verification, and traceability across requirements, tests, and architectural considerations, all while providing structured summaries and actionable recommendations.

Prerequisites

• Docker is installed and running on your machine
• Git is installed
• Optional: Access to a container registry if you plan to pull a private image

Installation steps

1. Clone this repository (or pull the prebuilt container image if available):

   git clone https://github.com/your-org/Agentic-BA-RE-Tester-Setup.git cd Agentic-BA-RE-Tester-Setup

2. (Preferred) Pull and run the Docker image locally (adjust image name if you build locally):

   docker pull agentic-ba-re-tester-setup:latest docker run -it --rm --name agentic-ba-re -v $(pwd)/.assets:/workspace/.assets agentic-ba-re-tester-setup:latest

3. If you are building and running from source, ensure you have a compatible runtime and follow the project’s build steps as documented in the repo’s CONTRIBUTING or setup guide. Configure any required environment variables as described below.

4. Configure environment variables (example):

   export ARE_CONFIG_PATH=/workspace/config/are-config.yaml export ARE_LOG_LEVEL=info

5. Verify startup logs and access the orchestration endpoints or Copilot prompts as documented in the repository’s usage guide.

Tips and common considerations:

• The Agents are orchestrated via the central .github/AGENTS.md file; ensure this file remains up to date to reflect any new or removed Agents.
• If you are running locally, map your workspace assets to the container to preserve outputs (e.g., prompts, summaries, and generated artifacts).
• Review the available prompts (e.g., /analyze_workitem, /create_test_cases, /research_topic) to understand the exact input requirements and expected outputs.
• For large Azure DevOps or SharePoint content, consider enabling verbose logging to diagnose issues with data extraction or prompt results.
• If you encounter environment variable issues, start with ARE_LOG_LEVEL=debug and verify container privileges for accessing mounted volumes.
• The repository emphasizes compliance with standards (IREB, ISTQB, SHERPA); use the analysis prompts to generate traceable documentation and ensure criteria coverage.