# Export Manifest

This manifest defines how files from the template should be treated in
downstream repositories.

Use this manifest with:

- `docs/downstream-onboarding-playbook.md` for first export into a downstream repo
- `docs/downstream-upgrade-playbook.md` for later template migrations

## Strategy Meanings

- `template-replace`: usually replace from the new template version, then
  consciously reapply any intentional downstream divergence
- `manual-merge`: always review and merge with downstream state
- `downstream-owned`: do not overwrite during template upgrades
- `do-not-export`: keep out of downstream live files and out of the vendored
  `.minions-template/` snapshot unless the Operator explicitly chooses
  otherwise

## Vendored Snapshot Rule

`.minions-template/` is an export-ready snapshot, not a full clone of the
template repo.

- exclude `.git/`
- exclude all `do-not-export` files
- keep only the files needed to onboard and later upgrade downstream minion
  workflow

## Manifest

| Path | Initial export | Upgrade strategy | Default owner | Notes |
| --- | --- | --- | --- | --- |
| `.mm.md` | no | `do-not-export` | MM / Operator | local template-maintainer context only |
| `README.md` | bootstrap reference only | `downstream-owned` | Operator / PM | downstream repos should replace this with a project-specific README |
| `CHANGELOG.md` | yes | `downstream-owned` | PM | keep downstream project history; do not overwrite with template history |
| `INIT.md` | yes | `manual-merge` | PM | preserve project-specific onboarding context while merging new baseline workflow rules |
| `MEMORY.md` | yes | `manual-merge` | PM | merge new template guardrails while preserving project-specific truth |
| `minion-version.md` | yes | `manual-merge` | PM | update base-template version after upgrade; preserve downstream version suffix |
| `docs/collaboration-playbook.md` | yes | `template-replace` | PM | baseline workflow doc |
| `docs/project/mailbox-collaboration-model.md` | yes | `template-replace` | PM | baseline mailbox-first coordination model |
| `docs/operator-onboarding-checklist.md` | yes | `manual-merge` | PM | preserve completed downstream decisions |
| `docs/downstream-onboarding-playbook.md` | yes | `template-replace` | PM | baseline initial onboarding procedure |
| `docs/downstream-upgrade-playbook.md` | yes | `template-replace` | PM | baseline downstream-upgrade procedure |
| `docs/export-manifest.md` | yes | `template-replace` | PM | baseline export/merge strategy |
| `minions/README.md` | yes | `template-replace` | PM | directory structure guidance |
| `minions/roles/PM.md` | yes | `template-replace` | PM | review local role customizations before overwrite |
| `minions/roles/AM.md` | yes | `template-replace` | PM / AM | review local role customizations before overwrite |
| `minions/roles/CM.md` | yes | `template-replace` | PM / CM | review local role customizations before overwrite |
| `minions/roles/SM.md` | yes | `template-replace` | PM / SM | review local role customizations before overwrite |
| `minions/roles/OM.md` | yes | `template-replace` | PM / OM | review local role customizations before overwrite |
| `minions/plans/README.md` | yes | `template-replace` | PM | baseline planning guidance |
| `minions/plans/milestone-plan-template.md` | yes | `template-replace` | PM | baseline planning template |
| `minions/mail/README.md` | yes | `template-replace` | PM | baseline mailbox workflow guidance |
| `minions/mail/packet-template.md` | yes | `template-replace` | PM | baseline packet structure |
| `minions/chat/README.md` | yes | `template-replace` | PM | baseline PM-summary workflow guidance |
| `minions/chat/general-thread-template.md` | yes | `template-replace` | PM | baseline daily summary template |
| `minions/chat/topic-thread-template.md` | yes | `template-replace` | PM | baseline topic summary template |
| `minions/mail/*/` live packet history | no | `downstream-owned` | PM / Operator | preserve downstream packet history; do not export template packet history |
| `minions/chat/*.md` daily/topic history | no | `downstream-owned` | PM / Operator | preserve downstream summary history; do not export template history |
| `minions/plans/*.md` live plan docs | no | `downstream-owned` | PM | preserve project-specific plans and status |
| `ROADMAP.md` | downstream required | `downstream-owned` | PM | currently required by the workflow but not shipped as a template file |
| `TODO.md` | downstream required | `downstream-owned` | PM | currently required by the workflow but not shipped as a template file |