5918074752
- 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.
28 lines
1.0 KiB
Markdown
28 lines
1.0 KiB
Markdown
# 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.
|