QA Agent 🤖

Internal command-line tool (CLI) to help the QA team manage their work, especially during the transition to test automation.

Developed at Runtime Revolution.

---

Requirements

• Python 3.x
• pip

---

Installation

1. Clone or copy the project to your machine

2. Navigate to the project folder:

cd qa-agent

3. Create and activate the virtual environment:

python3 -m venv venv
source venv/bin/activate

4. Install dependencies:

pip install click

---

Available Commands

📋 List all test cases

python agent/cli.py list-tests

🔍 View details of a specific test case

python agent/cli.py show TC-001

✏️ Update the state of a test case

python agent/cli.py update-state TC-001 Passed

Available states: Active Passed Failed Blocked In Progress

➕ Add a new test case

python agent/cli.py add-test

🗺️ View the team roadmap

python agent/cli.py roadmap

📜 View the change history in the terminal

python agent/cli.py history

📤 Export change history to Markdown

python agent/cli.py export-history

Generates file: knowledge_base/history.md

📤

📁 qa-agent/ ├── 📁 agent/ │ └── 📄 cli.py ← CLI source code ├── 📁 knowledge_base/ │ ├── 📁 test_cases/ │ │ └── 📄 test_cases.json ← test cases database │ ├── 📁 roadmap/ │ │ └── 📄 roadmap.md ← team roadmap │ ├── 📁 guidelines/ │ │ └── 📄 guidelines.md ← QA best practices │ ├── 📄 history.json ← history in JSON (internal use) │ ├── 📄 history.md ← exported change history │ └── 📄 test_cases_history.md ← exported test cases history └── 📁 venv/ ← virtual environment (do not share)

---

Important Notes

• Always activate the virtual environment before using the tool: source venv/bin/activate
• Never delete a test case — change the state to Blocked if no longer applicable
• Update roadmap.md whenever a step is completed
• The venv/ folder should not be shared or pushed to Git