Agentic Learnings

Workflow engine with:

• Go backend (Connect + gRPC APIs)
• Proto-first contracts (buf)
• Next.js UI (ui/)
• Textpb registries for workflow/action/type definitions

Prerequisites

• Go 1.24+
• Node.js 22+ and npm
• Docker (optional, for local Postgres)

Quick Start

make deps
make ui-install
make hooks-install
make build
make ui-dev

Run backend only:

make run

Run backend + UI together:

make dev

Quality Gates

One-time hook setup:

make hooks-install

Pre-commit checks:

• Go: goimports on staged .go files
• UI: ESLint autofix + Prettier on staged files
• Protos: buf format -w + buf lint when proto files change

Run full local checks:

make check

Proto Workflow

Generate code:

make proto

Validation-only checks:

make proto-format
make proto-lint

Local Database (Optional)

Start Postgres:

docker compose up -d postgres

Default DB URL:

postgres://agentic:agentic@127.0.0.1:5432/agentic?sslmode=disable

Relevant env vars:

• ENGINE_DATABASE_URL
• ENGINE_STORE_BACKEND (postgres or inmem)
• ENGINE_TYPES_DIR
• ENGINE_ACTIONS_DIR
• ENGINE_WORKFLOWS_DIR

Repo Layout

• cmd/server: backend entrypoint
• pkg/: engine/runtime modules
• proto/: protobuf API definitions
• gen/: generated Go code
• registry/: curated textpb registries
• examples/: demo textpb definitions
• ui/: Next.js app
• .github/workflows/: CI/health workflows