docs: add architect role and template workflows

This commit is contained in:
deamonkai
2026-04-12 12:25:07 -05:00
parent 64de2660d2
commit e650ec65d1
18 changed files with 626 additions and 53 deletions

49
docs/export-manifest.md Normal file
View 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 |