docs: workflow main README polish + examples index + plugin templates#714
Merged
Conversation
Authors design plan for cross-org documentation/license/experimental-marker sweep across workflow + workflow-registry + ~50 public plugin repos. Adds ADR-0041 recording the rationale for an "experimental" status field on unverified plugins (43 of 50 public plugins lack any active GoCodeAlone project usage; we need a trust signal at install time without taking working code offline). Companion files: - docs/plans/2026-05-19-multi-repo-qol-sweep-design.md - decisions/0041-multi-repo-qol-sweep-experimental-marker.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Incorporates findings from adversarial-design-review: - C-1: schema update needs Go struct sibling + ajv strict-mode fix - C-2: corrects filename plugin.json → manifest.json everywhere - I-1: --skip-unknown-types flag mandated for plugin examples - I-2: re-samples all workspace wfctl.yaml; adds analytics to verified set - I-3: doc-only PRs skip golangci-lint; pre-existing failures filed - I-4: per-priority review tiers; Copilot pass required for P0/P1 - m-1..m-4 dispositions recorded Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- C-2 regression: ADR 0041 manifest.json + registry-schema.json filenames - N-1: demote analytics to experimental (worktree-only evidence, no merged use) - N-2: workflow-registry splits into PR-R1 (schema) + PR-R2 (manifests) - N-3: ADR counts updated 7+43 - N-4: Step B scope adds RegistryManifest.Private field - N-5: ValidateManifest enum block specified explicitly Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
F-1: line 265 (8)→(7) in Assumptions F-2: Step D banner count 42→43; P2 scope 37→38 (analytics included) F-3: header revision marker v2→v3 F-4: banner PRs not gated on schema PR (README-only, no dep) ADR: counts 8→7 verified, 42→43 experimental Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Design-only PR adding a planning document and ADR-0041 for a cross-repo OSS-readiness sweep across the workflow ecosystem (engine + registry + ~50 plugin repos). No code or runtime behavior changes; only files added under docs/plans/ and decisions/.
Changes:
- New design doc detailing scope tiers (P0–P3), license audit, and a coordinated schema/struct/manifest rollout plan for an optional
statusfield. - New ADR-0041 capturing the decision to add an
experimental/verified/deprecatedstatus marker for registry manifests. - Records adversarial review history and explicit deferrals/rollback plans.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| docs/plans/2026-05-19-multi-repo-qol-sweep-design.md | New design document describing the multi-repo QoL sweep plan, tiers, and validation checklist. |
| decisions/0041-multi-repo-qol-sweep-experimental-marker.md | New ADR documenting the rationale for the status marker and autonomous-mode bypass. |
19 tasks, 61 PRs across 51 plugin repos + workflow + workflow-registry + 6 non-plugin repos. Tasks grouped by P0/P1/P2/P3 tiers with explicit sequencing constraint (PR-R1 schema + Task 1 Go struct MUST merge before Task 16 manifest population). Also: design count drift fix 50→51 public plugin repos (off-by-one from earlier audit), 43→44 unverified, 38→39 P2. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
⏱ Benchmark Results✅ No significant performance regressions detected. benchstat comparison (baseline → PR)
|
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Plan-phase round-1 review found 3 Critical + 5 Important + 4 Minor. Fixes:
C-1: Task 1 now extends PluginSummary + SearchPlugins callsites + wfctl
plugin list output format so status is user-visible at CLI surface
C-2: Task 16 script gains explicit private-cluster skip-list + negative
assertion check; uses jq-derived counts not hardcoded numbers
C-3: Task 1 branch fixed to feat/registrymanifest-status-field
(was contradicting between PR table and task body)
I-1: manifest count derived live by script, not hardcoded
I-2: Task 17 pre-flights against gh repo + files tracking issues for
13 plugins missing from registry
I-3: S0.2 folded into Task 3; explicit dependency annotation added
I-4: Task 1 rollback note added
I-5: Task 16 negative-assertion (git diff guard) added
m-1: stale duplicate PR table removed
m-3: Task 17 split into 17a (A-M, 20) + 17b (M-Z, 19) for parallelism
m-4: ADR count drift updated (44 experimental)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Adds Plugin Ecosystem section with verified/experimental/deprecated status legend linking the registry and PLUGIN_AUTHORING.md - Adds docs/EXAMPLES.md index of all example/*.yaml configs - Adds docs/templates/ shared templates for plugin repos (CONTRIBUTING, banner snippets, issue templates, PR template); required by Tasks 11-15 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This was referenced May 19, 2026
intel352
changed the title
intel352
added a commit
to GoCodeAlone/workflow-plugin-azure
that referenced
this pull request
May 19, 2026
v1.2.1 is the latest released tag; v2.0.0 was incorrect. Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-gcp
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/autodev-marketplace
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. All public GoCodeAlone-owned non-fork repos should carry MIT. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/ratchet
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. All public GoCodeAlone-owned non-fork repos should carry MIT. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/ratchet-cli
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. All public GoCodeAlone-owned non-fork repos should carry MIT. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/claude-skills
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. All public GoCodeAlone-owned non-fork repos should carry MIT. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/rover
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. All public GoCodeAlone-owned non-fork repos should carry MIT. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-gcp
that referenced
this pull request
May 19, 2026
- README: replace invented service list with actual Capabilities() resource types (Cloud Run, GKE, Cloud SQL, Memorystore, VPC, LB, DNS, Artifact Registry, API Gateway, Firewall, IAM, GCS, SSL certs). - README: rework env-vars note to clarify ADC is the default; GOOGLE_APPLICATION_CREDENTIALS is optional. - examples/minimal/config.yaml: fix gcp.credentials keys (credentialsFile/project → projectId per CreateModule source); fix iac.provider keys (project_id per Initialize source). Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-azure
that referenced
this pull request
May 19, 2026
…20) * docs(azure): add README + examples + experimental banner (QoL sweep) - Adds README.md with experimental banner, module types (iac.provider), IaC state backends (azure_blob), install instructions, and required env vars (AZURE_SUBSCRIPTION_ID, AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET). - Adds CONTRIBUTING.md from shared plugin template. - Adds examples/minimal/config.yaml (passes wfctl validate). - Adds .github/PULL_REQUEST_TEMPLATE.md + ISSUE_TEMPLATE/*. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * fix(azure): correct latest version tag in README install snippet v1.2.1 is the latest released tag; v2.0.0 was incorrect. Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-ci-generator
that referenced
this pull request
May 19, 2026
…sweep) (#9) * docs(ci-generator): add README + examples + experimental banner (QoL sweep) - Authors README.md from scratch with experimental status banner, step capabilities (step.ci_generate), supported platforms table, and install instructions - Adds examples/minimal/config.yaml (wfctl validate --skip-unknown-types ✅) - Adds CONTRIBUTING.md from shared plugin template - Adds .github/ issue templates and PR template Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fixup! docs(ci-generator): add README + examples + experimental banner (QoL sweep) - Pin install snippet to v0.1.3 (latest stable release per plugin.json) - Add CHANGELOG.md (Keep-a-Changelog format) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-aws
that referenced
this pull request
May 19, 2026
* docs(aws): add README + examples + experimental banner (QoL sweep) - Authors README.md from scratch with experimental status banner, module/step/backend capabilities, install instructions, and env var table - Adds examples/minimal/config.yaml (wfctl validate --skip-unknown-types ✅) - Adds CONTRIBUTING.md from shared plugin template - Adds .github/ issue templates and PR template Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fixup! docs(aws): add README + examples + experimental banner (QoL sweep) Use v-prefixed tag format in install snippet (v2.0.0). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fixup! docs(aws): add README + examples + experimental banner (QoL sweep) Correct install snippet version to v1.2.1 (latest stable tag from repo root). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-gcp
that referenced
this pull request
May 19, 2026
Adds an [Unreleased] section documenting the README, CONTRIBUTING, example config, and .github templates added by this QoL sweep PR. Also normalises the format header from "loosely based on" to the canonical Keep-a-Changelog phrasing. Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-tofu
that referenced
this pull request
May 19, 2026
) * docs(tofu): add README + examples + experimental banner (QoL sweep) - Authors README.md from scratch with experimental status banner, step capabilities (iac_generate_hcl, tofu_init/plan/apply, state import/export), install instructions, and OpenTofu prerequisite note - Adds examples/minimal/config.yaml (wfctl validate --skip-unknown-types ✅) - Adds CONTRIBUTING.md from shared plugin template - Adds .github/ issue templates and PR template Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fixup! docs(tofu): add README + examples + experimental banner (QoL sweep) - Pin install snippet to v0.1.2 (latest stable release per plugin.json) - Add CHANGELOG.md (Keep-a-Changelog format) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(tofu): remove phantom out_file key from step.tofu_plan example step.tofu_plan has no out_file config — plan_file is implicitly generated as <working_dir>/plan.tfplan and returned in step output. Also adds config key documentation as comments. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-gcp
that referenced
this pull request
May 19, 2026
* docs(gcp): add README + examples + experimental banner (QoL sweep) - Adds README.md with experimental banner, module-types table, install instructions, and required env vars (GOOGLE_APPLICATION_CREDENTIALS, GCP_PROJECT). - Adds CONTRIBUTING.md from shared plugin template. - Adds examples/minimal/config.yaml (passes wfctl validate). - Adds .github/PULL_REQUEST_TEMPLATE.md + ISSUE_TEMPLATE/*. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * chore(gcp): add umbrella sweep cross-reference to git log Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * fix(gcp): correct README description + example config keys - README: replace invented service list with actual Capabilities() resource types (Cloud Run, GKE, Cloud SQL, Memorystore, VPC, LB, DNS, Artifact Registry, API Gateway, Firewall, IAM, GCS, SSL certs). - README: rework env-vars note to clarify ADC is the default; GOOGLE_APPLICATION_CREDENTIALS is optional. - examples/minimal/config.yaml: fix gcp.credentials keys (credentialsFile/project → projectId per CreateModule source); fix iac.provider keys (project_id per Initialize source). Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(gcp): add [Unreleased] CHANGELOG section for QoL sweep docs Adds an [Unreleased] section documenting the README, CONTRIBUTING, example config, and .github templates added by this QoL sweep PR. Also normalises the format header from "loosely based on" to the canonical Keep-a-Changelog phrasing. Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 19, 2026
intel352
added a commit
to GoCodeAlone/workflow-registry
that referenced
this pull request
May 19, 2026
Preceding commit body listed `agent` in the verified set, but plugins/agent/manifest.json has type=builtin — the population script correctly skipped it per the `type != "external"` guard. The 6-count was always correct; only the parenthetical name list was wrong. Correct verified set (6): audit-chain, digitalocean, eventbus, payments, twilio, workflow-plugin-auth. No manifest files changed; schema validation still passes. Part of 2026-05-19 OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 See: #53 See: GoCodeAlone/workflow#715 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-registry
that referenced
this pull request
May 19, 2026
#54) * feat(registry): populate status field across external plugin manifests Sets status=verified on 6 established plugins (agent, audit-chain, digitalocean, eventbus, payments, twilio, workflow-plugin-auth) and status=experimental on 33 remaining external plugins. Private plugins (waf, security, sandbox, supply-chain, data-protection, authz-ui, cloud-ui, workflow-plugin-supply-chain) left unchanged. Built-in plugin manifests (type != "external") unchanged. Validated against schema/registry-schema.json (draft2020) — all 59 manifests pass. Negative assertion confirms no private-plugin manifests touched. Part of 2026-05-19 OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 See: #53 See: GoCodeAlone/workflow#715 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(registry): correct verified plugin list in preceding commit body Preceding commit body listed `agent` in the verified set, but plugins/agent/manifest.json has type=builtin — the population script correctly skipped it per the `type != "external"` guard. The 6-count was always correct; only the parenthetical name list was wrong. Correct verified set (6): audit-chain, digitalocean, eventbus, payments, twilio, workflow-plugin-auth. No manifest files changed; schema validation still passes. Part of 2026-05-19 OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 See: #53 See: GoCodeAlone/workflow#715 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 19, 2026
Merged
intel352
added a commit
to GoCodeAlone/workflow-plugin-admin
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
intel352
added a commit
to GoCodeAlone/workflow-plugin-analytics
that referenced
this pull request
May 19, 2026
Part of 2026-05-19 multi-repo OSS-readiness QoL sweep. See: GoCodeAlone/workflow#714 Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
This was referenced May 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Authors the design doc + ADR-0041 for a cross-org OSS-readiness QoL sweep across
workflow+workflow-registry+ ~50 public plugin repos. Triggered by a new external user adopting the project; we never audited the ecosystem end-to-end against OSS-readiness norms.This PR is design only — no code or doc changes outside
docs/plans/anddecisions/. Execution PRs follow in their respective repos.Key decisions captured
statusenum (verified/experimental/deprecated) to the registry manifest schema + README banners (ADR-0041).Scope tiers
Adversarial review history
All findings + dispositions recorded in the design doc itself.
Test plan
🤖 Generated with Claude Code