Skip to main content

Workflow Model

PropertyValue
descriptionThe governance workflow model for repo creation, orchestration, docs, and releases.
relatedMAC, Ecosystem, Repo Boundaries, MAC CLI
urlsGitHub

The governance workflow model is intentionally simple in this first pass.

Repo Creation And Naming​

  • new MAC products use stable mac-<slug> naming
  • the local repo name, GitHub repo name, and product slug should stay aligned
  • a new MAC product should have a clear registry entry and boundary note before broad rollout

Orchestration​

  • MAC product work defaults to Linear
  • client work defaults to Basecamp
  • exceptions should be explicit rather than implicit

Docs Ownership​

  • governance source docs are authored in mac
  • publishable governance docs are surfaced in doc/mac/
  • product repos keep repo-local quick docs and local maintainer context

Git And Releases​

The current standard branch flow is:

  • work on dev
  • move stable work to main
  • tag releases from main

The detailed repo-specific release rules still belong in the relevant product repo and its published product docs.