Help › ProjectChanges · version 8 ·

Project history: decisions and changes

Executive and Conductor projects. Project changes (Log:ProjectChanges) lists the project's decisions (a call a person made, written down by them or their agent) and changes (a document edit worth recording), each with who, when, the feature and task it is about, and the layer (spec, design, build, skill). It opens on the last week; Query searches by type, date range, task, person, agent, feature and layer. A topic's own Change log tab shows the same entries for that topic.

Find a decision or a change

  • "When did we decide to drop PayPal, and who decided?" Set the type to decisions and put PayPal in the text. The entry names the person, the date and the task it came from.
  • "What changed in the spec this week?" Set the layer to spec and the range to this week. Each change names the document and who made it.
  • "Everything about the billing feature": put the feature in Query, with no type, to see the decisions and the changes together.
  • On one topic: its own Change log tab shows just its entries.

When to use it, and when something else

  • What people decided, and which documents changed: here.
  • What an AI agent did while working: AI changes.
  • How tasks moved: Pipeline history.

How long it is kept

  • Kept on the project: 7 days.
  • Archived: every night, the entries from whole days (UTC) older than that (every kind: decisions, changes, AI work, pipeline, runs) are written to one file in the project's Files, folder _archive/, named history-<first day>--<last day>.jsonl.gz, then removed from the project. A day that hasn't ended (at midnight UTC) is never archived.
  • The file: gzipped JSON Lines, one entry per line with all its fields; opens with any gunzip. Members of the project can download it. A query reaching back further than 7 days names the files that cover it.
  • If archiving fails nothing is removed; it is retried the next night (see the history archive cron on the Crons page).
  • Archive files stay in the Files page's _archive/ folder until the project's archive size quota is reached; then the oldest are deleted first.

Updated by razie · version 8