docs(ci-generator): add README + examples + experimental banner (QoL sweep)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Report a bug in this plugin
+title: '[Bug] '
+labels: bug
+assignees: ''
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To reproduce
+
+Steps to reproduce the behavior:
+1. Config used (redact any secrets)
+2. Command run
+3. Error output
+
+## Expected behavior
+
+What you expected to happen.
+
+## Environment
+
+- workflow engine version: <!-- e.g. 0.3.51 -->
+- plugin version: <!-- e.g. 1.0.0 -->
+- Go version: <!-- go version -->
+- OS: <!-- e.g. linux/amd64, darwin/arm64 -->
+
+## Additional context
+
+Add any other context or logs here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature request
+about: Suggest a new capability for this plugin
+title: '[Feature] '
+labels: enhancement
+assignees: ''
+---
+
+## Summary
+
+A one-sentence description of the feature.
+
+## Motivation
+
+Why is this feature needed? What problem does it solve?
+
+## Proposed solution
+
+How would you like it to work? Include config schema changes if relevant.
+
+## Alternatives considered
+
+Any alternative approaches you considered and why you ruled them out.
+
+## Additional context
+
+Links, screenshots, or related issues.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+## Summary
+
+<!-- What does this PR do? 1-3 bullet points. -->
+
+## Motivation
+
+<!-- Why is this change needed? Link to issue if applicable. Closes #NNN -->
+
+## Test plan
+
+- [ ] `go build ./...` passes
+- [ ] `go vet ./...` passes
+- [ ] `go test ./...` passes
+- [ ] Manual smoke test (describe)
+
+## Checklist
+
+- [ ] CHANGELOG.md updated (Keep-a-Changelog format)
+- [ ] No secrets or credentials included
+- [ ] One feature or bugfix per PR

CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.3] - 2026-04-27
+
+Initial CHANGELOG entry tracking the current release. See git tags for prior versions.

CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing to workflow-plugin-ci-generator
+
+This plugin is part of the [GoCodeAlone/workflow](https://github.com/GoCodeAlone/workflow) ecosystem.
+
+## Before contributing
+
+Read the [upstream CONTRIBUTING.md](https://github.com/GoCodeAlone/workflow/blob/main/CONTRIBUTING.md) for general conventions, signing, and review expectations.
+
+## Local development
+
+```sh
+git clone https://github.com/GoCodeAlone/workflow-plugin-ci-generator.git
+cd workflow-plugin-ci-generator
+go build ./...
+go test ./...
+```
+
+## Pull requests
+
+- One feature or bugfix per PR.
+- Update CHANGELOG.md with a Keep-a-Changelog entry.
+- Add tests covering new behavior.
+- Run `go vet ./...` before pushing.
+
+## Reporting issues
+
+See the issue templates under `.github/ISSUE_TEMPLATE/`.

README.md

@@ -0,0 +1,52 @@
+# workflow-plugin-ci-generator
+
+> ⚠️ **Experimental** — This plugin compiles and passes its unit tests but has not been validated in any active GoCodeAlone-internal production deployment. Use with caution. Please [open an issue](https://github.com/GoCodeAlone/workflow-plugin-ci-generator/issues/new) if you adopt it so we can promote it to **verified** status.
+
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Go Reference](https://pkg.go.dev/badge/github.com/GoCodeAlone/workflow-plugin-ci-generator.svg)](https://pkg.go.dev/github.com/GoCodeAlone/workflow-plugin-ci-generator)
+
+CI/CD config generator for workflow projects — emits GitHub Actions, GitLab CI, Jenkins, and CircleCI pipelines from workflow project manifests.
+
+## What it provides
+
+**Pipeline step types:**
+- `step.ci_generate` — Generate CI/CD configuration files (GitHub Actions, GitLab CI, Jenkins, CircleCI) from a workflow project manifest
+
+## Install
+
+```yaml
+# In your wfctl.yaml
+version: 1
+plugins:
+  - name: workflow-plugin-ci-generator
+    version: v0.1.3
+    source: github.com/GoCodeAlone/workflow-plugin-ci-generator
+```
+
+Then:
+
+```sh
+wfctl plugin install
+```
+
+## Minimal example
+
+See [`examples/minimal/config.yaml`](examples/minimal/config.yaml).
+
+## Supported CI platforms
+
+| Platform | Output file |
+|----------|-------------|
+| GitHub Actions | `.github/workflows/workflow.yml` |
+| GitLab CI | `.gitlab-ci.yml` |
+| Jenkins | `Jenkinsfile` |
+| CircleCI | `.circleci/config.yml` |
+
+## Documentation
+
+- [Plugin authoring guide (upstream)](https://github.com/GoCodeAlone/workflow/blob/main/docs/PLUGIN_AUTHORING.md)
+- [Workflow engine docs](https://github.com/GoCodeAlone/workflow)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

examples/minimal/config.yaml

@@ -0,0 +1,18 @@
+# workflow-plugin-ci-generator minimal example
+# Generates CI/CD config files from a workflow project manifest.
+# Validate with: wfctl validate --skip-unknown-types examples/minimal/config.yaml
+
+workflows:
+  pipeline:
+    trigger:
+      type: http
+      config:
+        path: /ci/generate
+        method: POST
+    steps:
+      - name: generate-ci
+        type: step.ci_generate
+        config:
+          platform: github-actions
+          output_dir: .
+          project_name: my-workflow-project