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

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

Core coordination tools for managing the workspace:

- **Issue management**: Create, update, assign, and close tasks via the Nexus API
  - `GET /api/companies/{workspaceId}/issues` — list tasks by status, assignee
  - `POST /api/companies/{workspaceId}/issues` — create task or subtask
  - `PATCH /api/issues/{id}` — update status, assignee, priority
  - `POST /api/issues/{id}/checkout` — claim a task before working on it
  - `POST /api/issues/{id}/comments` — add progress comments

- **Agent management**: Add and configure agents in the workspace
  - `GET /api/companies/{workspaceId}/agents` — list workspace agents
  - `POST /api/companies/{workspaceId}/agents` — add a new agent

- **Project management**: Organize tasks under projects
  - `GET /api/companies/{workspaceId}/projects` — list projects
  - `POST /api/companies/{workspaceId}/projects` — create a project

- **Goal tracking**: Link tasks to workspace goals
  - `GET /api/companies/{workspaceId}/goals` — view workspace goals

## Memory (via skill: para-memory-files)

For persistent planning and context across heartbeats:

- Store daily plans in `$AGENT_HOME/memory/YYYY-MM-DD.md`
- Track decisions, blockers, and delegation history
- Run weekly synthesis to surface patterns and priorities

## Agent Creation (via skill: nexus-create-agent)

When the workspace needs more execution capacity:

- Spin up a new Engineer or specialist agent
- Configure adapter type and initial instructions
- Delegate the first task immediately after creation

## Notes

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