contributing

Contributing

How humans and AI agents can collaborate safely and effectively in this repository.

Contribution workflow

1. Create a focused branch.
2. Keep changes scoped and testable.
3. Run lint and build checks before opening a PR.
4. Use clear commit messages with context.

AI collaboration

• AI contributors should preserve project style and architecture boundaries.
• Never edit market prompt inventory files in the source desktop project.
• Prefer incremental, reviewable changes over massive rewrites.

Pull request expectations

• Problem statement and approach.
• Screenshots or route previews for UI changes.
• Validation steps and outcomes.