Argus

Argus

Keep a hundred eyes on the live context, but preserve only the delta that should outlive it. Do not archive the conversation itself.

Run one checkpoint

1. Identify durable changes only:

   • explicit decisions, corrections, and stable preferences;
   • promises, deadlines, waiting-on states, and changed priorities;
   • project state, evidence, results, blockers, and next actions;
   • reusable methods, sources, and outputs.

2. Exclude unselected brainstorming, conversational filler, duplicated summaries, unsupported claims, and secrets outside their authorised store.

3. Discover the home registry and candidate archives:

   python3 scripts/discover_archivums.py --json
   

   Resolve scripts/ relative to this installed skill. Prefer an explicit --registry, then ARCHIVUM_REGISTRY, then $ARCHIVUM_HOME/00_meta/archivum_registry.toml. If no registry resolves the choice and several archives remain plausible, ask rather than guess.

4. Route each delta using routing.md. One checkpoint may update several surfaces, but each fact has one canonical owner.

5. For commitment-shaped state, use the workspace's configured commitment system rather than inventing a parallel ledger. Read its contract before mutation.

6. For resource-shaped state or substantial autonomous work, use the configured budget authority rather than creating a second resource ledger. Gate expensive work and record actual usage where that system requires it.

7. In each selected Archivum, read its agent contract and config.yaml, then load only the bounded core context and record needed for the delta. Inspect its worktree and search before creating.

8. Apply the bidirectional home-anchor contract in backlink-contract.md. Every private satellite record must remain reachable from the home Archivum and link back to its home anchor.

9. Verify changed files, links, schema or ledger checks, and relevant tests. Commit only where the archive contract or user requires it. Never publish, send, submit, or disclose merely because capture is complete.

10. Report the durable records changed, surfaces intentionally untouched, and one next action if work remains.

Route by ownership, not keywords

• Commitment system: promises, deadlines, waiting on people, and current workstream custody.
• Budget authority: token and GPU budgets, account windows, autonomous-run gates, session histories, and artefact custody.
• Home Archivum: cross-domain projects, identity, relationships, personal decisions, stable preferences, and the cross-archive index.
• Research Archivum: hypotheses, literature, experiments, results, methods, and scientific strategy.
• Admin Archivum: company operations, governance, finance, legal, people operations, and internal administration.
• Career archive: role research, applications, evidence packets, and pipeline state.
• Existing specialist Archivum: use when the project already has a canonical domain store.
• New Archivum: propose only for a distinct audience, permission boundary, owner, or lifecycle. Never create one silently.

Read routing.md whenever a delta spans domains or has more than one plausible owner.

Respect each Archivum's configured layout

Treat a version-2 workspace's config.yaml as the authoritative path map. Resolve workspace.profile_file, workspace.state_file, workspace.schema_file, directories.*, and canonical_files.* from that file before reading or writing. Never assume numbered directory names such as 01_projects; the research Archivum, for example, maps projects to 01_active_research.

Read the selected archive's AGENTS.md first when present, then its configured profile, state, and schema only as needed. Prefer the archive-local archivum CLI for deterministic creation, status, and doctor checks when available. For a legacy workspace without version-2 configuration, inspect its existing structure and preserve it; do not migrate it unless the user requested migration.

Keep the watcher quiet

• Run once after a meaningful milestone or before ending work that changed durable state.
• Batch related deltas; never checkpoint after every edit or tool call.
• Do not recursively archive the mechanical fact that Argus updated an archive.
• If nothing durable changed, make no write and say nothing about capture.
• Treat a checkpoint as preservation authority, not permission to broaden scope or perform unrelated external actions.

Use checkpoint-prompt.md to make Argus available automatically in repository-aware agents.

Validate the archive graph

python3 scripts/discover_archivums.py --registry /path/to/00_meta/archivum_registry.toml --json
python3 scripts/check_backlinks.py --registry /path/to/00_meta/archivum_registry.toml

Both scripts are read-only. Discovery also reports each Archivum's configuration version and available agent contracts. Backlink validation rejects logical paths that escape their registered archive root.