[![MokoStandards](https://img.shields.io/badge/MokoStandards-04.06.00-orange)](https://git.mokoconsulting.tech/MokoConsulting/MokoStandards)

# Workflow Templates — Secondary Reference

**Status**: Active | **Version**: 04.06.00 | **Effective**: 2026-05-05

> **Canonical documentation**: [WORKFLOW_STANDARDS.md](../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](./release-system.md).
- All workflows require SPDX license headers (GPL-3.0-or-later).
- Pin action versions (use `@v4`, not `@main`).

## Related Documentation

- [WORKFLOW_STANDARDS.md](../WORKFLOW_STANDARDS.md) — Canonical workflow reference
- [Workflow Architecture](./workflow-architecture.md)
- [Workflow Inventory](./workflow-inventory.md)
- [Reusable Workflows](./reusable-workflows.md)
- [Release System](./release-system.md)
- [Build System](../build-system/README.md)
- [Health Scoring System](../policy/health-scoring.md)

## 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 |