Skip to content

WORKFLOW_AUTO.md referenced by Post-Compaction Audit but never created or documented #20443

@0nepixel1

Description

@0nepixel1

Problem

After context compaction, agents receive this system message:

⚠️ Post-Compaction Audit: The following required startup files were not read after context reset:

  • WORKFLOW_AUTO.md
  • memory/\d{4}-\d{2}-\d{2}.md

Please read them now using the Read tool before continuing. This ensures your operating protocols are restored after memory compaction.

WORKFLOW_AUTO.md is hardcoded in src/auto-reply/reply/post-compaction-audit.ts as part of DEFAULT_REQUIRED_READS, but:

  1. Never auto-generated — not created by openclaw setup, openclaw onboard, or any bootstrap process
  2. Not documented — not mentioned in docs/concepts/agent-workspace.md or any other docs
  3. No config override — hardcoded with a comment // extensible to config later that was never implemented
  4. No template — no guidance on what the file should contain

Impact

Every compaction triggers a warning for a file that doesn't exist. The agent either gets a read error or wastes a tool call on nothing. This happens on every agent workspace out of the box.

Suggested fix

Either:

  • A) Add WORKFLOW_AUTO.md to the bootstrap file set with a sensible default template (like other workspace files)
  • B) Make DEFAULT_REQUIRED_READS configurable and remove WORKFLOW_AUTO.md from the hardcoded default
  • C) Document the file in agent-workspace.md so users know to create it manually

Ideally A + B.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions