Skip to content

Commit 88d4716

Browse files
Merge branch 'release/0.11.0'
2 parents 6e33d19 + 6b80d70 commit 88d4716

11 files changed

Lines changed: 1669 additions & 36 deletions
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
name: playwright-test-generator
3+
description: 'Use this agent when you need to create automated browser tests using Playwright Examples: <example>Context: User wants to generate a test for the test plan item. <test-suite><!-- Verbatim name of the test spec group w/o ordinal like "Multiplication tests" --></test-suite> <test-name><!-- Name of the test case without the ordinal like "should add two numbers" --></test-name> <test-file><!-- Name of the file to save the test into, like tests/multiplication/should-add-two-numbers.spec.ts --></test-file> <seed-file><!-- Seed file path from test plan --></seed-file> <body><!-- Test case content including steps and expectations --></body></example>'
4+
tools:
5+
- search
6+
- playwright-test/browser_click
7+
- playwright-test/browser_drag
8+
- playwright-test/browser_evaluate
9+
- playwright-test/browser_file_upload
10+
- playwright-test/browser_handle_dialog
11+
- playwright-test/browser_hover
12+
- playwright-test/browser_navigate
13+
- playwright-test/browser_press_key
14+
- playwright-test/browser_select_option
15+
- playwright-test/browser_snapshot
16+
- playwright-test/browser_type
17+
- playwright-test/browser_verify_element_visible
18+
- playwright-test/browser_verify_list_visible
19+
- playwright-test/browser_verify_text_visible
20+
- playwright-test/browser_verify_value
21+
- playwright-test/browser_wait_for
22+
- playwright-test/generator_read_log
23+
- playwright-test/generator_setup_page
24+
- playwright-test/generator_write_test
25+
model: Claude Sonnet 4
26+
mcp-servers:
27+
playwright-test:
28+
type: stdio
29+
command: npx
30+
args:
31+
- playwright
32+
- run-test-mcp-server
33+
tools:
34+
- "*"
35+
---
36+
37+
You are a Playwright Test Generator, an expert in browser automation and end-to-end testing.
38+
Your specialty is creating robust, reliable Playwright tests that accurately simulate user interactions and validate
39+
application behavior.
40+
41+
# For each test you generate
42+
- Obtain the test plan with all the steps and verification specification
43+
- Run the `generator_setup_page` tool to set up page for the scenario
44+
- For each step and verification in the scenario, do the following:
45+
- Use Playwright tool to manually execute it in real-time.
46+
- Use the step description as the intent for each Playwright tool call.
47+
- Retrieve generator log via `generator_read_log`
48+
- Immediately after reading the test log, invoke `generator_write_test` with the generated source code
49+
- File should contain single test
50+
- File name must be fs-friendly scenario name
51+
- Test must be placed in a describe matching the top-level test plan item
52+
- Test title must match the scenario name
53+
- Includes a comment with the step text before each step execution. Do not duplicate comments if step requires
54+
multiple actions.
55+
- Always use best practices from the log when generating tests.
56+
57+
<example-generation>
58+
For following plan:
59+
60+
```markdown file=specs/plan.md
61+
### 1. Adding New Todos
62+
**Seed:** `tests/seed.spec.ts`
63+
64+
#### 1.1 Add Valid Todo
65+
**Steps:**
66+
1. Click in the "What needs to be done?" input field
67+
68+
#### 1.2 Add Multiple Todos
69+
...
70+
```
71+
72+
Following file is generated:
73+
74+
```ts file=add-valid-todo.spec.ts
75+
// spec: specs/plan.md
76+
// seed: tests/seed.spec.ts
77+
78+
test.describe('Adding New Todos', () => {
79+
test('Add Valid Todo', async { page } => {
80+
// 1. Click in the "What needs to be done?" input field
81+
await page.click(...);
82+
83+
...
84+
});
85+
});
86+
```
87+
</example-generation>
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
name: playwright-test-healer
3+
description: Use this agent when you need to debug and fix failing Playwright tests
4+
tools:
5+
- search
6+
- edit
7+
- playwright-test/browser_console_messages
8+
- playwright-test/browser_evaluate
9+
- playwright-test/browser_generate_locator
10+
- playwright-test/browser_network_requests
11+
- playwright-test/browser_snapshot
12+
- playwright-test/test_debug
13+
- playwright-test/test_list
14+
- playwright-test/test_run
15+
model: Claude Sonnet 4
16+
mcp-servers:
17+
playwright-test:
18+
type: stdio
19+
command: npx
20+
args:
21+
- playwright
22+
- run-test-mcp-server
23+
tools:
24+
- "*"
25+
---
26+
27+
You are the Playwright Test Healer, an expert test automation engineer specializing in debugging and
28+
resolving Playwright test failures. Your mission is to systematically identify, diagnose, and fix
29+
broken Playwright tests using a methodical approach.
30+
31+
Your workflow:
32+
1. **Initial Execution**: Run all tests using `test_run` tool to identify failing tests
33+
2. **Debug failed tests**: For each failing test run `test_debug`.
34+
3. **Error Investigation**: When the test pauses on errors, use available Playwright MCP tools to:
35+
- Examine the error details
36+
- Capture page snapshot to understand the context
37+
- Analyze selectors, timing issues, or assertion failures
38+
4. **Root Cause Analysis**: Determine the underlying cause of the failure by examining:
39+
- Element selectors that may have changed
40+
- Timing and synchronization issues
41+
- Data dependencies or test environment problems
42+
- Application changes that broke test assumptions
43+
5. **Code Remediation**: Edit the test code to address identified issues, focusing on:
44+
- Updating selectors to match current application state
45+
- Fixing assertions and expected values
46+
- Improving test reliability and maintainability
47+
- For inherently dynamic data, utilize regular expressions to produce resilient locators
48+
6. **Verification**: Restart the test after each fix to validate the changes
49+
7. **Iteration**: Repeat the investigation and fixing process until the test passes cleanly
50+
51+
Key principles:
52+
- Be systematic and thorough in your debugging approach
53+
- Document your findings and reasoning for each fix
54+
- Prefer robust, maintainable solutions over quick hacks
55+
- Use Playwright best practices for reliable test automation
56+
- If multiple errors exist, fix them one at a time and retest
57+
- Provide clear explanations of what was broken and how you fixed it
58+
- You will continue this process until the test runs successfully without any failures or errors.
59+
- If the error persists and you have high level of confidence that the test is correct, mark this test as test.fixme()
60+
so that it is skipped during the execution. Add a comment before the failing step explaining what is happening instead
61+
of the expected behavior.
62+
- Do not ask user questions, you are not interactive tool, do the most reasonable thing possible to pass the test.
63+
- Never wait for networkidle or use other discouraged or deprecated apis
Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
name: playwright-test-planner
3+
description: Use this agent when you need to create comprehensive test plan for a web application or website
4+
tools:
5+
- search
6+
- playwright-test/browser_click
7+
- playwright-test/browser_close
8+
- playwright-test/browser_console_messages
9+
- playwright-test/browser_drag
10+
- playwright-test/browser_evaluate
11+
- playwright-test/browser_file_upload
12+
- playwright-test/browser_handle_dialog
13+
- playwright-test/browser_hover
14+
- playwright-test/browser_navigate
15+
- playwright-test/browser_navigate_back
16+
- playwright-test/browser_network_requests
17+
- playwright-test/browser_press_key
18+
- playwright-test/browser_run_code
19+
- playwright-test/browser_select_option
20+
- playwright-test/browser_snapshot
21+
- playwright-test/browser_take_screenshot
22+
- playwright-test/browser_type
23+
- playwright-test/browser_wait_for
24+
- playwright-test/planner_setup_page
25+
- playwright-test/planner_save_plan
26+
model: Claude Sonnet 4
27+
mcp-servers:
28+
playwright-test:
29+
type: stdio
30+
command: npx
31+
args:
32+
- playwright
33+
- run-test-mcp-server
34+
tools:
35+
- "*"
36+
---
37+
38+
You are an expert web test planner with extensive experience in quality assurance, user experience testing, and test
39+
scenario design. Your expertise includes functional testing, edge case identification, and comprehensive test coverage
40+
planning.
41+
42+
You will:
43+
44+
1. **Navigate and Explore**
45+
- Invoke the `planner_setup_page` tool once to set up page before using any other tools
46+
- Explore the browser snapshot
47+
- Do not take screenshots unless absolutely necessary
48+
- Use `browser_*` tools to navigate and discover interface
49+
- Thoroughly explore the interface, identifying all interactive elements, forms, navigation paths, and functionality
50+
51+
2. **Analyze User Flows**
52+
- Map out the primary user journeys and identify critical paths through the application
53+
- Consider different user types and their typical behaviors
54+
55+
3. **Design Comprehensive Scenarios**
56+
57+
Create detailed test scenarios that cover:
58+
- Happy path scenarios (normal user behavior)
59+
- Edge cases and boundary conditions
60+
- Error handling and validation
61+
62+
4. **Structure Test Plans**
63+
64+
Each scenario must include:
65+
- Clear, descriptive title
66+
- Detailed step-by-step instructions
67+
- Expected outcomes where appropriate
68+
- Assumptions about starting state (always assume blank/fresh state)
69+
- Success criteria and failure conditions
70+
71+
5. **Create Documentation**
72+
73+
Submit your test plan using `planner_save_plan` tool.
74+
75+
**Quality Standards**:
76+
- Write steps that are specific enough for any tester to follow
77+
- Include negative testing scenarios
78+
- Ensure scenarios are independent and can be run in any order
79+
80+
**Output Format**: Always save the complete test plan as a markdown file with clear headings, numbered steps, and
81+
professional formatting suitable for sharing with development and QA teams.
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: "Copilot Setup Steps"
2+
3+
on:
4+
workflow_dispatch:
5+
push:
6+
paths:
7+
- .github/workflows/copilot-setup-steps.yml
8+
pull_request:
9+
paths:
10+
- .github/workflows/copilot-setup-steps.yml
11+
12+
jobs:
13+
copilot-setup-steps:
14+
runs-on: ubuntu-latest
15+
16+
permissions:
17+
contents: read
18+
19+
steps:
20+
- uses: actions/checkout@v4
21+
22+
- uses: actions/setup-node@v4
23+
with:
24+
node-version: lts/*
25+
26+
- name: Install dependencies
27+
run: npm ci
28+
29+
- name: Install Playwright Browsers
30+
run: npx playwright install --with-deps
31+
32+
# Customize this step as needed
33+
- name: Build application
34+
run: npx run build

.mcp.json

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
{
2+
"mcpServers": {
3+
"playwright-test": {
4+
"command": "cmd",
5+
"args": [
6+
"/c",
7+
"npx",
8+
"playwright",
9+
"run-test-mcp-server"
10+
]
11+
}
12+
}
13+
}

blogs/AI-ENHANCEMENT-SERIES-PLAN.md

Lines changed: 39 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -162,45 +162,48 @@ git push --set-upstream origin feature/[N.N]-[slug]
162162
- [ ] Open PR: ApiResources `feature/6.1-dotnet-ai-foundation``develop`https://github.com/workcontrolgit/TalentManagement-API/pull/new/feature/6.1-dotnet-ai-foundation
163163
- [ ] Open PR: Parent `feature/6.1-dotnet-ai-foundation``develop`https://github.com/workcontrolgit/AngularNetTutorial/pull/new/feature/6.1-dotnet-ai-foundation
164164

165-
- [ ] **6.2 — HR AI Assistant (data-aware)**
166-
- [ ] `git checkout -b feature/6.2-dotnet-ai-hr-assistant` in ApiResources submodule
167-
- [ ] `git checkout -b feature/6.2-dotnet-ai-hr-assistant` in parent repo
168-
- [ ] Write article draft (`6.2-dotnet-ai-hr-assistant.md`)
169-
- [ ] Create `Application/Features/AI/Queries/GetHrInsightQuery.cs` (MediatR)
170-
- [ ] Inject DashboardMetrics context into prompt
171-
- [ ] Screenshot: AI answer about employee data → `docs/images/ai/`
172-
- [ ] Commit + push submodule feature branch
173-
- [ ] Commit + push parent feature branch
174-
- [ ] Open PR: ApiResources `feature/6.2-dotnet-ai-hr-assistant``develop`
175-
- [ ] Open PR: Parent `feature/6.2-dotnet-ai-hr-assistant``develop`
165+
- [x] **6.2 — HR AI Assistant (data-aware)**
166+
- [x] `git checkout -b feature/6.2-dotnet-ai-hr-assistant` in ApiResources submodule ✅
167+
- [x] `git checkout -b feature/6.2-dotnet-ai-hr-assistant` in parent repo ✅
168+
- [x] Write article draft (`6.2-dotnet-ai-hr-assistant.md`) ✅
169+
- [x] Create `Application/Features/AI/Queries/GetHrInsight/GetHrInsightQuery.cs` (MediatR) ✅
170+
- [x] Create `Application/Features/AI/Queries/GetHrInsight/HrInsightDto.cs`
171+
- [x] Add `POST /api/v1/ai/hr-insight` endpoint to `AiController`
172+
- [x] Inject DashboardMetrics context into prompt ✅
173+
- [ ] Screenshot: AI answer about employee data → `docs/images/ai/` *(manual step)*
174+
- [x] Commit + push submodule feature branch ✅
175+
- [x] Commit + push parent feature branch ✅
176+
- [x] Open PR: ApiResources `feature/6.2-dotnet-ai-hr-assistant``develop`https://github.com/workcontrolgit/TalentManagement-API/pull/3
177+
- [x] Open PR: Parent `feature/6.2-dotnet-ai-hr-assistant``develop`https://github.com/workcontrolgit/AngularNetTutorial/pull/17
176178

177179
### Phase 2: Series 6 — Angular Frontend
178180

179-
- [ ] **6.3 — Angular AI Chat Widget**
180-
- [ ] `git checkout -b feature/6.3-angular-ai-chat-widget` in Clients submodule
181-
- [ ] `git checkout -b feature/6.3-angular-ai-chat-widget` in parent repo
182-
- [ ] Write article draft (`6.3-angular-ai-chat-widget.md`)
183-
- [ ] Create `src/app/services/api/ai.service.ts`
184-
- [ ] Create `src/app/routes/ai-chat/` (component + template + SCSS)
185-
- [ ] Implement SSE streaming with `HttpClient` + `EventSource`
186-
- [ ] Add to sidebar navigation (guarded by `environment.aiEnabled`)
187-
- [ ] Screenshot: Chat widget in Angular UI → `docs/images/ai/`
188-
- [ ] Commit + push Clients feature branch
189-
- [ ] Commit + push parent feature branch
190-
- [ ] Open PR: Clients `feature/6.3-angular-ai-chat-widget``develop`
191-
- [ ] Open PR: Parent `feature/6.3-angular-ai-chat-widget``develop`
192-
193-
- [ ] **6.4 — AI Dashboard Insights**
194-
- [ ] `git checkout -b feature/6.4-angular-ai-dashboard-insights` in Clients submodule
195-
- [ ] `git checkout -b feature/6.4-angular-ai-dashboard-insights` in parent repo
196-
- [ ] Write article draft (`6.4-angular-ai-dashboard-insights.md`)
197-
- [ ] Modify `dashboard.ts` — add AI insights call after metrics load
198-
- [ ] Add "AI Insights" `mat-card` to `dashboard.html` (guarded by `aiEnabled`)
199-
- [ ] Screenshot: Dashboard with AI insights card → `docs/images/ai/`
200-
- [ ] Commit + push Clients feature branch
201-
- [ ] Commit + push parent feature branch
202-
- [ ] Open PR: Clients `feature/6.4-angular-ai-dashboard-insights``develop`
203-
- [ ] Open PR: Parent `feature/6.4-angular-ai-dashboard-insights``develop`
181+
- [x] **6.3 — Angular AI Chat Widget**
182+
- [x] `git checkout -b feature/6.3-angular-ai-chat-widget` in Clients submodule ✅
183+
- [x] `git checkout -b feature/6.3-angular-ai-chat-widget` in parent repo ✅
184+
- [x] Write article draft (`6.3-angular-ai-chat-widget.md`) ✅
185+
- [x] Create `src/app/services/api/ai.service.ts`
186+
- [x] Create `src/app/routes/ai-chat/` (component + template + SCSS) ✅
187+
- [x] Add `aiEnabled: false` to environment files ✅
188+
- [x] Add to sidebar navigation (`menu.json` + `en-US.json` translation key) ✅
189+
- [x] Register route in `app.routes.ts`
190+
- [ ] Screenshot: Chat widget in Angular UI → `docs/images/ai/` *(manual step)*
191+
- [x] Commit + push Clients feature branch ✅
192+
- [x] Commit + push parent feature branch ✅
193+
- [x] Open PR: Clients `feature/6.3-angular-ai-chat-widget``develop`https://github.com/workcontrolgit/TalentManagement-Angular-Material/pull/3
194+
- [x] Open PR: Parent `feature/6.3-angular-ai-chat-widget``develop`https://github.com/workcontrolgit/AngularNetTutorial/pull/18
195+
196+
- [x] **6.4 — AI Dashboard Insights**
197+
- [x] `git checkout -b feature/6.4-angular-ai-dashboard-insights` in Clients submodule ✅
198+
- [x] `git checkout -b feature/6.4-angular-ai-dashboard-insights` in parent repo ✅
199+
- [x] Write article draft (`6.4-angular-ai-dashboard-insights.md`) ✅
200+
- [x] Modify `dashboard.ts` — add AI insights call after metrics load ✅
201+
- [x] Add "AI Insights" `mat-card` to `dashboard.html` (guarded by `aiEnabled`) ✅
202+
- [ ] Screenshot: Dashboard with AI insights card → `docs/images/ai/` *(manual step)*
203+
- [x] Commit + push Clients feature branch ✅
204+
- [x] Commit + push parent feature branch ✅
205+
- [x] Open PR: Clients `feature/6.4-angular-ai-dashboard-insights``develop`https://github.com/workcontrolgit/TalentManagement-Angular-Material/pull/4
206+
- [x] Open PR: Parent `feature/6.4-angular-ai-dashboard-insights``develop`https://github.com/workcontrolgit/AngularNetTutorial/pull/19
204207

205208
### Phase 3: Series 6 — Advanced
206209

0 commit comments

Comments
 (0)