How ashokmanohar-ai/agentic-quality-engineering-platform works
This is a human-governed agentic quality-engineering platform. Users authenticate, submit requirements, and start a persisted workflow that analyzes requirements and risk, designs and checks tests, selects regression scope, generates and validates automation, pauses for hash-bound approval, executes Playwright tests, triages failures, and produces a release recommendation. The graph follows documented stage order; sampled orchestration code confirms key calls, checkpoints, and execution behavior. Some subsystem relationships are based on README documentation or SOURCE INDEX references rather than fully sampled implementations.
Main entry points: graph.py Workflow engine · main.py FastAPI routes · workflows.py Workflow endpoints · repositories.py Repositories
Components 29
API and governance
- FastAPI routes
app/main.py - Token route
app/api/auth.py - JWT identity
app/governance/auth.py - Role permissions
app/governance/permissions.py - Workflow endpoints
app/api/workflows.py - Approval endpoints
app/api/approvals.py - Human approval
app/governance/approval.py
Quality workflow
- Workflow engine
app/orchestration/graph.py - Workflow state
app/orchestration/state.py - Requirement analysis
app/agents/requirement_analyst.py - Risk analysis
app/agents/risk_analyst.py - Test design
app/agents - Coverage review
app/agents/coverage_reviewer.py - Regression selection
app/agents/regression_selector.py - Automation generation
app/agents/automation_generator.py - Execution agent
app/agents/execution_agent.py - Failure triage
app/agents/failure_triage.py - Quality review
app/agents/quality_reviewer.py
Models and integrations
- Automation validation
app/tools/automation_tool.py - Playwright runner
app/tools/playwright_tool.py - Knowledge retrieval
app/knowledge - Model providers
app/llm/provider.py - Domain models
app/models/domain.py - Evaluation controls
app/evaluation/deterministic.py
Persistence and evidence
- Service container
app/dependencies.py - Repositories
app/persistence/repositories.py - SQLite store
app/persistence/database.py - Tracing
app/observability/tracing.py
Other components
- QE user
Connections 31
- QE user → FastAPI routes: uses
app/main.py - FastAPI routes → Token route: routes to
app/main.py - Token route → JWT identity: creates token
app/api/auth.py - Workflow endpoints → JWT identity: authenticates
app/api/workflows.py - Workflow endpoints → Role permissions: authorizes
app/api/workflows.py - FastAPI routes → Workflow endpoints: routes to
app/main.py - FastAPI routes → Approval endpoints: routes to
app/main.py - Workflow endpoints → Workflow engine: starts
app/api/workflows.py - Approval endpoints → Workflow engine: resumes
app/api/approvals.py - Workflow engine → Requirement analysis: invokes
app/orchestration/graph.py - Workflow engine → Risk analysis: invokes
app/orchestration/graph.py - Workflow engine → Test design: invokes
README.md - Workflow engine → Coverage review: invokes
app/orchestration/graph.py - Workflow engine → Regression selection: invokes
app/orchestration/graph.py - Workflow engine → Automation generation: invokes
README.md - Workflow engine → Automation validation: validates
app/orchestration/graph.py - Workflow engine → Human approval: waits for
README.md - Workflow engine → Execution agent: invokes
app/orchestration/graph.py - Execution agent → Playwright runner: runs tests
app/agents/execution_agent.py - Workflow engine → Failure triage: invokes
app/orchestration/graph.py - Workflow engine → Quality review: invokes
app/orchestration/graph.py - Workflow engine → Workflow state: updates
app/orchestration/graph.py - Workflow engine → Repositories: checkpoints
app/orchestration/graph.py - Service container → Workflow engine: constructs
app/dependencies.py - Service container → Repositories: constructs
app/dependencies.py - Repositories → SQLite store: queries
app/persistence/repositories.py - Workflow engine → Model providers: uses
app/orchestration/graph.py - Workflow engine → Knowledge retrieval: retrieves evidence
README.md - Workflow engine → Evaluation controls: evaluates
README.md - Workflow engine → Domain models: exchanges typed data
- FastAPI routes → Tracing: configures
app/main.py