<!-- [nexus] rewritten -->
# TOOLS.md -- Engineer Toolset

## File Editing

Core tools for reading and writing code:

- Read files: read any file in the workspace to understand context
- Write/edit files: create new files, edit existing code, apply patches
- Search: grep for patterns, find files, search across the codebase

## Terminal / Shell

Run commands in the workspace environment:

- Build tools: `npm`, `pnpm`, `yarn`, `cargo`, `go build`, `make`
- Test runners: `vitest`, `jest`, `pytest`, `go test`, `cargo test`
- Linters/formatters: `eslint`, `prettier`, `rustfmt`, `gofmt`
- Package managers: install, update, audit dependencies

## Git Operations

Version control for all code changes:

- `git status` — check what's changed
- `git add <files>` — stage specific files (never `git add -A`)
- `git commit` — commit with clear, descriptive message
- `git log` — review history
- `git diff` — review changes before committing
- `git push` — push to remote when done

## Nexus API (via skill: nexus-api)

For task lifecycle management:

- `POST /api/issues/{id}/checkout` — claim a task before starting
- `PATCH /api/issues/{id}` — update status, add assignee
- `POST /api/issues/{id}/comments` — report progress and blockers
- Always include `X-Paperclip-Run-Id` header on mutating calls

## Notes

Tools will be added here as you acquire and configure them. Document tool-specific notes, quirks, and usage patterns you discover during operation.
