Update Gitflow (GitHub Actions Workflows)
This skill focuses edits and reviews on the project’s GitHub Actions workflow files so that "update gitflow"-style requests are applied to the right files with the right context.
When to Use
Apply this skill when the user:
- Says "update gitflow", "update git flow", or "change gitflow"
- Asks to update, change, or review the CI or GitHub Actions workflows
- Mentions workflows, CI pipeline, docs deploy, or GitHub Actions in a way that implies editing the YAML
Target Files
Always work with these two workflow files:
| File |
Purpose |
.github/workflows/ci.yml |
Main CI: backend/frontend tests, Codecov, SonarQube, optional benchmark and performance jobs |
.github/workflows/docs.yml |
Docs deploy: MkDocs build and publish to GitHub Pages |
If the user’s request applies to only one of them (e.g. "add a step to CI"), edit only that file. If it’s generic ("update gitflow"), read both and apply changes to whichever is relevant.
What to Do
Load context
Apply the user’s request
- Implement the requested changes in the appropriate workflow(s).
- Preserve existing structure (triggers, job names, dependencies, manual-only jobs like
benchmark and test-backend-performance).
- Keep
ci.yml and docs.yml consistent with the behavior described in the rule (e.g. performance tests only on workflow_dispatch).
Confirm
- Summarize what was changed and in which file(s).
Conventions (from github-workflows.mdc)
- ci.yml: Runs on push to
main/dev, PRs, and workflow_dispatch. Jobs: test-backend, test-frontend, sonar, sonar-frontend run every time; benchmark and test-backend-performance only on manual run.
- docs.yml: Runs on push to
main when docs/** or mkdocs.yml change, and on workflow_dispatch. Single job: build and deploy with MkDocs.
When adding or changing jobs or steps, align with these conventions and update the rule if the workflow behavior changes.
Source: olexmal/MegaBrain — distributed by TomeVault.
1---2name: update-gitflow3description: Updates or reviews GitHub Actions workflows (CI and docs deploy). When the user says "update gitflow", "change CI", "update workflows", or similar, the agent focuses on .github/workflows/ci.yml and .github/workflows/docs.yml, applies the requested changes, and respects the project's workflow documentation in .cursor/rules/github-workflows.mdc. Use when this capability is needed.4---56# Update Gitflow (GitHub Actions Workflows)78This skill focuses edits and reviews on the project’s GitHub Actions workflow files so that "update gitflow"-style requests are applied to the right files with the right context.910## When to Use1112Apply this skill when the user:1314- Says **"update gitflow"**, **"update git flow"**, or **"change gitflow"**15- Asks to **update**, **change**, or **review** the **CI** or **GitHub Actions** workflows16- Mentions **workflows**, **CI pipeline**, **docs deploy**, or **GitHub Actions** in a way that implies editing the YAML1718## Target Files1920Always work with these two workflow files:2122| File | Purpose |23|------|--------|24| **`.github/workflows/ci.yml`** | Main CI: backend/frontend tests, Codecov, SonarQube, optional benchmark and performance jobs |25| **`.github/workflows/docs.yml`** | Docs deploy: MkDocs build and publish to GitHub Pages |2627If the user’s request applies to only one of them (e.g. "add a step to CI"), edit only that file. If it’s generic ("update gitflow"), read both and apply changes to whichever is relevant.2829## What to Do30311. **Load context**32 - Read [.cursor/rules/github-workflows.mdc](../../rules/github-workflows.mdc) for triggers, jobs, and conventions.33 - Read the relevant workflow file(s): [.github/workflows/ci.yml](../../../.github/workflows/ci.yml) and/or [.github/workflows/docs.yml](../../../.github/workflows/docs.yml).34352. **Apply the user’s request**36 - Implement the requested changes in the appropriate workflow(s).37 - Preserve existing structure (triggers, job names, dependencies, manual-only jobs like `benchmark` and `test-backend-performance`).38 - Keep `ci.yml` and `docs.yml` consistent with the behavior described in the rule (e.g. performance tests only on `workflow_dispatch`).39403. **Confirm**41 - Summarize what was changed and in which file(s).4243## Conventions (from github-workflows.mdc)4445- **ci.yml:** Runs on push to `main`/`dev`, PRs, and `workflow_dispatch`. Jobs: `test-backend`, `test-frontend`, `sonar`, `sonar-frontend` run every time; `benchmark` and `test-backend-performance` only on manual run.46- **docs.yml:** Runs on push to `main` when `docs/**` or `mkdocs.yml` change, and on `workflow_dispatch`. Single job: build and deploy with MkDocs.4748When adding or changing jobs or steps, align with these conventions and update the rule if the workflow behavior changes.4950---51> Source: [olexmal/MegaBrain](https://github.com/olexmal/MegaBrain) — distributed by [TomeVault](https://tomevault.io).52<!-- tomevault:4.0:skill_md:2026-06-16 -->