agent-rules-sync: Instructions file for Claude Code

Agent Rules Sync - Project Context

Quick Facts

• Project: Agent Rules Sync - Synchronize rules across AI coding assistants
• Language: Python 3.8+
• Main File: agent_rules_sync.py (single-file module with daemon support)
• Tests: Located in tests/ directory (29 tests, all passing)
• Package: Published on PyPI - https://pypi.org/project/agent-rules-sync/

Release Workflow

1. Prepare Changes

• Make code changes and commit to git
• Run tests: /usr/bin/python3 -m pytest tests/ -v
• Ensure all tests pass before releasing

2. Version Bump

Update THREE files to bump version (e.g., from 1.2.2 to 1.2.3):

File 1: pyproject.toml (line 7)

version = "1.2.3"

File 2: CHANGELOG.md (add entry at top)

## [1.2.3] - 2026-02-07

### 🧪 Category Name
- Feature description 1
- Feature description 2

File 3: setup.py - NO CHANGE NEEDED

• It reads version from pyproject.toml automatically

Commit the version bump:

git add pyproject.toml CHANGELOG.md
git commit -m "chore: bump version to 1.2.3 with [description]"
git push origin main

3. Build Package

# Clean old builds
rm -rf dist/ build/ *.egg-info

# Build wheel and sdist using miniforge python
python3.10 -m build

Output: dist/agent_rules_sync-1.2.3.tar.gz and dist/agent_rules_sync-1.2.3-py3-none-any.whl

4. Publish to PyPI

# Upgrade twine if needed
python3.10 -m pip install --upgrade twine

# Upload to PyPI (uses ~/.pypirc credentials)
python3.10 -m twine upload dist/agent_rules_sync-1.2.3* --skip-existing

Verify at: https://pypi.org/project/agent-rules-sync/

5. Create GitHub Release

# Create and push git tag
git tag -a v1.2.3 -m "test: add daemon watch detection tests"
git push origin v1.2.3

# Create GitHub release (with auto-generated notes)
gh release create v1.2.3 --title "v1.2.3: Test Coverage Improvements" --notes "Release notes here"

Verify at: https://github.com/dhruv-anand-aintech/agent-rules-sync/releases