Public Access
Jonathan Miller
62 lines
2.8 KiB
Markdown
62 lines
2.8 KiB
Markdown
[](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 |
|