MokoCLI/docs/workflows/index.md

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

# Docs Index: /docs/workflows

## Purpose

Documentation for all GitHub Actions workflows used across governed repositories.

## Deployment Workflows

### Dolibarr + Generic (automatic FTP deploy)

- [Dev Deployment](./dev-deployment.md) — deploy to dev FTP on push to `dev/**`, `alpha/**`, `beta/**`, or `rc/**`
- [Demo Deployment](./demo-deployment.md) — deploy to demo FTP on push to `main`

> **Note:** `deploy-rs.yml` is **retired**. RS deployment is handled via the release pipeline only. See [RS Deployment (deprecated)](./rs-deployment.md).

### Joomla (no automatic FTP deploy)

Joomla repos use GitHub Release ZIPs via `auto-release.yml` + `updates.xml`. No automatic FTP deploy.

- [Deploy Manual](./deploy-manual.md) — manual workflow_dispatch FTP deploy for Joomla dev testing

## Release & Version Workflows

- [Auto Release](./auto-release.md) — platform-specific GitHub Release on push to main (generic, Joomla, Dolibarr)
- [Build Release](./build-release.md) — build release artifacts
- [Release System](./release-system.md) — end-to-end release lifecycle (dev → rc → main)
- [Changelog Management](./changelog-management.md) — automated changelog generation
- [Changelog Validation](./changelog-validation.md) — validates CHANGELOG.md format on PR

## Client Repositories

- [Client Repo Standards](../client-repos.md) — naming, privacy, structure, deployment for client-* repos

## CI & Compliance Workflows

- [CI Joomla](./ci-joomla.md) — Joomla-specific CI checks (manifest validation, language files, XML lint)
- [CI Dolibarr](./ci-dolibarr.md) — Dolibarr-specific CI checks (module descriptor, PHP lint)
- [Standards Compliance](./standards-compliance.md) — enterprise standards validation
- [Repo Health](./repo-health.md) — platform-aware repository health checks
- [Shared Workflows](./shared-workflows.md) — reusable workflow templates
- [Reusable Workflows](./reusable-workflows.md) — reusable workflow reference
- [Workflow Architecture](./workflow-architecture.md) — design and architecture
- [Workflow Inventory](./workflow-inventory.md) — complete inventory of all workflows

## Branch & Issue Management

- [Dev Branch Tracking](./dev-branch-tracking.md) — manual issue creation for dev branches, auto-creation for rc branches
- [Sub-Issue Management](./sub-issue-management.md) — hierarchical issue tracking

## Update Server

- [Update Server](./update-server.md) — multi-entry Joomla updates.xml with stability filtering
- [Reserve Dolibarr Module ID](./reserve-dolibarr-module-id.md) — module ID reservation

## Platform Workflow Matrix

| Workflow | Joomla | Dolibarr | Generic |
|----------|--------|----------|---------|
| `auto-release.yml` | Yes (ZIP + SHA-256 + updates.xml) | Yes (update.txt) | Yes |
| `deploy-dev.yml` | No | Yes | Yes |
| `deploy-demo.yml` | No | Yes | Yes |
| `deploy-manual.yml` | Yes | No | No |
| `update-server.yml` | Yes | No | No |
| `ci-joomla.yml` | Yes | No | No |
| `ci-dolibarr.yml` | No | Yes | No |
| `repo_health.yml` | Yes | Yes | Yes |
| `changelog-validation.yml` | Yes | Yes | Yes |

## Metadata

- **Document Type:** index
- **Last Updated:** 2026-04-07
- **Version:** 04.06.00