journal

Store cross-round hypotheses and outcomes in YAML frontmatter for meta-agent workflows.

415|49|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/Darwin-Agent/HarnessX --skill journal-darwin-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: journal
Source: https://github.com/Darwin-Agent/HarnessX/tree/main/harnessx/meta_harness/workspace/skills/journal
Command: npx skills add https://github.com/Darwin-Agent/HarnessX --skill journal-darwin-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cross-round memory for meta-agents is hard to maintain across evolutions. This Skill provides a structured journal that records what has been tried, what landed, and what got reverted to guide future rounds.

Core Features & Use Cases

  • Cross-round memory: stores per-round hypotheses, outcomes, and gating decisions in a machine-parseable format.
  • Context propagation: exposes an indexed CONTEXT.md with summarized context for quick recall.
  • Audit and learning: supports identifying failing hypotheses and avoiding repeated mistakes across rounds.

Quick Start

Append one new Round section with frontmatter and prose after each evolution to update the memory.

Frequently Asked Questions about journal

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

FAQPage Schema
How do I maintain cross-round memory for meta-agent workflows?

Cross-round memory for meta-agent workflows is maintained by storing per-round hypotheses, outcomes, and gating decisions in a structured journal. This records what was tried, what landed, and what got reverted so future rounds can avoid repeating doomed hypotheses.

What format do I need to record experiment hypotheses and outcomes in a workflow journal?

Experiment hypotheses and outcomes require per-round YAML frontmatter containing round, timestamp, hypothesis_id, levers, gating_outcome, gating_attribution, and predicted_affected fields, followed by a free-form prose body detailing the results.

How do I summarize meta-agent context for quick recall between evolution rounds?

Meta-agent context is summarized for quick recall by exposing an indexed CONTEXT.md file. The orchestrator generates this file to provide quick context on previous rounds without parsing the entire journal history.

Can I use this journaling approach to stop agents from repeating failed hypotheses?

Yes, the journaling approach supports audit and learning by identifying failing hypotheses across rounds. Storing gating outcomes and attributions explicitly guides future rounds to avoid repeating doomed hypotheses.

How do I update the workflow journal after each meta-agent evolution?

To update the workflow journal after each evolution, append one new round section containing the required YAML frontmatter and prose body. This continuous appending builds the cross-round memory needed to guide future agents.

What are the limitations of using YAML frontmatter for workflow orchestration memory?

Using YAML frontmatter for workflow orchestration memory requires strict adherence to specific fields like gating_outcome and hypothesis_id. Missing or malformed frontmatter disrupts machine-parseability and prevents the orchestrator from exposing valid CONTEXT.md summaries.