Skip to the guide

Archive what's been replaced

Move old drafts out of the way into an archive folder, and archive a whole Space when its work is done, so agents answer from what's current.

Have your agent do it

Paste this to your agent. It reads this guide and works through it with you.

Read https://avalandra.com/help/archive-what-has-been-replaced.md and do it with me. Ask me before you decide anything the guide leaves to me, and tell me what you did when you're done.

Old drafts don't have to be deleted to stop causing confusion. Moving them into an archive folder keeps them for reference and takes them out of the way, so nobody, and no agent, mistakes them for the current version.

When a whole piece of work is finished, you can archive its Space and restore it later if you need it.

Always say why

The most useful thing you can give your agent is the reason something should go. "Replaced by the agreed brief", "the client dropped this feature" or "a copy made by mistake" tells your agent what to look for, lets it spot other documents that fit the same reason, and tells anyone who finds the archive later why each document is there instead of in use.

A reason usually fits one of these:

  • Replaced. A newer version is the one to use. Name it.
  • Finished. The work it was for is done.
  • No longer true. Plans or facts changed since it was written.
  • A copy. The same content lives somewhere else. Say where.
  • Shouldn't be here. It belongs in another Space, or holds something the Space's readers shouldn't see.

Archive old documents

  1. Say what should go, and why. Name the documents or describe them, and give the reason.
  2. Check your agent's list. It shows each document it found with the reason it thinks applies, and asks about any it isn't sure of.
  3. Agree, and it records the reasons. It moves what you agreed, adds a note at the top of each archived document saying when, why and what replaced it, and writes up the whole change.
Ask your agent
In the [name of your Space] Space, find documents that should be archived because [the reason, such as they've been replaced by the agreed version or the work they were for is finished]. List each one with the reason it fits and what replaced it, if anything. When I agree, move them into the [archive folder name] folder, add a note at the top of each saying when it was archived, why and what replaced it, and write down what moved and why using the template at https://avalandra.com/help/template-files/space-changes. Name it "Space changes" followed by today's date, and nothing longer.
Template: Space changesSee this template
DocumentSpace changes 10 Nov

Links to a moved document keep working, so nothing that points to it breaks.

Archive a finished Space

Export it first, so you have your own copy, then archive it.

Ask your agent
The work in the [name of your Space] Space is finished. Export the Space with its history to [where to save the file], note the export using the template at https://avalandra.com/help/template-files/export-record (name it "Export" followed by today's date), and then archive the Space.

Archive or remove?

Archive by default. Remove a document only when you're sure nobody needs it, such as an accidental copy. Say exactly which document and why it should be removed, and your agent records that reason in the Space changes note, so the team can see what went and why after it's gone.

Ask your agent
Remove [the document] from the [name of your Space] Space, because [the reason, such as it's an accidental copy of the agreed brief]. Before you remove it, confirm it's the one I mean and record what you removed and why using the template at https://avalandra.com/help/template-files/space-changes. Name it "Space changes" followed by today's date, and nothing longer.

Questions

Can I bring an archived Space back?

Yes. An archived Space can be restored.

Should old drafts go in a separate Space instead?

Usually a folder in the same Space is enough, and it keeps the history beside the work. Move them to another Space if they need different people to see them.

Will my agent still read archived documents?

Ask it to work from current documents and to mention when it relies on something archived. Archived documents stay readable, so they're there when someone needs the history.

For agents

ava document move DOC_ID --space SPACE_ID --idempotency-key KEY
ava document reorder --space SPACE_ID --idempotency-key KEY
ava space export --space SPACE_ID
ava space archive --space SPACE_ID --idempotency-key KEY
ava space restore --space SPACE_ID --idempotency-key KEY
  • Use ava document reorder (with parent_id and document_ids) to move many documents into one folder in a single call.
  • Every item needs a reason. If the person hasn't given one, ask before you move or remove anything. Record the reason per document in the Space changes note, and add a dated note at the top of each archived document with the reason and a link to its replacement.
  • Re-read ava document tree after moving and report what is actually there; a move can fail quietly.
  • Archive a Space only when the person asks, after offering to export it first.
  • Run ava document remove only for documents the person named and explicitly agreed to remove.
Support