agent-system-of-record

Organize agent optimization work into versioned workspaces with configuration snapshots and a central log.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/randoneering/nix-flake-mirror --skill agent-system-of-record
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-system-of-record
Source: https://github.com/randoneering/nix-flake-mirror/tree/main/home/programs/opencode/skills/snowflake/agent_optimization/agent-system-of-record
Command: npx skills add https://github.com/randoneering/nix-flake-mirror --skill agent-system-of-record

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes a clear, auditable protocol for tracking and reproducing agent optimization work across environments by organizing per-agent workspaces, versioned configuration snapshots, evaluation outputs, and an ongoing optimization log.

Core Features & Use Cases

  • Versioned workspaces per agent: Each agent gets its own, time-stamped directory tree to isolate experiments.
  • Versioned configurations and metadata: Snapshots include agent_config.json, instructions_orchestration.txt, and change_manifest.md for traceability.
  • Central optimization log: A single optimization_log.md records goals, changes, evaluations, and outcomes to support audits and handoffs.
  • Safe production practices: Encourages cloning production agents for experimentation and strict separation between instruction changes and model/tool changes.

Quick Start

Create a new versioned workspace for your agent and snapshot the initial agent configuration to begin tracking optimization.

Frequently Asked Questions about agent-system-of-record

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track agent optimization changes for reproducibility and audits?

Track agent optimization changes by organizing versioned workspace folders, per-version configuration snapshots, and a centralized optimization log. This structure isolates experiments and records goals, changes, and evaluation outcomes to ensure full reproducibility and auditability.

What is the best way to separate agent instruction changes from model or tool changes?

The best way to separate instruction changes from model or tool changes is to enforce safe deployment practices within your workspace. This strict separation prevents overlapping variables and ensures your agent evaluations accurately measure the impact of specific modifications.

How do I create a versioned workspace for agent optimization?

Create a versioned workspace by setting up a time-stamped directory tree for your agent. Snapshot the initial agent configuration, orchestration instructions, and change manifest to begin tracking optimization iterations safely.

Can I clone a production agent for optimization experiments without affecting the live version?

Yes, you can clone production agents for experimentation. This safe deployment practice isolates your optimization work in separate versioned workspace folders, ensuring live production agents remain unaffected by ongoing configuration changes.

What files do I need to maintain an agent change manifest and optimization log?

You need to maintain an agent_config.json for configurations, instructions_orchestration.txt for orchestration, change_manifest.md for traceability, and optimization_log.md. These files collectively record snapshots, changes, and evaluation outcomes for audits.

Why does my agent optimization lack reproducibility across different environments?

Agent optimization lacks reproducibility without versioned configuration snapshots and a centralized optimization log. Establishing a structured workspace with change manifests ensures that goals, evaluations, and outcomes are tracked and can be replicated across environments.