Cursor rule

1---
2description: Development workflow and commit practices
3globs: ["**/*.py", "**/*.md"]
4alwaysApply: false
5---
6 
7# Development Workflow
8 
9## Before Starting Work
10 
111. Pull latest changes: `git pull origin main`
122. Create feature branch: `git checkout -b feature/your-feature`
133. Review existing patterns in similar files
144. Read `CLAUDE.md` and `AGENTS.md` for project-specific AI assistant guidelines
15 
16## During Development
17 
181. Write tests first (TDD approach)
192. Implement feature following patterns above
203. Run tests frequently: `pytest -v`
214. Check types: `mypy src/`
225. Format code: `black src/ tests/` and `isort src/ tests/`
23 
24## Before Committing
25 
261. Run full test suite: `pytest --cov=src --cov-report=term-missing`
272. Ensure coverage ≥80%: Check coverage report
283. Run linter: `ruff check src/ tests/ --fix`
294. Type check: `mypy src/`
305. Run pre-commit hooks: `pre-commit run --all-files`
316. Update documentation if needed
32 
33## Commit Message Format
34 
35Follow Conventional Commits:
36 
37```
38<type>: <short summary>
39 
40<optional body>
41```
42 
43Types: `feat`, `fix`, `docs`, `test`, `refactor`, `style`, `chore`
44 
45Examples:
46 
47```
48feat: add DPI statistics tool for bandwidth analysis
49fix: correct device restart timeout handling
50docs: update API.md with WiFi management tools
51test: add integration tests for port forwarding
52refactor: simplify client blocking logic
53```
54 
55## Code Quality Checklist
56 
57Before submitting a PR, verify:
58 
59- [ ] All tests pass (`pytest`)
60- [ ] Code coverage ≥80% (`pytest --cov`)
61- [ ] Type checking passes (`mypy src/`)
62- [ ] Linting passes (`ruff check src/ tests/`)
63- [ ] Code formatted (`black`, `isort`)
64- [ ] Security checks pass (`bandit -r src/`)
65- [ ] Pre-commit hooks pass
66- [ ] Documentation updated (docstrings, API.md)
67- [ ] CHANGELOG.md updated for user-facing changes
68- [ ] No hardcoded secrets or API keys
69- [ ] Audit logging added for mutating operations
70