65 lines
4.5 KiB
Markdown
65 lines
4.5 KiB
Markdown
# 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 |
|