ProductBuilder Webapp

ProductBuilder is a Symfony web application for AI-assisted product delivery with GitHub as the operator interface. It coordinates planning and implementation agents against GitHub issues and pull requests, and executes work inside persistent local workspaces.

It is a DX·Tooling project, sponsored by

What this repository contains

• A Symfony 7.4 backend that coordinates issue-driven planning and implementation workflows
• A Stimulus + TypeScript frontend for app UI and interactions
• Persistent workspace orchestration for agent execution against product repositories
• A vertical architecture with strict boundaries between features

Tech stack

• PHP 8.4, Symfony 7.4, Doctrine ORM
• MariaDB 12
• TypeScript, Stimulus, Tailwind CSS, AssetMapper
• Docker + Docker Compose
• Mise for tool and task orchestration

Architecture overview

The codebase is organized into verticals under src/. Each vertical has its own layers (Domain, Facade, Infrastructure, Api, Presentation). Cross-vertical communication goes through Facades and DTOs.

For details, see:

• docs/archbook.md
• src/Workflow/docs/workflow.md
• docs/frontendbook.md

Getting started (local development)

Prerequisites

• Docker Desktop
• Mise (https://mise.jdx.dev)
• an unixoid system like Linux, macOS, or Windows Subsystem for Linux

Setup

# 1) Trust mise in this repo
mise trust

# 2) Bootstrap local environment
mise run setup

mise run setup installs dependencies, starts containers, prepares the database, builds frontend assets, runs checks/tests, and opens the app.

Common development tasks

All commands should be run via mise run so they execute in the expected containerized environment.

• Quality checks: mise run quality
• PHP tests: mise run tests
• Frontend tests (Vitest): mise run tests:frontend
• Build frontend assets: mise run frontend
• Symfony console: mise run console <command>
• Database shell: mise run db

Product config bootstrap

You can create/update a ProductConfig from YAML:

mise run console app:product-config:domain:create-product-config product-config.sample.yaml

product-config.sample.yaml is an example template and must be adapted with your own credentials.

Hosting and deployment

This repository is intentionally focused on application code and local development. Company-specific deployment and rollout automation lives in a dedicated hosting repository.

Additional docs

• docs/archbook.md — architecture and boundaries
• docs/devbook.md — recurring dev tasks
• docs/setupbook.md — setup guide
• docs/frontendbook.md — frontend conventions
• docs/runbook.md — runtime/operations notes