docs: add architect role and template workflows
This commit is contained in:
49
docs/export-manifest.md
Normal file
49
docs/export-manifest.md
Normal file
@@ -0,0 +1,49 @@
|
||||
# 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 in the template repo only unless the Operator explicitly
|
||||
chooses otherwise
|
||||
|
||||
## 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 |
|
||||
Reference in New Issue
Block a user