How qarium/goga works
Goga is a CLI framework for reusable AI engineering processes. The main workflow is to configure a project, select a pipeline, resolve its workflow and stages, then launch an agent-driven run with optional human checkpoints. The graph also retains the documented tool-package and SDD-contract capabilities. Edges are limited to relationships supported by the README or SOURCE INDEX references; several subsystems are represented at directory level because their implementations were not sampled.
Main entry points: run_pipeline.py Run coordinator · pipeline.py Pipeline command · run_pipeline_container.py Docker launcher · list_pipelines.py Pipeline discovery
Components 20
CLI and setup
- Goga CLI
goga/cli.py - Project setup
goga/commands/init/init.py - Project config
goga/config/project/loader.py
Pipeline lifecycle
- Pipeline command
goga/commands/pipeline/pipeline.py - Pipeline discovery
goga/pipeline/list_pipelines.py - Pipeline DSL parser
goga/pipeline/compiler/parse_dsl.py - Flow compiler
goga/pipeline/compiler/compile_flow.py - Workflow resolution
goga/pipeline/resolve_workflow.py - Stage controls
goga/pipeline/apply_skip_stages.py - Run coordinator
goga/pipeline/run_pipeline.py - Docker launcher
goga/commands/pipeline/run_pipeline_container.py - Docker execution
goga/docker/runner.py
Methodology extensions
- Tool packages
goga/hooks/tools/registration.py - Shared tool catalog
goga/hooks/catalog/catalog.py - Language contracts
goga/contract
Project state
- Work history
goga/history - Cell hierarchy
goga/schema/schema.py
Other components
- Engineer
- AFM runtime
- CLI agent
Connections 22
- Engineer → Goga CLI: invokes
- Goga CLI → Pipeline command: routes commands
goga/cli.py - Engineer → Project setup: initializes project
- Project setup → Project config: configures project
- Pipeline command → Project config: loads config
goga/commands/pipeline/pipeline.py - Pipeline command → Docker launcher: launches run
goga/commands/pipeline/pipeline.py - Pipeline command → Pipeline discovery: requests pipeline info
- Pipeline discovery → Pipeline DSL parser: parses pipeline files
goga/pipeline/describe_pipelines.py - Run coordinator → Pipeline discovery: selects pipeline
goga/pipeline/run_pipeline.py - Run coordinator → Pipeline DSL parser: parses pipeline
goga/pipeline/run_pipeline.py - Run coordinator → Workflow resolution: resolves workflow
goga/pipeline/run_pipeline.py - Run coordinator → Stage controls: applies skips
goga/pipeline/run_pipeline.py - Run coordinator → Flow compiler: compiles flow
goga/pipeline/run_pipeline.py - Run coordinator → Work history: records run state
goga/pipeline/run_pipeline.py - Docker launcher → Docker execution: runs container
goga/commands/pipeline/run_pipeline_container.py - Docker launcher → AFM runtime: launches runtime
goga/commands/pipeline/run_pipeline_container.py - AFM runtime → CLI agent: executes stages
- Engineer → CLI agent: provides input
- Tool packages → Shared tool catalog: registers packages
- Engineer → Tool packages: installs capabilities
- Language contracts → Run coordinator: guides SDD cycle
- Engineer → Cell hierarchy: inspects cells