1
workflows-README
Jonathan Miller edited this page 2026-06-06 22:59:24 +00:00
← Home
Workflow Templates — Secondary Reference
Status: Active | Version: 04.06.00 | Effective: 2026-05-05
Canonical documentation: WORKFLOW_STANDARDS.md is the primary reference for workflow standards, inventory, and architecture. This file provides supplementary context only.
Architecture
Workflow templates live in their respective template repositories, not in moko-platform:
- moko-platform-Template-Joomla — Joomla extension workflows
- moko-platform-Template-Dolibarr — Dolibarr module workflows
- moko-platform-Template-Generic — Generic project workflows
- moko-platform-Template-Client — Client site workflows
The sync engine clones the appropriate template repo at runtime and applies workflows to target repositories. There is no local templates/workflows/ directory to copy from.
How Workflows Reach Repos
- New repos are created from a template repo (e.g.,
moko-platform-Template-Joomla), which includes.gitea/workflows/pre-populated. - Existing repos receive workflow updates via the bulk-sync engine, which clones the template repo, compares, and pushes changes.
- All workflows run from
.gitea/workflows/only — Gitea Actions does not execute workflows from.gitea/workflows/.
Important Notes
- Releases use the 5-stream tag system (
stable,release-candidate,beta,alpha,development). See Release System. - All workflows require SPDX license headers (GPL-3.0-or-later).
- Pin action versions (use
@v4, not@main).
Related Documentation
- WORKFLOW_STANDARDS.md — Canonical workflow reference
- Workflow Architecture
- Workflow Inventory
- Reusable Workflows
- Release System
- Build System
- Health Scoring System
Metadata
| Field | Value |
|---|---|
| Document | Workflow Templates — Secondary Reference |
| Path | /docs/workflows/README.md |
| Repository | https://git.mokoconsulting.tech/MokoConsulting/moko-platform |
| Owner | Moko Consulting |
| Status | Active |
| Version | 04.06.00 |
| Effective | 2026-05-05 |
Version History
| Version | Date | Changes |
|---|---|---|
| 04.06.00 | 2026-05-05 | Rewritten to reflect current architecture: templates live in template repos, sync engine clones at runtime, removed stale templates/workflows/ references |
| 04.00.04 | 2026-02-08 | Consolidated workflow templates |
| 04.00.04 | 2026-01-07 | Added public workflow templates documentation |
| 01.00.00 | 2026-01-07 | Initial comprehensive workflow documentation |
Repo: moko-platform · moko-platform wiki
| Field | Value |
|---|---|
| Minimum Version | 04.07.00 |
| Platform | all |
| Applies To | All repositories |
| Revision | Date | Author | Description |
|---|---|---|---|
| 1.0 | 2026-05-08 | Moko Consulting | Initial version |