moko-platform/docs/workflows/README.md

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 MokoStandards-API:

• MokoStandards-Template-Joomla — Joomla extension workflows
• MokoStandards-Template-Dolibarr — Dolibarr module workflows
• MokoStandards-Template-Generic — Generic project workflows
• MokoStandards-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

1. New repos are created from a template repo (e.g., MokoStandards-Template-Joomla), which includes .gitea/workflows/ pre-populated.
2. Existing repos receive workflow updates via the bulk-sync engine, which clones the template repo, compares, and pushes changes.
3. All workflows run from .gitea/workflows/ only — Gitea Actions does not execute workflows from .github/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/MokoStandards-API
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