Promote

Promote or graduate a project-local bundle to its upstream AIWG location or to a private corpus path.

jmagly Updated

File contents

Promote Project-Local Bundle

Graduate a proven project-local bundle without losing its source provenance.

Behavior

  1. Identify the project-local bundle and its intended destination.

  2. Preview the copy and registry transition:

    aiwg promote <name> --dry-run
    
  3. Promote to the declared upstream location or a private corpus:

    aiwg promote <name> --to upstream
    aiwg promote <name> --to corpus <path>
    
  4. Use --cleanup only when the project-local source should be removed after successful promotion. Use --force only after reviewing a destination conflict.

Safety

  • Run aiwg doctor and a dry run before promotion.
  • Promotion verifies the bundle manifest and destination before copying.
  • Omit --cleanup to retain the project-local source.

References

  • @$AIWG_ROOT/src/cli/handlers/subcommands.ts — promote command handler
  • @$AIWG_ROOT/src/extensions/project-local-promote.ts — promotion implementation
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/steward-quickref/SKILL.md

jmagly/ai-writing-guide/tree/main/agentic/code/plugins/utils/skills/promote commit ee54002cbd

Frequently asked questions

npx skillmds@latest add jmagly-ai-writing-guide/promote