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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions