minions-template/docs/export-manifest.md

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/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/chat/README.md	yes	template-replace	PM	baseline chat workflow guidance
minions/chat/general-thread-template.md	yes	template-replace	PM	baseline general thread template
minions/chat/topic-thread-template.md	yes	template-replace	PM	baseline topic thread template
minions/chat/*.md daily/topic history	yes	downstream-owned	PM / Operator	preserve downstream discussion history
minions/plans/*.md live plan docs	yes	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