Skip to content

docs(main): add GOWORK=off prefix to build/test/lint commands#728

Merged
intel352 merged 1 commit into
mainfrom
docs/gowork-main-1779222212
May 19, 2026
Merged

docs(main): add GOWORK=off prefix to build/test/lint commands#728
intel352 merged 1 commit into
mainfrom
docs/gowork-main-1779222212

Conversation

@intel352
Copy link
Copy Markdown
Contributor

Workflow main repo CLAUDE.md + CONTRIBUTING.md now document the GOWORK=off pattern for multi-repo contributors. Sibling to workflow#721.

External contributors with a multi-repo GoCodeAlone workspace hit
inconsistent build failures unless GOWORK=off is set. The plugin
CONTRIBUTING templates were updated in workflow#721 + 12 plugin PRs;
this PR brings the workflow main repo's own CLAUDE.md + CONTRIBUTING.md
into line.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 19, 2026 20:24
@intel352 intel352 merged commit d8d436f into main May 19, 2026
14 checks passed
@intel352 intel352 deleted the docs/gowork-main-1779222212 branch May 19, 2026 20:24
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates contributor-facing documentation to recommend GOWORK=off when working inside a parent go.work multi-repo workspace, ensuring commands run against this repository’s own go.mod (aligning with the established pattern used elsewhere in the repo/docs).

Changes:

  • Documented when/why to use GOWORK=off for multi-repo workspace contributors.
  • Updated build/test/lint example commands to include GOWORK=off where applicable.
  • Added a brief clarification that GOWORK=off is harmless when working standalone.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
CONTRIBUTING.md Adds GOWORK=off guidance and updates example commands for building/testing/linting.
CLAUDE.md Adds GOWORK=off guidance for common tasks and updates example commands accordingly.

Comment thread CONTRIBUTING.md
```bash
# Go checks
# Go checks (prefix with GOWORK=off if you have a parent go.work file)
go fmt ./...
Comment thread CLAUDE.md
cd ui && npm install && npm run dev

# Lint
go fmt ./...
@codecov
Copy link
Copy Markdown

codecov Bot commented May 19, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions
Copy link
Copy Markdown

⏱ Benchmark Results

No significant performance regressions detected.

benchstat comparison (baseline → PR)
## benchstat: baseline → PR
baseline-bench.txt:274: parsing iteration count: invalid syntax
baseline-bench.txt:366860: parsing iteration count: invalid syntax
baseline-bench.txt:680019: parsing iteration count: invalid syntax
baseline-bench.txt:983767: parsing iteration count: invalid syntax
baseline-bench.txt:1311113: parsing iteration count: invalid syntax
baseline-bench.txt:1617906: parsing iteration count: invalid syntax
benchmark-results.txt:274: parsing iteration count: invalid syntax
benchmark-results.txt:318293: parsing iteration count: invalid syntax
benchmark-results.txt:827964: parsing iteration count: invalid syntax
benchmark-results.txt:1165465: parsing iteration count: invalid syntax
benchmark-results.txt:1488383: parsing iteration count: invalid syntax
benchmark-results.txt:1814727: parsing iteration count: invalid syntax
goos: linux
goarch: amd64
pkg: github.com/GoCodeAlone/workflow/dynamic
cpu: AMD EPYC 7763 64-Core Processor                
                            │ baseline-bench.txt │
                            │       sec/op       │
InterpreterCreation-4               8.048m ± 62%
ComponentLoad-4                     3.555m ±  4%
ComponentExecute-4                  1.916µ ±  1%
PoolContention/workers-1-4          1.089µ ±  2%
PoolContention/workers-2-4          1.077µ ±  1%
PoolContention/workers-4-4          1.074µ ±  0%
PoolContention/workers-8-4          1.087µ ±  1%
PoolContention/workers-16-4         1.082µ ±  1%
ComponentLifecycle-4                3.539m ±  0%
SourceValidation-4                  2.277µ ±  1%
RegistryConcurrent-4                777.6n ±  2%
LoaderLoadFromString-4              3.549m ±  1%
geomean                             18.68µ

                            │ baseline-bench.txt │
                            │        B/op        │
InterpreterCreation-4               2.027Mi ± 0%
ComponentLoad-4                     2.180Mi ± 0%
ComponentExecute-4                  1.203Ki ± 0%
PoolContention/workers-1-4          1.203Ki ± 0%
PoolContention/workers-2-4          1.203Ki ± 0%
PoolContention/workers-4-4          1.203Ki ± 0%
PoolContention/workers-8-4          1.203Ki ± 0%
PoolContention/workers-16-4         1.203Ki ± 0%
ComponentLifecycle-4                2.183Mi ± 0%
SourceValidation-4                  1.984Ki ± 0%
RegistryConcurrent-4                1.133Ki ± 0%
LoaderLoadFromString-4              2.182Mi ± 0%
geomean                             15.25Ki

                            │ baseline-bench.txt │
                            │     allocs/op      │
InterpreterCreation-4                15.68k ± 0%
ComponentLoad-4                      18.02k ± 0%
ComponentExecute-4                    25.00 ± 0%
PoolContention/workers-1-4            25.00 ± 0%
PoolContention/workers-2-4            25.00 ± 0%
PoolContention/workers-4-4            25.00 ± 0%
PoolContention/workers-8-4            25.00 ± 0%
PoolContention/workers-16-4           25.00 ± 0%
ComponentLifecycle-4                 18.07k ± 0%
SourceValidation-4                    32.00 ± 0%
RegistryConcurrent-4                  2.000 ± 0%
LoaderLoadFromString-4               18.06k ± 0%
geomean                               183.3

cpu: AMD EPYC 9V74 80-Core Processor                
                            │ benchmark-results.txt │
                            │        sec/op         │
InterpreterCreation-4                  7.250m ± 64%
ComponentLoad-4                        3.477m ±  9%
ComponentExecute-4                     1.817µ ±  1%
PoolContention/workers-1-4             1.007µ ±  2%
PoolContention/workers-2-4             1.008µ ±  1%
PoolContention/workers-4-4             1.008µ ±  1%
PoolContention/workers-8-4             1.010µ ±  2%
PoolContention/workers-16-4            1.011µ ±  2%
ComponentLifecycle-4                   3.562m ±  1%
SourceValidation-4                     2.205µ ±  0%
RegistryConcurrent-4                   750.0n ±  4%
LoaderLoadFromString-4                 3.577m ±  1%
geomean                                17.79µ

                            │ benchmark-results.txt │
                            │         B/op          │
InterpreterCreation-4                  2.027Mi ± 0%
ComponentLoad-4                        2.180Mi ± 0%
ComponentExecute-4                     1.203Ki ± 0%
PoolContention/workers-1-4             1.203Ki ± 0%
PoolContention/workers-2-4             1.203Ki ± 0%
PoolContention/workers-4-4             1.203Ki ± 0%
PoolContention/workers-8-4             1.203Ki ± 0%
PoolContention/workers-16-4            1.203Ki ± 0%
ComponentLifecycle-4                   2.183Mi ± 0%
SourceValidation-4                     1.984Ki ± 0%
RegistryConcurrent-4                   1.133Ki ± 0%
LoaderLoadFromString-4                 2.182Mi ± 0%
geomean                                15.25Ki

                            │ benchmark-results.txt │
                            │       allocs/op       │
InterpreterCreation-4                   15.68k ± 0%
ComponentLoad-4                         18.02k ± 0%
ComponentExecute-4                       25.00 ± 0%
PoolContention/workers-1-4               25.00 ± 0%
PoolContention/workers-2-4               25.00 ± 0%
PoolContention/workers-4-4               25.00 ± 0%
PoolContention/workers-8-4               25.00 ± 0%
PoolContention/workers-16-4              25.00 ± 0%
ComponentLifecycle-4                    18.07k ± 0%
SourceValidation-4                       32.00 ± 0%
RegistryConcurrent-4                     2.000 ± 0%
LoaderLoadFromString-4                  18.06k ± 0%
geomean                                  183.3

pkg: github.com/GoCodeAlone/workflow/middleware
cpu: AMD EPYC 7763 64-Core Processor                
                                  │ baseline-bench.txt │
                                  │       sec/op       │
CircuitBreakerDetection-4                  288.1n ± 3%
CircuitBreakerExecution_Success-4          21.50n ± 0%
CircuitBreakerExecution_Failure-4          66.35n ± 0%
geomean                                    74.34n

                                  │ baseline-bench.txt │
                                  │        B/op        │
CircuitBreakerDetection-4                 144.0 ± 0%
CircuitBreakerExecution_Success-4         0.000 ± 0%
CircuitBreakerExecution_Failure-4         0.000 ± 0%
geomean                                              ¹
¹ summaries must be >0 to compute geomean

                                  │ baseline-bench.txt │
                                  │     allocs/op      │
CircuitBreakerDetection-4                 1.000 ± 0%
CircuitBreakerExecution_Success-4         0.000 ± 0%
CircuitBreakerExecution_Failure-4         0.000 ± 0%
geomean                                              ¹
¹ summaries must be >0 to compute geomean

cpu: AMD EPYC 9V74 80-Core Processor                
                                  │ benchmark-results.txt │
                                  │        sec/op         │
CircuitBreakerDetection-4                     296.6n ± 3%
CircuitBreakerExecution_Success-4             22.65n ± 0%
CircuitBreakerExecution_Failure-4             70.93n ± 0%
geomean                                       78.11n

                                  │ benchmark-results.txt │
                                  │         B/op          │
CircuitBreakerDetection-4                    144.0 ± 0%
CircuitBreakerExecution_Success-4            0.000 ± 0%
CircuitBreakerExecution_Failure-4            0.000 ± 0%
geomean                                                 ¹
¹ summaries must be >0 to compute geomean

                                  │ benchmark-results.txt │
                                  │       allocs/op       │
CircuitBreakerDetection-4                    1.000 ± 0%
CircuitBreakerExecution_Success-4            0.000 ± 0%
CircuitBreakerExecution_Failure-4            0.000 ± 0%
geomean                                                 ¹
¹ summaries must be >0 to compute geomean

pkg: github.com/GoCodeAlone/workflow/module
cpu: AMD EPYC 7763 64-Core Processor                
                                 │ baseline-bench.txt │
                                 │       sec/op       │
IaCStateBackend_InProcess-4              306.0n ±  2%
IaCStateBackend_GRPC-4                   9.642m ± 15%
JQTransform_Simple-4                     680.5n ± 30%
JQTransform_ObjectConstruction-4         1.490µ ±  2%
JQTransform_ArraySelect-4                3.445µ ±  1%
JQTransform_Complex-4                    39.33µ ±  1%
JQTransform_Throughput-4                 1.818µ ±  1%
SSEPublishDelivery-4                     64.12n ±  1%
geomean                                  3.840µ

                                 │ baseline-bench.txt │
                                 │        B/op        │
IaCStateBackend_InProcess-4             416.0 ±  0%
IaCStateBackend_GRPC-4                5.883Mi ± 12%
JQTransform_Simple-4                  1.273Ki ±  0%
JQTransform_ObjectConstruction-4      1.773Ki ±  0%
JQTransform_ArraySelect-4             2.625Ki ±  0%
JQTransform_Complex-4                 16.22Ki ±  0%
JQTransform_Throughput-4              1.984Ki ±  0%
SSEPublishDelivery-4                    0.000 ±  0%
geomean                                             ¹
¹ summaries must be >0 to compute geomean

                                 │ baseline-bench.txt │
                                 │     allocs/op      │
IaCStateBackend_InProcess-4              2.000 ± 0%
IaCStateBackend_GRPC-4                  6.835k ± 0%
JQTransform_Simple-4                     10.00 ± 0%
JQTransform_ObjectConstruction-4         15.00 ± 0%
JQTransform_ArraySelect-4                30.00 ± 0%
JQTransform_Complex-4                    324.0 ± 0%
JQTransform_Throughput-4                 17.00 ± 0%
SSEPublishDelivery-4                     0.000 ± 0%
geomean                                             ¹
¹ summaries must be >0 to compute geomean

cpu: AMD EPYC 9V74 80-Core Processor                
                                 │ benchmark-results.txt │
                                 │        sec/op         │
IaCStateBackend_InProcess-4                 295.7n ±  2%
IaCStateBackend_GRPC-4                      10.20m ± 14%
JQTransform_Simple-4                        630.1n ± 35%
JQTransform_ObjectConstruction-4            1.429µ ±  1%
JQTransform_ArraySelect-4                   3.467µ ±  0%
JQTransform_Complex-4                       42.50µ ±  1%
JQTransform_Throughput-4                    1.768µ ±  0%
SSEPublishDelivery-4                        63.72n ±  1%
geomean                                     3.817µ

                                 │ benchmark-results.txt │
                                 │         B/op          │
IaCStateBackend_InProcess-4                416.0 ±  0%
IaCStateBackend_GRPC-4                   5.773Mi ± 13%
JQTransform_Simple-4                     1.273Ki ±  0%
JQTransform_ObjectConstruction-4         1.773Ki ±  0%
JQTransform_ArraySelect-4                2.625Ki ±  0%
JQTransform_Complex-4                    16.22Ki ±  0%
JQTransform_Throughput-4                 1.984Ki ±  0%
SSEPublishDelivery-4                       0.000 ±  0%
geomean                                                ¹
¹ summaries must be >0 to compute geomean

                                 │ benchmark-results.txt │
                                 │       allocs/op       │
IaCStateBackend_InProcess-4                 2.000 ± 0%
IaCStateBackend_GRPC-4                     6.867k ± 0%
JQTransform_Simple-4                        10.00 ± 0%
JQTransform_ObjectConstruction-4            15.00 ± 0%
JQTransform_ArraySelect-4                   30.00 ± 0%
JQTransform_Complex-4                       324.0 ± 0%
JQTransform_Throughput-4                    17.00 ± 0%
SSEPublishDelivery-4                        0.000 ± 0%
geomean                                                ¹
¹ summaries must be >0 to compute geomean

pkg: github.com/GoCodeAlone/workflow/schema
cpu: AMD EPYC 7763 64-Core Processor                
                                    │ baseline-bench.txt │
                                    │       sec/op       │
SchemaValidation_Simple-4                    1.103µ ± 4%
SchemaValidation_AllFields-4                 1.680µ ± 4%
SchemaValidation_FormatValidation-4          1.573µ ± 2%
SchemaValidation_ManySchemas-4               1.810µ ± 3%
geomean                                      1.516µ

                                    │ baseline-bench.txt │
                                    │        B/op        │
SchemaValidation_Simple-4                   0.000 ± 0%
SchemaValidation_AllFields-4                0.000 ± 0%
SchemaValidation_FormatValidation-4         0.000 ± 0%
SchemaValidation_ManySchemas-4              0.000 ± 0%
geomean                                                ¹
¹ summaries must be >0 to compute geomean

                                    │ baseline-bench.txt │
                                    │     allocs/op      │
SchemaValidation_Simple-4                   0.000 ± 0%
SchemaValidation_AllFields-4                0.000 ± 0%
SchemaValidation_FormatValidation-4         0.000 ± 0%
SchemaValidation_ManySchemas-4              0.000 ± 0%
geomean                                                ¹
¹ summaries must be >0 to compute geomean

cpu: AMD EPYC 9V74 80-Core Processor                
                                    │ benchmark-results.txt │
                                    │        sec/op         │
SchemaValidation_Simple-4                      1.093µ ± 17%
SchemaValidation_AllFields-4                   1.625µ ±  2%
SchemaValidation_FormatValidation-4            1.570µ ±  2%
SchemaValidation_ManySchemas-4                 1.584µ ±  1%
geomean                                        1.449µ

                                    │ benchmark-results.txt │
                                    │         B/op          │
SchemaValidation_Simple-4                      0.000 ± 0%
SchemaValidation_AllFields-4                   0.000 ± 0%
SchemaValidation_FormatValidation-4            0.000 ± 0%
SchemaValidation_ManySchemas-4                 0.000 ± 0%
geomean                                                   ¹
¹ summaries must be >0 to compute geomean

                                    │ benchmark-results.txt │
                                    │       allocs/op       │
SchemaValidation_Simple-4                      0.000 ± 0%
SchemaValidation_AllFields-4                   0.000 ± 0%
SchemaValidation_FormatValidation-4            0.000 ± 0%
SchemaValidation_ManySchemas-4                 0.000 ± 0%
geomean                                                   ¹
¹ summaries must be >0 to compute geomean

pkg: github.com/GoCodeAlone/workflow/store
cpu: AMD EPYC 7763 64-Core Processor                
                                   │ baseline-bench.txt │
                                   │       sec/op       │
EventStoreAppend_InMemory-4                1.235µ ± 16%
EventStoreAppend_SQLite-4                  1.361m ±  4%
GetTimeline_InMemory/events-10-4           13.24µ ±  4%
GetTimeline_InMemory/events-50-4           73.64µ ± 13%
GetTimeline_InMemory/events-100-4          121.8µ ±  1%
GetTimeline_InMemory/events-500-4          626.7µ ±  1%
GetTimeline_InMemory/events-1000-4         1.277m ±  1%
GetTimeline_SQLite/events-10-4             105.0µ ±  0%
GetTimeline_SQLite/events-50-4             244.9µ ±  1%
GetTimeline_SQLite/events-100-4            413.3µ ±  0%
GetTimeline_SQLite/events-500-4            1.768m ±  0%
GetTimeline_SQLite/events-1000-4           3.458m ±  1%
geomean                                    216.1µ

                                   │ baseline-bench.txt │
                                   │        B/op        │
EventStoreAppend_InMemory-4                  810.0 ± 9%
EventStoreAppend_SQLite-4                  1.986Ki ± 1%
GetTimeline_InMemory/events-10-4           7.953Ki ± 0%
GetTimeline_InMemory/events-50-4           46.62Ki ± 0%
GetTimeline_InMemory/events-100-4          94.48Ki ± 0%
GetTimeline_InMemory/events-500-4          472.8Ki ± 0%
GetTimeline_InMemory/events-1000-4         944.3Ki ± 0%
GetTimeline_SQLite/events-10-4             16.74Ki ± 0%
GetTimeline_SQLite/events-50-4             87.14Ki ± 0%
GetTimeline_SQLite/events-100-4            175.4Ki ± 0%
GetTimeline_SQLite/events-500-4            846.1Ki ± 0%
GetTimeline_SQLite/events-1000-4           1.639Mi ± 0%
geomean                                    67.49Ki

                                   │ baseline-bench.txt │
                                   │     allocs/op      │
EventStoreAppend_InMemory-4                  7.000 ± 0%
EventStoreAppend_SQLite-4                    53.00 ± 0%
GetTimeline_InMemory/events-10-4             125.0 ± 0%
GetTimeline_InMemory/events-50-4             653.0 ± 0%
GetTimeline_InMemory/events-100-4           1.306k ± 0%
GetTimeline_InMemory/events-500-4           6.514k ± 0%
GetTimeline_InMemory/events-1000-4          13.02k ± 0%
GetTimeline_SQLite/events-10-4               382.0 ± 0%
GetTimeline_SQLite/events-50-4              1.852k ± 0%
GetTimeline_SQLite/events-100-4             3.681k ± 0%
GetTimeline_SQLite/events-500-4             18.54k ± 0%
GetTimeline_SQLite/events-1000-4            37.29k ± 0%
geomean                                     1.162k

cpu: AMD EPYC 9V74 80-Core Processor                
                                   │ benchmark-results.txt │
                                   │        sec/op         │
EventStoreAppend_InMemory-4                   1.213µ ± 21%
EventStoreAppend_SQLite-4                     1.046m ±  2%
GetTimeline_InMemory/events-10-4              12.37µ ±  3%
GetTimeline_InMemory/events-50-4              69.56µ ±  3%
GetTimeline_InMemory/events-100-4             137.7µ ± 21%
GetTimeline_InMemory/events-500-4             561.6µ ±  0%
GetTimeline_InMemory/events-1000-4            1.140m ±  0%
GetTimeline_SQLite/events-10-4                83.72µ ±  3%
GetTimeline_SQLite/events-50-4                220.3µ ±  1%
GetTimeline_SQLite/events-100-4               386.1µ ±  1%
GetTimeline_SQLite/events-500-4               1.682m ±  0%
GetTimeline_SQLite/events-1000-4              3.269m ±  0%
geomean                                       198.6µ

                                   │ benchmark-results.txt │
                                   │         B/op          │
EventStoreAppend_InMemory-4                     816.0 ± 9%
EventStoreAppend_SQLite-4                     1.987Ki ± 1%
GetTimeline_InMemory/events-10-4              7.953Ki ± 0%
GetTimeline_InMemory/events-50-4              46.62Ki ± 0%
GetTimeline_InMemory/events-100-4             94.48Ki ± 0%
GetTimeline_InMemory/events-500-4             472.8Ki ± 0%
GetTimeline_InMemory/events-1000-4            944.3Ki ± 0%
GetTimeline_SQLite/events-10-4                16.74Ki ± 0%
GetTimeline_SQLite/events-50-4                87.14Ki ± 0%
GetTimeline_SQLite/events-100-4               175.4Ki ± 0%
GetTimeline_SQLite/events-500-4               846.1Ki ± 0%
GetTimeline_SQLite/events-1000-4              1.639Mi ± 0%
geomean                                       67.53Ki

                                   │ benchmark-results.txt │
                                   │       allocs/op       │
EventStoreAppend_InMemory-4                     7.000 ± 0%
EventStoreAppend_SQLite-4                       53.00 ± 0%
GetTimeline_InMemory/events-10-4                125.0 ± 0%
GetTimeline_InMemory/events-50-4                653.0 ± 0%
GetTimeline_InMemory/events-100-4              1.306k ± 0%
GetTimeline_InMemory/events-500-4              6.514k ± 0%
GetTimeline_InMemory/events-1000-4             13.02k ± 0%
GetTimeline_SQLite/events-10-4                  382.0 ± 0%
GetTimeline_SQLite/events-50-4                 1.852k ± 0%
GetTimeline_SQLite/events-100-4                3.681k ± 0%
GetTimeline_SQLite/events-500-4                18.54k ± 0%
GetTimeline_SQLite/events-1000-4               37.29k ± 0%
geomean                                        1.162k

Benchmarks run with go test -bench=. -benchmem -count=6.
Regressions ≥ 20% are flagged. Results compared via benchstat.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants