Project Structure

Project Structure

Where code and artifacts live. From the README.

├── orchestrator/       # LangGraph pipeline, CLI, webhook, dashboard
│   └── nodes/          # One node per pipeline stage
├── agents/
│   ├── common/         # Pydantic models + LLM factory
│   ├── parser/         # Requirement parsing (LLM + rules)
│   ├── generator/      # Playwright generation + quality gate
│   ├── execution/      # Playwright bridge + artifacts
│   ├── discover/       # Coverage from code/docs + live crawl
│   ├── coverage/       # Gap analysis + V8 aggregation
│   ├── regression/     # Screenshot diff (Pillow / Rust)
│   ├── api_validation/ # HTTP status checks
│   ├── logs/           # Console/network log analysis
│   ├── analyzer/       # LLM failure analysis
│   ├── autofix/        # Selector repair + apply
│   ├── nl_create/      # Natural-language tests
│   └── reporter/       # HTML/PDF + notify channels
├── github_integration/ # API client, workflows
├── playwright/         # Config, fixtures, crawl, PDF scripts
├── prompts/            # LLM system prompts
├── templates/          # Jinja fallback tests + HTML report + CI starters
├── tests/manual/       # Hand-written smoke / visual tests
├── tests/generated/    # Ephemeral generated specs
├── tests/fixtures/     # Fetched specs, requirements.json
├── knowledge/ · knowledge_docs/  # Ask Zyvor RAG content
├── rust/               # zyvor-diff binary
├── kubernetes/            # Cluster manifests
├── docker/             # Container build
├── reports/            # HTML/PDF/summary.json outputs
├── screenshots/        # baselines / current / diffs
└── action.yml          # Reusable GitHub Action

What you usually touch

Goal	Path
Hand-owned tests	tests/manual/
Specs for generate	prompts/examples/, product docs/specs/
CI templates	templates/ci/
Env template	.env.example, .env.knowledge.example
Customer manuals	docs/customer/

Related: Architecture · CLI Commands · Contributing