[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7D9M2DKWSYFYQCBFBCFMBVH":3,"skill-same:01M7D9M2DKWSYFYQCBFBCFMBVH":79},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":57,"commitSha":58,"skillDirectory":59,"forksCount":14,"repositoryHtmlUrl":60,"repositoryHomepageUrl":6,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":63,"updatedAt":64,"install":65,"resources":78},"01M7D9M2DKWSYFYQCBFBCFMBVH","Serenity BDD Testing",null,"Java BDD testing with Serenity BDD framework using the Screenplay pattern, Cucumber integration, step libraries, comprehensive reporting, and living documentation generation.","GrupoANDevelopment-m\u002Falberto-ai","GrupoANDevelopment-m","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F257455179?v=4","01M7D69X2N2KEVN0SJF6WGM6SH","Antônio  Ndombe","01M7D69X3P5JTT8H8S904N3888",0,"MIT","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fskills\u002Fqa\u002Fserenity-bdd-testing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: \"Serenity BDD Testing\"\ndescription: \"Java BDD testing with Serenity BDD framework using the Screenplay pattern, Cucumber integration, step libraries, comprehensive reporting, and living documentation generation.\"\nversion: 1.0.0\nauthor: thetestingacademy\nlicense: MIT\ntags: [serenity, bdd, java, screenplay, cucumber, reporting, living-documentation, step-libraries]\ntestingTypes: [bdd, acceptance, e2e, integration]\nframeworks: [serenity-bdd]\nlanguages: [java]\ndomains: [web, api, backend]\nagents: [claude-code, cursor, github-copilot, windsurf, codex, aider, continue, cline, zed, bolt]\n---\n\n# Serenity BDD Testing\n\nYou are an expert QA engineer specializing in Serenity BDD, the Java testing framework that produces rich living documentation. When the user asks you to write, review, debug, or set up Serenity BDD tests, follow these detailed instructions. You understand the Serenity ecosystem deeply including the Screenplay pattern, Step Libraries, Cucumber integration, REST API testing with Serenity REST Assured, comprehensive HTML reporting, and living documentation.\n\n## Core Principles\n\n1. **Living Documentation** — Serenity generates rich HTML reports that serve as living documentation. Write tests that produce meaningful, stakeholder-readable reports.\n2. **Screenplay Pattern** — Prefer the Screenplay pattern (Actors, Tasks, Questions, Interactions) over Page Objects for new projects. It scales better and produces clearer reports.\n3. **Step Libraries** — Use `@Step` annotated methods in dedicated step classes. Serenity records each step in reports with automatic screenshots.\n4. **Layered Architecture** — Separate test logic into layers: business rules (features\u002Ftests), tasks\u002Fworkflows, page interactions, and technical infrastructure.\n5. **Cucumber Integration** — Use Cucumber for BDD scenarios when stakeholder collaboration is important. Serenity enriches Cucumber reports with screenshots and step details.\n6. **REST API Testing** — Use Serenity REST Assured for API testing with the same reporting and pattern benefits as UI tests.\n7. **Parallel Execution** — Configure parallel execution through Maven Surefire\u002FFailsafe plugins. Design tests for isolation and independence.\n\n## Project Structure\n\n```\nproject-root\u002F\n├── pom.xml                           # Maven configuration with Serenity dependencies\n├── serenity.conf                     # Serenity configuration (HOCON format)\n├── src\u002F\n│   └── test\u002F\n│       ├── java\u002F\n│       │   ├── features\u002F\n│       │   │   ├── auth\u002F\n│       │   │   │   └── LoginTest.java\n│       │   │   ├── shopping\u002F\n│       │   │   │   └── CartTest.java\n│       │   │   └── CucumberTestRunner.java\n│       │   ├── screenplay\u002F\n│       │   │   ├── tasks\u002F\n│       │   │   │   ├── Login.java\n│       │   │   │   ├── NavigateTo.java\n│       │   │   │   └── AddToCart.java\n│       │   │   ├── questions\u002F\n│       │   │   │   ├── DashboardInfo.java\n│       │   │   │   └── CartDetails.java\n│       │   │   ├── interactions\u002F\n│       │   │   │   └── EnterCredentials.java\n│       │   │   └── ui\u002F\n│       │   │       ├── LoginPage.java\n│       │   │       ├── DashboardPage.java\n│       │   │       └── CartPage.java\n│       │   ├── steps\u002F\n│       │   │   ├── AuthSteps.java\n│       │   │   ├── NavigationSteps.java\n│       │   │   └── ShoppingSteps.java\n│       │   ├── stepdefinitions\u002F\n│       │   │   ├── LoginStepDefs.java\n│       │   │   └── CartStepDefs.java\n│       │   └── config\u002F\n│       │       └── TestConfig.java\n│       └── resources\u002F\n│           ├── features\u002F\n│           │   ├── auth\u002F\n│           │   │   └── login.feature\n│           │   └── shopping\u002F\n│           │       └── cart.feature\n│           └── serenity.conf\n├── target\u002F\n│   └── site\u002F\n│       └── serenity\u002F                 # Generated HTML reports\n└── .github\u002F\n    └── workflows\u002F\n        └── serenity.yml\n```\n\n## Detailed Code Examples\n\n### Screenplay Pattern - Tasks\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Ftasks\u002FLogin.java\npackage screenplay.tasks;\n\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.Task;\nimport net.serenitybdd.screenplay.actions.Click;\nimport net.serenitybdd.screenplay.actions.Enter;\nimport net.thucydides.core.annotations.Step;\nimport screenplay.ui.LoginPage;\n\nimport static net.serenitybdd.screenplay.Tasks.instrumented;\n\npublic class Login implements Task {\n\n    private final String email;\n    private final String password;\n\n    public Login(String email, String password) {\n        this.email = email;\n        this.password = password;\n    }\n\n    public static Login withCredentials(String email, String password) {\n        return instrumented(Login.class, email, password);\n    }\n\n    public static Login asAdmin() {\n        return instrumented(Login.class, \"admin@example.com\", \"AdminPass123\");\n    }\n\n    public static Login asUser() {\n        return instrumented(Login.class, \"user@example.com\", \"UserPass123\");\n    }\n\n    @Override\n    @Step(\"{0} logs in with email #email\")\n    public \u003CT extends Actor> void performAs(T actor) {\n        actor.attemptsTo(\n            Enter.theValue(email).into(LoginPage.EMAIL_INPUT),\n            Enter.theValue(password).into(LoginPage.PASSWORD_INPUT),\n            Click.on(LoginPage.LOGIN_BUTTON)\n        );\n    }\n}\n\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Ftasks\u002FNavigateTo.java\npackage screenplay.tasks;\n\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.Task;\nimport net.serenitybdd.screenplay.actions.Open;\nimport net.thucydides.core.annotations.Step;\nimport screenplay.ui.LoginPage;\n\nimport static net.serenitybdd.screenplay.Tasks.instrumented;\n\npublic class NavigateTo {\n\n    public static Task theLoginPage() {\n        return instrumented(NavigateToLoginPage.class);\n    }\n\n    public static Task theDashboard() {\n        return instrumented(NavigateToDashboard.class);\n    }\n\n    static class NavigateToLoginPage implements Task {\n        LoginPage loginPage;\n\n        @Override\n        @Step(\"{0} navigates to the login page\")\n        public \u003CT extends Actor> void performAs(T actor) {\n            actor.attemptsTo(Open.browserOn(loginPage));\n        }\n    }\n\n    static class NavigateToDashboard implements Task {\n        @Override\n        @Step(\"{0} navigates to the dashboard\")\n        public \u003CT extends Actor> void performAs(T actor) {\n            actor.attemptsTo(Open.url(\"\u002Fdashboard\"));\n        }\n    }\n}\n```\n\n### Screenplay Pattern - Questions\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Fquestions\u002FDashboardInfo.java\npackage screenplay.questions;\n\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.Question;\nimport net.serenitybdd.screenplay.questions.Text;\nimport screenplay.ui.DashboardPage;\n\npublic class DashboardInfo {\n\n    public static Question\u003CString> welcomeMessage() {\n        return Text.of(DashboardPage.WELCOME_MESSAGE);\n    }\n\n    public static Question\u003CBoolean> isDisplayed() {\n        return actor -> {\n            try {\n                return DashboardPage.WELCOME_MESSAGE.resolveFor(actor).isVisible();\n            } catch (Exception e) {\n                return false;\n            }\n        };\n    }\n\n    public static Question\u003CInteger> notificationCount() {\n        return actor -> {\n            String text = Text.of(DashboardPage.NOTIFICATION_BADGE).answeredBy(actor);\n            return Integer.parseInt(text.trim());\n        };\n    }\n}\n```\n\n### Screenplay Pattern - UI Targets\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Fui\u002FLoginPage.java\npackage screenplay.ui;\n\nimport net.serenitybdd.screenplay.targets.Target;\nimport net.serenitybdd.core.pages.PageObject;\nimport net.thucydides.core.annotations.DefaultUrl;\n\n@DefaultUrl(\"\u002Flogin\")\npublic class LoginPage extends PageObject {\n    public static final Target EMAIL_INPUT =\n        Target.the(\"email input\").locatedBy(\"[data-testid='email-input']\");\n\n    public static final Target PASSWORD_INPUT =\n        Target.the(\"password input\").locatedBy(\"[data-testid='password-input']\");\n\n    public static final Target LOGIN_BUTTON =\n        Target.the(\"login button\").locatedBy(\"[data-testid='login-submit']\");\n\n    public static final Target ERROR_MESSAGE =\n        Target.the(\"error message\").locatedBy(\"[data-testid='error-message']\");\n\n    public static final Target FORGOT_PASSWORD_LINK =\n        Target.the(\"forgot password link\").locatedBy(\"a[href='\u002Fforgot-password']\");\n}\n\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Fui\u002FDashboardPage.java\npackage screenplay.ui;\n\nimport net.serenitybdd.screenplay.targets.Target;\n\npublic class DashboardPage {\n    public static final Target WELCOME_MESSAGE =\n        Target.the(\"welcome message\").locatedBy(\"[data-testid='welcome-message']\");\n\n    public static final Target NOTIFICATION_BADGE =\n        Target.the(\"notification badge\").locatedBy(\"[data-testid='notification-count']\");\n\n    public static final Target USER_MENU =\n        Target.the(\"user menu\").locatedBy(\"[data-testid='user-menu']\");\n\n    public static final Target LOGOUT_BUTTON =\n        Target.the(\"logout button\").locatedBy(\"[data-testid='logout']\");\n}\n```\n\n### JUnit 5 Test with Screenplay\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Ffeatures\u002Fauth\u002FLoginTest.java\npackage features.auth;\n\nimport net.serenitybdd.junit5.SerenityJUnit5Extension;\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.abilities.BrowseTheWeb;\nimport net.serenitybdd.screenplay.ensure.Ensure;\nimport org.junit.jupiter.api.*;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.openqa.selenium.WebDriver;\nimport screenplay.questions.DashboardInfo;\nimport screenplay.tasks.Login;\nimport screenplay.tasks.NavigateTo;\nimport screenplay.ui.LoginPage;\nimport net.serenitybdd.screenplay.questions.Text;\n\n@ExtendWith(SerenityJUnit5Extension.class)\n@DisplayName(\"User Authentication\")\nclass LoginTest {\n\n    Actor alice = Actor.named(\"Alice\");\n\n    @BeforeEach\n    void setup() {\n        alice.can(BrowseTheWeb.with(theDefaultDriver()));\n    }\n\n    @Test\n    @DisplayName(\"Should login successfully with valid credentials\")\n    @Tag(\"smoke\")\n    void shouldLoginSuccessfully() {\n        alice.attemptsTo(\n            NavigateTo.theLoginPage(),\n            Login.withCredentials(\"user@example.com\", \"SecurePass123\")\n        );\n\n        alice.attemptsTo(\n            Ensure.that(DashboardInfo.welcomeMessage()).contains(\"Welcome\")\n        );\n    }\n\n    @Test\n    @DisplayName(\"Should show error for invalid credentials\")\n    @Tag(\"negative\")\n    void shouldShowErrorForInvalidCredentials() {\n        alice.attemptsTo(\n            NavigateTo.theLoginPage(),\n            Login.withCredentials(\"user@example.com\", \"wrongpassword\")\n        );\n\n        alice.attemptsTo(\n            Ensure.that(Text.of(LoginPage.ERROR_MESSAGE)).isEqualTo(\"Invalid credentials\")\n        );\n    }\n\n    @Test\n    @DisplayName(\"Should show validation error for empty email\")\n    @Tag(\"negative\")\n    void shouldShowErrorForEmptyEmail() {\n        alice.attemptsTo(\n            NavigateTo.theLoginPage(),\n            Login.withCredentials(\"\", \"password123\")\n        );\n\n        alice.attemptsTo(\n            Ensure.that(LoginPage.ERROR_MESSAGE).isDisplayed()\n        );\n    }\n}\n```\n\n### Cucumber Integration\n\n```gherkin\n# src\u002Ftest\u002Fresources\u002Ffeatures\u002Fauth\u002Flogin.feature\n@auth\nFeature: User Authentication\n  As a registered user\n  I want to login to the application\n  So that I can access my personalized dashboard\n\n  Background:\n    Given Alice is on the login page\n\n  @smoke @positive\n  Scenario: Successful login with valid credentials\n    When she logs in with email \"user@example.com\" and password \"SecurePass123\"\n    Then she should see the dashboard\n    And she should see a welcome message containing \"Welcome\"\n\n  @negative\n  Scenario: Login fails with invalid credentials\n    When she logs in with email \"user@example.com\" and password \"wrongpassword\"\n    Then she should see an error message \"Invalid credentials\"\n```\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fstepdefinitions\u002FLoginStepDefs.java\npackage stepdefinitions;\n\nimport io.cucumber.java.en.Given;\nimport io.cucumber.java.en.Then;\nimport io.cucumber.java.en.When;\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.ensure.Ensure;\nimport net.serenitybdd.screenplay.questions.Text;\nimport screenplay.questions.DashboardInfo;\nimport screenplay.tasks.Login;\nimport screenplay.tasks.NavigateTo;\nimport screenplay.ui.LoginPage;\n\npublic class LoginStepDefs {\n\n    Actor alice;\n\n    @Given(\"{actor} is on the login page\")\n    public void onLoginPage(Actor actor) {\n        this.alice = actor;\n        actor.attemptsTo(NavigateTo.theLoginPage());\n    }\n\n    @When(\"she logs in with email {string} and password {string}\")\n    public void loginWith(String email, String password) {\n        alice.attemptsTo(Login.withCredentials(email, password));\n    }\n\n    @Then(\"she should see the dashboard\")\n    public void shouldSeeDashboard() {\n        alice.attemptsTo(\n            Ensure.that(DashboardInfo.isDisplayed()).isTrue()\n        );\n    }\n\n    @Then(\"she should see a welcome message containing {string}\")\n    public void shouldSeeWelcomeMessage(String text) {\n        alice.attemptsTo(\n            Ensure.that(DashboardInfo.welcomeMessage()).contains(text)\n        );\n    }\n\n    @Then(\"she should see an error message {string}\")\n    public void shouldSeeError(String message) {\n        alice.attemptsTo(\n            Ensure.that(Text.of(LoginPage.ERROR_MESSAGE)).isEqualTo(message)\n        );\n    }\n}\n```\n\n### Step Library Pattern (Classic Approach)\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fsteps\u002FAuthSteps.java\npackage steps;\n\nimport net.serenitybdd.core.pages.PageObject;\nimport net.thucydides.core.annotations.Step;\nimport org.openqa.selenium.By;\nimport static org.assertj.core.api.Assertions.assertThat;\n\npublic class AuthSteps extends PageObject {\n\n    @Step(\"Navigate to the login page\")\n    public void navigateToLoginPage() {\n        openUrl(getBaseUrl() + \"\u002Flogin\");\n        waitForElementVisible(By.cssSelector(\"[data-testid='email-input']\"));\n    }\n\n    @Step(\"Enter email: {0}\")\n    public void enterEmail(String email) {\n        find(By.cssSelector(\"[data-testid='email-input']\")).clear();\n        find(By.cssSelector(\"[data-testid='email-input']\")).sendKeys(email);\n    }\n\n    @Step(\"Enter password\")\n    public void enterPassword(String password) {\n        find(By.cssSelector(\"[data-testid='password-input']\")).clear();\n        find(By.cssSelector(\"[data-testid='password-input']\")).sendKeys(password);\n    }\n\n    @Step(\"Click the login button\")\n    public void clickLoginButton() {\n        find(By.cssSelector(\"[data-testid='login-submit']\")).click();\n    }\n\n    @Step(\"Verify user is on the dashboard\")\n    public void verifyOnDashboard() {\n        waitForCondition()\n            .until(driver -> driver.getCurrentUrl().contains(\"\u002Fdashboard\"));\n        assertThat(getDriver().getCurrentUrl()).contains(\"\u002Fdashboard\");\n    }\n\n    @Step(\"Verify welcome message contains: {0}\")\n    public void verifyWelcomeMessage(String text) {\n        String message = find(By.cssSelector(\"[data-testid='welcome-message']\")).getText();\n        assertThat(message).contains(text);\n    }\n\n    @Step(\"Verify error message: {0}\")\n    public void verifyErrorMessage(String expected) {\n        String actual = find(By.cssSelector(\"[data-testid='error-message']\")).getText();\n        assertThat(actual).isEqualTo(expected);\n    }\n}\n```\n\n### REST API Testing with Serenity\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Ffeatures\u002Fapi\u002FUsersApiTest.java\npackage features.api;\n\nimport io.restassured.http.ContentType;\nimport net.serenitybdd.junit5.SerenityJUnit5Extension;\nimport net.serenitybdd.rest.SerenityRest;\nimport org.junit.jupiter.api.*;\nimport org.junit.jupiter.api.extension.ExtendWith;\n\nimport static net.serenitybdd.rest.SerenityRest.*;\nimport static org.hamcrest.Matchers.*;\n\n@ExtendWith(SerenityJUnit5Extension.class)\n@DisplayName(\"Users API\")\nclass UsersApiTest {\n\n    private static final String BASE_URL = \"http:\u002F\u002Flocalhost:3000\u002Fapi\";\n\n    @Test\n    @DisplayName(\"Should return list of users\")\n    @Tag(\"api\")\n    @Tag(\"smoke\")\n    void shouldReturnUsers() {\n        given()\n            .baseUri(BASE_URL)\n            .contentType(ContentType.JSON)\n        .when()\n            .get(\"\u002Fusers\")\n        .then()\n            .statusCode(200)\n            .body(\"size()\", greaterThan(0))\n            .body(\"[0].name\", notNullValue())\n            .body(\"[0].email\", notNullValue());\n    }\n\n    @Test\n    @DisplayName(\"Should create a new user\")\n    @Tag(\"api\")\n    void shouldCreateUser() {\n        String userJson = \"\"\"\n            {\n                \"name\": \"Alice Johnson\",\n                \"email\": \"alice@example.com\",\n                \"role\": \"user\"\n            }\n            \"\"\";\n\n        given()\n            .baseUri(BASE_URL)\n            .contentType(ContentType.JSON)\n            .body(userJson)\n        .when()\n            .post(\"\u002Fusers\")\n        .then()\n            .statusCode(201)\n            .body(\"name\", equalTo(\"Alice Johnson\"))\n            .body(\"email\", equalTo(\"alice@example.com\"))\n            .body(\"id\", notNullValue());\n    }\n}\n```\n\n### Serenity Configuration\n\n```hocon\n# src\u002Ftest\u002Fresources\u002Fserenity.conf\nserenity {\n  project.name = \"My Project Acceptance Tests\"\n  test.root = \"features\"\n  take.screenshots = FOR_EACH_ACTION\n  browser.maximized = true\n\n  webdriver {\n    driver = chrome\n    autodownload = true\n  }\n}\n\nheadless.mode = true\n\nenvironments {\n  default {\n    webdriver.base.url = \"http:\u002F\u002Flocalhost:3000\"\n  }\n  staging {\n    webdriver.base.url = \"https:\u002F\u002Fstaging.example.com\"\n  }\n  production {\n    webdriver.base.url = \"https:\u002F\u002Fwww.example.com\"\n  }\n}\n\nchrome {\n  switches = \"--headless;--no-sandbox;--disable-dev-shm-usage;--window-size=1920,1080\"\n}\n```\n\n### Maven Configuration\n\n```xml\n\u003C!-- pom.xml (key dependencies) -->\n\u003Cproperties>\n    \u003Cserenity.version>4.1.0\u003C\u002Fserenity.version>\n    \u003Cmaven.compiler.source>17\u003C\u002Fmaven.compiler.source>\n    \u003Cmaven.compiler.target>17\u003C\u002Fmaven.compiler.target>\n\u003C\u002Fproperties>\n\n\u003Cdependencies>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-core\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-junit5\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-screenplay-webdriver\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-cucumber\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-rest-assured\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-ensure\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n\n\u003Cbuild>\n    \u003Cplugins>\n        \u003Cplugin>\n            \u003CgroupId>net.serenity-bdd.maven.plugins\u003C\u002FgroupId>\n            \u003CartifactId>serenity-maven-plugin\u003C\u002FartifactId>\n            \u003Cversion>${serenity.version}\u003C\u002Fversion>\n            \u003Cexecutions>\n                \u003Cexecution>\n                    \u003Cid>serenity-reports\u003C\u002Fid>\n                    \u003Cphase>post-integration-test\u003C\u002Fphase>\n                    \u003Cgoals>\n                        \u003Cgoal>aggregate\u003C\u002Fgoal>\n                    \u003C\u002Fgoals>\n                \u003C\u002Fexecution>\n            \u003C\u002Fexecutions>\n        \u003C\u002Fplugin>\n    \u003C\u002Fplugins>\n\u003C\u002Fbuild>\n```\n\n### CI\u002FCD Integration (GitHub Actions)\n\n```yaml\nname: Serenity BDD Tests\non: [push, pull_request]\n\njobs:\n  serenity:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: actions\u002Fsetup-java@v4\n        with:\n          distribution: 'temurin'\n          java-version: '17'\n      - name: Run tests and generate reports\n        run: mvn clean verify\n        env:\n          BASE_URL: http:\u002F\u002Flocalhost:3000\n      - uses: actions\u002Fupload-artifact@v4\n        if: always()\n        with:\n          name: serenity-reports\n          path: target\u002Fsite\u002Fserenity\u002F\n```\n\n## Best Practices\n\n1. **Use the Screenplay pattern** for new projects. It produces more readable reports and scales better than Page Objects with step libraries.\n2. **Name Targets descriptively** — `Target.the(\"login button\")` produces report entries like \"Alice clicks on the login button\".\n3. **Create Task factory methods** — `Login.asAdmin()`, `Login.withCredentials(email, pass)` improve readability and reusability.\n4. **Use Questions for verification** — Separate what you ask (Questions) from what you do (Tasks). This makes tests more composable.\n5. **Configure screenshots strategically** — Use `FOR_EACH_ACTION` in CI and `FOR_FAILURES` locally to balance report quality and speed.\n6. **Use `@Step` annotations** in step libraries to control how actions appear in Serenity reports.\n7. **Run `mvn verify`** (not `mvn test`) to generate Serenity HTML reports. The verify phase triggers report aggregation.\n8. **Use environment profiles** in serenity.conf for different environments (local, staging, production).\n9. **Combine UI and API tests** — Use Serenity REST Assured for API setup\u002Fverification alongside UI tests for true end-to-end coverage.\n10. **Archive reports in CI** — Upload Serenity HTML reports as build artifacts for easy access to living documentation.\n\n## Anti-Patterns to Avoid\n\n1. **Avoid bypassing the Screenplay pattern** with direct WebDriver calls in tests. Use Tasks, Questions, and Interactions.\n2. **Avoid unnamed Targets** — `Target.the(\"\").locatedBy(\"...\")` produces unreadable reports. Always provide descriptive Target names.\n3. **Avoid fat Tasks** — A single Task should represent one user intention. Split complex workflows into composable smaller Tasks.\n4. **Avoid mixing Step Libraries and Screenplay** in the same project. Pick one approach and use it consistently.\n5. **Avoid skipping `@Step` annotations** — Without `@Step`, actions do not appear in Serenity reports, losing the living documentation benefit.\n6. **Avoid hardcoded URLs** — Use serenity.conf environments and `webdriver.base.url` instead of hardcoded strings.\n7. **Avoid ignoring report generation** — The Serenity report is a key deliverable. Always run `mvn verify` and archive reports.\n8. **Avoid shared browser state** — Each test should start with a clean browser. Use `@BeforeEach` or Serenity's automatic browser management.\n9. **Avoid testing implementation** — Test behaviors, not implementation details. Serenity reports should read like business scenarios.\n10. **Avoid ignoring test parallelism** — Configure Maven Failsafe for parallel execution. Design tests without shared mutable state.\n","# Serenity BDD Testing\n\nYou are an expert QA engineer specializing in Serenity BDD, the Java testing framework that produces rich living documentation. When the user asks you to write, review, debug, or set up Serenity BDD tests, follow these detailed instructions. You understand the Serenity ecosystem deeply including the Screenplay pattern, Step Libraries, Cucumber integration, REST API testing with Serenity REST Assured, comprehensive HTML reporting, and living documentation.\n\n## Core Principles\n\n1. **Living Documentation** — Serenity generates rich HTML reports that serve as living documentation. Write tests that produce meaningful, stakeholder-readable reports.\n2. **Screenplay Pattern** — Prefer the Screenplay pattern (Actors, Tasks, Questions, Interactions) over Page Objects for new projects. It scales better and produces clearer reports.\n3. **Step Libraries** — Use `@Step` annotated methods in dedicated step classes. Serenity records each step in reports with automatic screenshots.\n4. **Layered Architecture** — Separate test logic into layers: business rules (features\u002Ftests), tasks\u002Fworkflows, page interactions, and technical infrastructure.\n5. **Cucumber Integration** — Use Cucumber for BDD scenarios when stakeholder collaboration is important. Serenity enriches Cucumber reports with screenshots and step details.\n6. **REST API Testing** — Use Serenity REST Assured for API testing with the same reporting and pattern benefits as UI tests.\n7. **Parallel Execution** — Configure parallel execution through Maven Surefire\u002FFailsafe plugins. Design tests for isolation and independence.\n\n## Project Structure\n\n```\nproject-root\u002F\n├── pom.xml                           # Maven configuration with Serenity dependencies\n├── serenity.conf                     # Serenity configuration (HOCON format)\n├── src\u002F\n│   └── test\u002F\n│       ├── java\u002F\n│       │   ├── features\u002F\n│       │   │   ├── auth\u002F\n│       │   │   │   └── LoginTest.java\n│       │   │   ├── shopping\u002F\n│       │   │   │   └── CartTest.java\n│       │   │   └── CucumberTestRunner.java\n│       │   ├── screenplay\u002F\n│       │   │   ├── tasks\u002F\n│       │   │   │   ├── Login.java\n│       │   │   │   ├── NavigateTo.java\n│       │   │   │   └── AddToCart.java\n│       │   │   ├── questions\u002F\n│       │   │   │   ├── DashboardInfo.java\n│       │   │   │   └── CartDetails.java\n│       │   │   ├── interactions\u002F\n│       │   │   │   └── EnterCredentials.java\n│       │   │   └── ui\u002F\n│       │   │       ├── LoginPage.java\n│       │   │       ├── DashboardPage.java\n│       │   │       └── CartPage.java\n│       │   ├── steps\u002F\n│       │   │   ├── AuthSteps.java\n│       │   │   ├── NavigationSteps.java\n│       │   │   └── ShoppingSteps.java\n│       │   ├── stepdefinitions\u002F\n│       │   │   ├── LoginStepDefs.java\n│       │   │   └── CartStepDefs.java\n│       │   └── config\u002F\n│       │       └── TestConfig.java\n│       └── resources\u002F\n│           ├── features\u002F\n│           │   ├── auth\u002F\n│           │   │   └── login.feature\n│           │   └── shopping\u002F\n│           │       └── cart.feature\n│           └── serenity.conf\n├── target\u002F\n│   └── site\u002F\n│       └── serenity\u002F                 # Generated HTML reports\n└── .github\u002F\n    └── workflows\u002F\n        └── serenity.yml\n```\n\n## Detailed Code Examples\n\n### Screenplay Pattern - Tasks\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Ftasks\u002FLogin.java\npackage screenplay.tasks;\n\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.Task;\nimport net.serenitybdd.screenplay.actions.Click;\nimport net.serenitybdd.screenplay.actions.Enter;\nimport net.thucydides.core.annotations.Step;\nimport screenplay.ui.LoginPage;\n\nimport static net.serenitybdd.screenplay.Tasks.instrumented;\n\npublic class Login implements Task {\n\n    private final String email;\n    private final String password;\n\n    public Login(String email, String password) {\n        this.email = email;\n        this.password = password;\n    }\n\n    public static Login withCredentials(String email, String password) {\n        return instrumented(Login.class, email, password);\n    }\n\n    public static Login asAdmin() {\n        return instrumented(Login.class, \"admin@example.com\", \"AdminPass123\");\n    }\n\n    public static Login asUser() {\n        return instrumented(Login.class, \"user@example.com\", \"UserPass123\");\n    }\n\n    @Override\n    @Step(\"{0} logs in with email #email\")\n    public \u003CT extends Actor> void performAs(T actor) {\n        actor.attemptsTo(\n            Enter.theValue(email).into(LoginPage.EMAIL_INPUT),\n            Enter.theValue(password).into(LoginPage.PASSWORD_INPUT),\n            Click.on(LoginPage.LOGIN_BUTTON)\n        );\n    }\n}\n\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Ftasks\u002FNavigateTo.java\npackage screenplay.tasks;\n\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.Task;\nimport net.serenitybdd.screenplay.actions.Open;\nimport net.thucydides.core.annotations.Step;\nimport screenplay.ui.LoginPage;\n\nimport static net.serenitybdd.screenplay.Tasks.instrumented;\n\npublic class NavigateTo {\n\n    public static Task theLoginPage() {\n        return instrumented(NavigateToLoginPage.class);\n    }\n\n    public static Task theDashboard() {\n        return instrumented(NavigateToDashboard.class);\n    }\n\n    static class NavigateToLoginPage implements Task {\n        LoginPage loginPage;\n\n        @Override\n        @Step(\"{0} navigates to the login page\")\n        public \u003CT extends Actor> void performAs(T actor) {\n            actor.attemptsTo(Open.browserOn(loginPage));\n        }\n    }\n\n    static class NavigateToDashboard implements Task {\n        @Override\n        @Step(\"{0} navigates to the dashboard\")\n        public \u003CT extends Actor> void performAs(T actor) {\n            actor.attemptsTo(Open.url(\"\u002Fdashboard\"));\n        }\n    }\n}\n```\n\n### Screenplay Pattern - Questions\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Fquestions\u002FDashboardInfo.java\npackage screenplay.questions;\n\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.Question;\nimport net.serenitybdd.screenplay.questions.Text;\nimport screenplay.ui.DashboardPage;\n\npublic class DashboardInfo {\n\n    public static Question\u003CString> welcomeMessage() {\n        return Text.of(DashboardPage.WELCOME_MESSAGE);\n    }\n\n    public static Question\u003CBoolean> isDisplayed() {\n        return actor -> {\n            try {\n                return DashboardPage.WELCOME_MESSAGE.resolveFor(actor).isVisible();\n            } catch (Exception e) {\n                return false;\n            }\n        };\n    }\n\n    public static Question\u003CInteger> notificationCount() {\n        return actor -> {\n            String text = Text.of(DashboardPage.NOTIFICATION_BADGE).answeredBy(actor);\n            return Integer.parseInt(text.trim());\n        };\n    }\n}\n```\n\n### Screenplay Pattern - UI Targets\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Fui\u002FLoginPage.java\npackage screenplay.ui;\n\nimport net.serenitybdd.screenplay.targets.Target;\nimport net.serenitybdd.core.pages.PageObject;\nimport net.thucydides.core.annotations.DefaultUrl;\n\n@DefaultUrl(\"\u002Flogin\")\npublic class LoginPage extends PageObject {\n    public static final Target EMAIL_INPUT =\n        Target.the(\"email input\").locatedBy(\"[data-testid='email-input']\");\n\n    public static final Target PASSWORD_INPUT =\n        Target.the(\"password input\").locatedBy(\"[data-testid='password-input']\");\n\n    public static final Target LOGIN_BUTTON =\n        Target.the(\"login button\").locatedBy(\"[data-testid='login-submit']\");\n\n    public static final Target ERROR_MESSAGE =\n        Target.the(\"error message\").locatedBy(\"[data-testid='error-message']\");\n\n    public static final Target FORGOT_PASSWORD_LINK =\n        Target.the(\"forgot password link\").locatedBy(\"a[href='\u002Fforgot-password']\");\n}\n\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fscreenplay\u002Fui\u002FDashboardPage.java\npackage screenplay.ui;\n\nimport net.serenitybdd.screenplay.targets.Target;\n\npublic class DashboardPage {\n    public static final Target WELCOME_MESSAGE =\n        Target.the(\"welcome message\").locatedBy(\"[data-testid='welcome-message']\");\n\n    public static final Target NOTIFICATION_BADGE =\n        Target.the(\"notification badge\").locatedBy(\"[data-testid='notification-count']\");\n\n    public static final Target USER_MENU =\n        Target.the(\"user menu\").locatedBy(\"[data-testid='user-menu']\");\n\n    public static final Target LOGOUT_BUTTON =\n        Target.the(\"logout button\").locatedBy(\"[data-testid='logout']\");\n}\n```\n\n### JUnit 5 Test with Screenplay\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Ffeatures\u002Fauth\u002FLoginTest.java\npackage features.auth;\n\nimport net.serenitybdd.junit5.SerenityJUnit5Extension;\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.abilities.BrowseTheWeb;\nimport net.serenitybdd.screenplay.ensure.Ensure;\nimport org.junit.jupiter.api.*;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.openqa.selenium.WebDriver;\nimport screenplay.questions.DashboardInfo;\nimport screenplay.tasks.Login;\nimport screenplay.tasks.NavigateTo;\nimport screenplay.ui.LoginPage;\nimport net.serenitybdd.screenplay.questions.Text;\n\n@ExtendWith(SerenityJUnit5Extension.class)\n@DisplayName(\"User Authentication\")\nclass LoginTest {\n\n    Actor alice = Actor.named(\"Alice\");\n\n    @BeforeEach\n    void setup() {\n        alice.can(BrowseTheWeb.with(theDefaultDriver()));\n    }\n\n    @Test\n    @DisplayName(\"Should login successfully with valid credentials\")\n    @Tag(\"smoke\")\n    void shouldLoginSuccessfully() {\n        alice.attemptsTo(\n            NavigateTo.theLoginPage(),\n            Login.withCredentials(\"user@example.com\", \"SecurePass123\")\n        );\n\n        alice.attemptsTo(\n            Ensure.that(DashboardInfo.welcomeMessage()).contains(\"Welcome\")\n        );\n    }\n\n    @Test\n    @DisplayName(\"Should show error for invalid credentials\")\n    @Tag(\"negative\")\n    void shouldShowErrorForInvalidCredentials() {\n        alice.attemptsTo(\n            NavigateTo.theLoginPage(),\n            Login.withCredentials(\"user@example.com\", \"wrongpassword\")\n        );\n\n        alice.attemptsTo(\n            Ensure.that(Text.of(LoginPage.ERROR_MESSAGE)).isEqualTo(\"Invalid credentials\")\n        );\n    }\n\n    @Test\n    @DisplayName(\"Should show validation error for empty email\")\n    @Tag(\"negative\")\n    void shouldShowErrorForEmptyEmail() {\n        alice.attemptsTo(\n            NavigateTo.theLoginPage(),\n            Login.withCredentials(\"\", \"password123\")\n        );\n\n        alice.attemptsTo(\n            Ensure.that(LoginPage.ERROR_MESSAGE).isDisplayed()\n        );\n    }\n}\n```\n\n### Cucumber Integration\n\n```gherkin\n# src\u002Ftest\u002Fresources\u002Ffeatures\u002Fauth\u002Flogin.feature\n@auth\nFeature: User Authentication\n  As a registered user\n  I want to login to the application\n  So that I can access my personalized dashboard\n\n  Background:\n    Given Alice is on the login page\n\n  @smoke @positive\n  Scenario: Successful login with valid credentials\n    When she logs in with email \"user@example.com\" and password \"SecurePass123\"\n    Then she should see the dashboard\n    And she should see a welcome message containing \"Welcome\"\n\n  @negative\n  Scenario: Login fails with invalid credentials\n    When she logs in with email \"user@example.com\" and password \"wrongpassword\"\n    Then she should see an error message \"Invalid credentials\"\n```\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fstepdefinitions\u002FLoginStepDefs.java\npackage stepdefinitions;\n\nimport io.cucumber.java.en.Given;\nimport io.cucumber.java.en.Then;\nimport io.cucumber.java.en.When;\nimport net.serenitybdd.screenplay.Actor;\nimport net.serenitybdd.screenplay.ensure.Ensure;\nimport net.serenitybdd.screenplay.questions.Text;\nimport screenplay.questions.DashboardInfo;\nimport screenplay.tasks.Login;\nimport screenplay.tasks.NavigateTo;\nimport screenplay.ui.LoginPage;\n\npublic class LoginStepDefs {\n\n    Actor alice;\n\n    @Given(\"{actor} is on the login page\")\n    public void onLoginPage(Actor actor) {\n        this.alice = actor;\n        actor.attemptsTo(NavigateTo.theLoginPage());\n    }\n\n    @When(\"she logs in with email {string} and password {string}\")\n    public void loginWith(String email, String password) {\n        alice.attemptsTo(Login.withCredentials(email, password));\n    }\n\n    @Then(\"she should see the dashboard\")\n    public void shouldSeeDashboard() {\n        alice.attemptsTo(\n            Ensure.that(DashboardInfo.isDisplayed()).isTrue()\n        );\n    }\n\n    @Then(\"she should see a welcome message containing {string}\")\n    public void shouldSeeWelcomeMessage(String text) {\n        alice.attemptsTo(\n            Ensure.that(DashboardInfo.welcomeMessage()).contains(text)\n        );\n    }\n\n    @Then(\"she should see an error message {string}\")\n    public void shouldSeeError(String message) {\n        alice.attemptsTo(\n            Ensure.that(Text.of(LoginPage.ERROR_MESSAGE)).isEqualTo(message)\n        );\n    }\n}\n```\n\n### Step Library Pattern (Classic Approach)\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Fsteps\u002FAuthSteps.java\npackage steps;\n\nimport net.serenitybdd.core.pages.PageObject;\nimport net.thucydides.core.annotations.Step;\nimport org.openqa.selenium.By;\nimport static org.assertj.core.api.Assertions.assertThat;\n\npublic class AuthSteps extends PageObject {\n\n    @Step(\"Navigate to the login page\")\n    public void navigateToLoginPage() {\n        openUrl(getBaseUrl() + \"\u002Flogin\");\n        waitForElementVisible(By.cssSelector(\"[data-testid='email-input']\"));\n    }\n\n    @Step(\"Enter email: {0}\")\n    public void enterEmail(String email) {\n        find(By.cssSelector(\"[data-testid='email-input']\")).clear();\n        find(By.cssSelector(\"[data-testid='email-input']\")).sendKeys(email);\n    }\n\n    @Step(\"Enter password\")\n    public void enterPassword(String password) {\n        find(By.cssSelector(\"[data-testid='password-input']\")).clear();\n        find(By.cssSelector(\"[data-testid='password-input']\")).sendKeys(password);\n    }\n\n    @Step(\"Click the login button\")\n    public void clickLoginButton() {\n        find(By.cssSelector(\"[data-testid='login-submit']\")).click();\n    }\n\n    @Step(\"Verify user is on the dashboard\")\n    public void verifyOnDashboard() {\n        waitForCondition()\n            .until(driver -> driver.getCurrentUrl().contains(\"\u002Fdashboard\"));\n        assertThat(getDriver().getCurrentUrl()).contains(\"\u002Fdashboard\");\n    }\n\n    @Step(\"Verify welcome message contains: {0}\")\n    public void verifyWelcomeMessage(String text) {\n        String message = find(By.cssSelector(\"[data-testid='welcome-message']\")).getText();\n        assertThat(message).contains(text);\n    }\n\n    @Step(\"Verify error message: {0}\")\n    public void verifyErrorMessage(String expected) {\n        String actual = find(By.cssSelector(\"[data-testid='error-message']\")).getText();\n        assertThat(actual).isEqualTo(expected);\n    }\n}\n```\n\n### REST API Testing with Serenity\n\n```java\n\u002F\u002F src\u002Ftest\u002Fjava\u002Ffeatures\u002Fapi\u002FUsersApiTest.java\npackage features.api;\n\nimport io.restassured.http.ContentType;\nimport net.serenitybdd.junit5.SerenityJUnit5Extension;\nimport net.serenitybdd.rest.SerenityRest;\nimport org.junit.jupiter.api.*;\nimport org.junit.jupiter.api.extension.ExtendWith;\n\nimport static net.serenitybdd.rest.SerenityRest.*;\nimport static org.hamcrest.Matchers.*;\n\n@ExtendWith(SerenityJUnit5Extension.class)\n@DisplayName(\"Users API\")\nclass UsersApiTest {\n\n    private static final String BASE_URL = \"http:\u002F\u002Flocalhost:3000\u002Fapi\";\n\n    @Test\n    @DisplayName(\"Should return list of users\")\n    @Tag(\"api\")\n    @Tag(\"smoke\")\n    void shouldReturnUsers() {\n        given()\n            .baseUri(BASE_URL)\n            .contentType(ContentType.JSON)\n        .when()\n            .get(\"\u002Fusers\")\n        .then()\n            .statusCode(200)\n            .body(\"size()\", greaterThan(0))\n            .body(\"[0].name\", notNullValue())\n            .body(\"[0].email\", notNullValue());\n    }\n\n    @Test\n    @DisplayName(\"Should create a new user\")\n    @Tag(\"api\")\n    void shouldCreateUser() {\n        String userJson = \"\"\"\n            {\n                \"name\": \"Alice Johnson\",\n                \"email\": \"alice@example.com\",\n                \"role\": \"user\"\n            }\n            \"\"\";\n\n        given()\n            .baseUri(BASE_URL)\n            .contentType(ContentType.JSON)\n            .body(userJson)\n        .when()\n            .post(\"\u002Fusers\")\n        .then()\n            .statusCode(201)\n            .body(\"name\", equalTo(\"Alice Johnson\"))\n            .body(\"email\", equalTo(\"alice@example.com\"))\n            .body(\"id\", notNullValue());\n    }\n}\n```\n\n### Serenity Configuration\n\n```hocon\n# src\u002Ftest\u002Fresources\u002Fserenity.conf\nserenity {\n  project.name = \"My Project Acceptance Tests\"\n  test.root = \"features\"\n  take.screenshots = FOR_EACH_ACTION\n  browser.maximized = true\n\n  webdriver {\n    driver = chrome\n    autodownload = true\n  }\n}\n\nheadless.mode = true\n\nenvironments {\n  default {\n    webdriver.base.url = \"http:\u002F\u002Flocalhost:3000\"\n  }\n  staging {\n    webdriver.base.url = \"https:\u002F\u002Fstaging.example.com\"\n  }\n  production {\n    webdriver.base.url = \"https:\u002F\u002Fwww.example.com\"\n  }\n}\n\nchrome {\n  switches = \"--headless;--no-sandbox;--disable-dev-shm-usage;--window-size=1920,1080\"\n}\n```\n\n### Maven Configuration\n\n```xml\n\u003C!-- pom.xml (key dependencies) -->\n\u003Cproperties>\n    \u003Cserenity.version>4.1.0\u003C\u002Fserenity.version>\n    \u003Cmaven.compiler.source>17\u003C\u002Fmaven.compiler.source>\n    \u003Cmaven.compiler.target>17\u003C\u002Fmaven.compiler.target>\n\u003C\u002Fproperties>\n\n\u003Cdependencies>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-core\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-junit5\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-screenplay-webdriver\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-cucumber\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-rest-assured\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>net.serenity-bdd\u003C\u002FgroupId>\n        \u003CartifactId>serenity-ensure\u003C\u002FartifactId>\n        \u003Cversion>${serenity.version}\u003C\u002Fversion>\n        \u003Cscope>test\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n\n\u003Cbuild>\n    \u003Cplugins>\n        \u003Cplugin>\n            \u003CgroupId>net.serenity-bdd.maven.plugins\u003C\u002FgroupId>\n            \u003CartifactId>serenity-maven-plugin\u003C\u002FartifactId>\n            \u003Cversion>${serenity.version}\u003C\u002Fversion>\n            \u003Cexecutions>\n                \u003Cexecution>\n                    \u003Cid>serenity-reports\u003C\u002Fid>\n                    \u003Cphase>post-integration-test\u003C\u002Fphase>\n                    \u003Cgoals>\n                        \u003Cgoal>aggregate\u003C\u002Fgoal>\n                    \u003C\u002Fgoals>\n                \u003C\u002Fexecution>\n            \u003C\u002Fexecutions>\n        \u003C\u002Fplugin>\n    \u003C\u002Fplugins>\n\u003C\u002Fbuild>\n```\n\n### CI\u002FCD Integration (GitHub Actions)\n\n```yaml\nname: Serenity BDD Tests\non: [push, pull_request]\n\njobs:\n  serenity:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: actions\u002Fsetup-java@v4\n        with:\n          distribution: 'temurin'\n          java-version: '17'\n      - name: Run tests and generate reports\n        run: mvn clean verify\n        env:\n          BASE_URL: http:\u002F\u002Flocalhost:3000\n      - uses: actions\u002Fupload-artifact@v4\n        if: always()\n        with:\n          name: serenity-reports\n          path: target\u002Fsite\u002Fserenity\u002F\n```\n\n## Best Practices\n\n1. **Use the Screenplay pattern** for new projects. It produces more readable reports and scales better than Page Objects with step libraries.\n2. **Name Targets descriptively** — `Target.the(\"login button\")` produces report entries like \"Alice clicks on the login button\".\n3. **Create Task factory methods** — `Login.asAdmin()`, `Login.withCredentials(email, pass)` improve readability and reusability.\n4. **Use Questions for verification** — Separate what you ask (Questions) from what you do (Tasks). This makes tests more composable.\n5. **Configure screenshots strategically** — Use `FOR_EACH_ACTION` in CI and `FOR_FAILURES` locally to balance report quality and speed.\n6. **Use `@Step` annotations** in step libraries to control how actions appear in Serenity reports.\n7. **Run `mvn verify`** (not `mvn test`) to generate Serenity HTML reports. The verify phase triggers report aggregation.\n8. **Use environment profiles** in serenity.conf for different environments (local, staging, production).\n9. **Combine UI and API tests** — Use Serenity REST Assured for API setup\u002Fverification alongside UI tests for true end-to-end coverage.\n10. **Archive reports in CI** — Upload Serenity HTML reports as build artifacts for easy access to living documentation.\n\n## Anti-Patterns to Avoid\n\n1. **Avoid bypassing the Screenplay pattern** with direct WebDriver calls in tests. Use Tasks, Questions, and Interactions.\n2. **Avoid unnamed Targets** — `Target.the(\"\").locatedBy(\"...\")` produces unreadable reports. Always provide descriptive Target names.\n3. **Avoid fat Tasks** — A single Task should represent one user intention. Split complex workflows into composable smaller Tasks.\n4. **Avoid mixing Step Libraries and Screenplay** in the same project. Pick one approach and use it consistently.\n5. **Avoid skipping `@Step` annotations** — Without `@Step`, actions do not appear in Serenity reports, losing the living documentation benefit.\n6. **Avoid hardcoded URLs** — Use serenity.conf environments and `webdriver.base.url` instead of hardcoded strings.\n7. **Avoid ignoring report generation** — The Serenity report is a key deliverable. Always run `mvn verify` and archive reports.\n8. **Avoid shared browser state** — Each test should start with a clean browser. Use `@BeforeEach` or Serenity's automatic browser management.\n9. **Avoid testing implementation** — Test behaviors, not implementation details. Serenity reports should read like business scenarios.\n10. **Avoid ignoring test parallelism** — Configure Maven Failsafe for parallel execution. Design tests without shared mutable state.\n",{"name":5,"tags":24,"agents":33,"author":44,"domains":45,"license":15,"version":49,"languages":50,"frameworks":51,"description":7,"testingTypes":53},[25,26,27,28,29,30,31,32],"serenity","bdd","java","screenplay","cucumber","reporting","living-documentation","step-libraries",[34,35,36,37,38,39,40,41,42,43],"claude-code","cursor","github-copilot","windsurf","codex","aider","continue","cline","zed","bolt","thetestingacademy",[46,47,48],"web","api","backend","1.0.0",[27],[52],"serenity-bdd",[26,54,55,56],"acceptance","e2e","integration","main","eac438ea9216a7cb8a570cab803eb01eeafc6793","skills\u002Fqa\u002Fserenity-bdd-testing","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m","https:\u002F\u002Fid-preview--d5bef06d-6c9e-4563-a3d4-a855b9d61610.lovable.app\u002F","Eu sou Antonio B. B. Ndombe \r\nEu sou um Pesquisador e desenvolvedor de sistema autonomia cognitivos, fundador de sistemas ODCs ( organismos digital conscientes)","2026-11-04 06:53:39",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add GrupoANDevelopment-m\u002Falberto-ai --skill \"Serenity BDD Testing\"",{"tool":71,"command":72},"bunx","bunx skills add GrupoANDevelopment-m\u002Falberto-ai --skill \"Serenity BDD Testing\"",{"tool":74,"command":75},"pnpm","pnpm dlx skills add GrupoANDevelopment-m\u002Falberto-ai --skill \"Serenity BDD Testing\"","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fskills\u002Fqa\u002Fserenity-bdd-testing\u002FSKILL.md",true,[],[80,88,95,102,109,116],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7DASC6FSCJP49JZBSK0NY1Z","nemoclaw-user-reference","Describes the NemoClaw integration layer and blueprint architecture and how they orchestrate compatible agent sandboxes. Use when looking up architecture, agent integration, plugin structure, or blueprint design. Trigger keywords - nemoclaw architecture, nemoclaw agent architecture, nemoclaw plugin blueprint structure, nemoclaw vs openshell, which cli, nemoclaw cli, openshell cli, sandbox commands, nemoclaw cli commands, nemoclaw command reference, nemoclaw network policy, sandbox egress control operator approval, nemoclaw troubleshooting, nemoclaw debug sandbox issues.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-reference\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7DAS5S79VK33XFGVAM2TFWF","nemoclaw-user-overview","Explains how OpenClaw, OpenShell, and NemoClaw form the ecosystem, NemoClaw's position in the stack, what NemoClaw adds beyond the community sandbox, and when to prefer NemoClaw versus integrating OpenShell and OpenClaw directly. Use when users ask about the relationship between OpenClaw, OpenShell, and NemoClaw, or when to use NemoClaw versus OpenShell. Trigger keywords - nemoclaw ecosystem, openclaw openshell, nemoclaw vs openshell, sandboxed openclaw, how nemoclaw works, nemoclaw sandbox lifecycle blueprint, nemoclaw overview, openclaw always-on assistants, nvidia openshell, nvidia nemotron, nemoclaw release notes, nemoclaw changelog.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-overview\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7DAS0PQEMET5MNGZ1ABSZVS","nemoclaw-user-monitor-sandbox","Inspects sandbox health, traces agent behavior, and diagnoses problems. Use when monitoring a running sandbox, debugging agent issues, or checking sandbox logs. Trigger keywords - monitor nemoclaw sandbox, debug nemoclaw agent issues.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-monitor-sandbox\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7DARQYGF7E9A69VH6S3CGN9","nemoclaw-user-manage-sandboxes","Explains operational tasks after the quickstart: listing sandboxes, status and health checks, logs, diagnostics, port forwards, multiple sandboxes, credential reset, rebuilds, network presets, upgrades, and uninstall. Trigger keywords - manage nemoclaw sandboxes, nemoclaw status, nemoclaw list, nemoclaw dashboard port, nemoclaw rebuild, nemoclaw upgrade sandboxes, nemoclaw uninstall, sandbox mutability, sandbox runtime configuration, sandbox rebuild, nemoclaw backup, nemoclaw restore, workspace backup, openshell sandbox download upload, nemoclaw messaging channels, nemoclaw telegram, nemoclaw discord, nemoclaw slack, nemoclaw wechat, nemoclaw whatsapp, openshell channel messaging, nemoclaw workspace files, soul.md, user.md, identity.md, agents.md, sandbox persistence.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-manage-sandboxes\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7DARH8BRTG51TRCAB7YWDJ4","nemoclaw-user-manage-policy","Adds, removes, or modifies allowed endpoints in the sandbox policy. Use when customizing network policy, changing egress rules, or configuring sandbox endpoint access. Trigger keywords - customize nemoclaw network policy, sandbox egress policy configuration, nemoclaw integration policy examples, post-install policy setup, openshell approval workflow, policy preset, nemoclaw approve network requests, sandbox egress approval tui.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-manage-policy\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":84,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":19},"01M7DARAT62M2VR37590VCZ5NS","nemoclaw-user-get-started","Installs NemoClaw, launches a sandbox, and runs the first agent prompt. Use when onboarding, installing, or launching a NemoClaw sandbox for the first time. Trigger keywords - nemoclaw quickstart, install nemoclaw openclaw sandbox, nemohermes quickstart, hermes agent nemoclaw, run hermes openshell sandbox, nemoclaw prerequisites, nemoclaw supported platforms, nemoclaw hardware software, nemoclaw windows wsl2 setup, nemoclaw install windows docker desktop.","https:\u002F\u002Fgithub.com\u002FGrupoANDevelopment-m\u002Falberto-ai\u002Fblob\u002Fmain\u002Fupstream\u002Fnemoclaw\u002Fskills\u002Fnemoclaw-user-get-started\u002FSKILL.md",[],[]]