Skip to content

AGENTS.md contains machine-specific paths and internal-only guidance #347

@buddyh

Description

@buddyh

Summary

AGENTS.md includes hard-coded personal paths, internal host references, and instructions that aren't portable for external contributors or agents. It also references guardrails that aren't present in this repo.

Examples

  • References to application.com.steipete... and com.steipete...
  • Guardrails at ~/Projects/oracle/AGENTS.md and ~/Projects/agent-scripts/AGENTS.MD
  • Notary key path under ~/Library/CloudStorage/Dropbox/...
  • "Peter says ..." and "Mac Studio" instructions
  • PATH includes /Users/steipete/Library/pnpm

Impact

  • Non-portable guidance and private environment details in a public repo.
  • Confusing or broken instructions for contributors who aren't on the author's machine.

Proposed fix

  • Replace machine-specific identifiers with generic guidance.
  • Remove private key file paths; point to internal release docs instead.
  • Make guardrails references optional if present locally.
  • Add a troubleshooting note for Clawdis -> Clawdbot migration (clawdbot doctor).

Acceptance criteria

  • No hard-coded usernames, home directories, or personal device names.
  • No explicit private key file paths in AGENTS.md.
  • Guardrails references are optional or removed.
  • Include a brief troubleshooting note pointing to clawdbot doctor (docs at docs/gateway/doctor.md).

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