# AGENTS.md

Guidelines for contributing to indieweb-rust.

## Version Bumping

- **Cargo.lock updates** are maintenance releases (no version bump required for library crates)
- **Example crates** should be bumped to `1.0.0` when feature-complete
- **Library bumps** follow [SemVer](https://semver.org):
  - Major: breaking API changes
  - Minor: new features, backwards-compatible
  - Patch: bug fixes, dependency updates

## Code Style

### Debug Output
- Remove `println!("Debug: ...")` statements before committing
- Use `tracing::debug!` for debug logging in library code
- Use `tracing::trace!` for verbose operational logs

### Error Handling
The project uses:
- **thiserror** for library error types (`indieweb` crate)
- **miette** for application/user-facing diagnostics (examples, CLI)
