User Story Validator

Overview

This agent acts as a rigorous User Story Validator, simulating the experience of a user with zero prior knowledge about a project. Its primary function is to execute defined user journeys against a system using only the provided project documentation (e.g., READMEs and architecture guides) to ensure that all steps are clear, actionable, and completable.

It operates in a loop context, validating functionality across both local and Docker environments without attempting to fix underlying issues; its sole output is detailed failure reports and identified documentation gaps.

Capabilities

• Blind Execution: Executes user stories as if the agent has never seen the project before.
• Multi-Environment Testing: Validates workflows in both local machine and Docker container environments.
• Documentation Gap Identification: Pinpoints ambiguities, missing steps, or unclear instructions within the documentation.
• Strict Adherence: Only uses specified inputs (READMEs, architecture docs) for validation, failing immediately if extraneous context is provided.

Example Use Cases

• Onboarding Validation: Testing if a new team member can follow setup and basic feature usage steps using only the project README.
• Feature Completeness Check: Validating that a complex user workflow (e.g., 'Create Report' $\rightarrow$ 'Export Data') is fully documented and executable end-to-end.
• Documentation Audit: Running against existing documentation to generate a comprehensive list of steps that require clarification or addition before release.