Skip to main content

universal method / promote

promote

Move a useful transient artifact into the project.

  1. Load
  2. Apply
  3. Return

universal method

Why this exists

Use it when a temporary record deserves a permanent home.

returns

Moved document, repaired references, validated format, explicit commit choice.

boundary

Uses a real project destination. Never invents a store or pushes implicitly.

common misuse

Promoting a transient note without repairing references or checking its destination.

promotion path

transient -> durable

note
~/.agents/artifacts/app/AUDIT-api.md
        | sanitize + repair links
docs/decisions/AUDIT-api.md

working shape

Keep the result in the conversation.

moves a selected record

skills add

Load it when the task fits.

pwrcheckevidence

# install one skill globally

$ npx skills add jcosta33/suspec-skills --skill promote -g