---
title: "Pull Request Guide"
description: "How to submit changes to Nexus OS. 1. Fork the repository on GitHub 2. Create a branch from master 3. Make changes with clear, focused commits 4. Run tests locally ( cargo test ) 5. Submit PR with a clear description Fol"
resource: https://www.aiagents.nexus/docs/manual/contributing/pull-requests
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Pull Request Guide

How to submit changes to Nexus OS.

## PR Workflow

1. **Fork** the repository on GitHub
2. **Create a branch** from `master`
3. **Make changes** with clear, focused commits
4. **Run tests** locally (`cargo test`)
5. **Submit PR** with a clear description

## Commit Messages

Follow conventional commits:

```
feat: add broker routing engine
fix: correct saga compensation order
docs: update CLI reference
test: add supervisor restart tests
refactor: simplify store migration
```

## PR Template

```markdown
## What
[Brief description of the change]

## Why
[Motivation and context]

## How
[Implementation approach]

## Testing
- [ ] Unit tests added/updated
- [ ] Integration tests pass
- [ ] Manual testing completed

## Checklist
- [ ] cargo fmt
- [ ] cargo clippy (no warnings)
- [ ] cargo test (all pass)
- [ ] Documentation updated
```

## Review Process

- PRs require at least one approval
- CI must pass (build + tests + clippy)
- Squash merge into master
- Delete branch after merge