openclaw/docs/reference/tooling-policy.md
Yash Soni 5918074752 [AI-assisted] Docs: add missing documentation areas (Agent Roles, Tooling Policy, Ownership, Channel Guide)
- Created docs/reference/agent-roles.md, docs/reference/tooling-policy.md, docs/reference/ownership.md.
- Created docs/channels/adding-channels.md.
- Updated docs/reference/RELEASING.md and AGENTS.md.
- Degree of testing: documentation review.
- Confirmed understanding of codebase structure.
2026-01-27 14:14:49 +05:30

1.0 KiB

Tooling Policy

To ensure consistency and reliability, agents and contributors should follow this tooling policy.

Preferred Tools

1. Search & Exploration

  • Primary: ripgrep (via grep_search or CLI).
  • Directory Listing: fd or standard ls.
  • Outline: view_file_outline for quick structural understanding.

2. File Editing

  • Primary: multi_replace_file_content for non-contiguous edits.
  • Secondary: replace_file_content for single blocks.
  • New Files: write_to_file.

3. CI/CD & Build

  • Package Manager: pnpm.
  • Runtime: Node 22+ (Bun for local dev/testing).
  • Linter/Formatter: Oxlint / Oxfmt.

Agent Usage Guidelines

  • Conciseness: Keep edits minimal and focused. Avoid broad refactors unless requested.
  • Verification: Always run pnpm lint and pnpm build after making changes.
  • Safety: Do not use rm -rf or other destructive commands without high confidence and explicit need.
  • Communication: Use notify_user for blocking questions or artifact reviews.