docs: expand CONTRIBUTING.md

Author: Pro0f

CONTRIBUTING.md

@@ -1,50 +1,74 @@
 # Contributing to DevsContext
 
-Thanks for your interest in contributing!
-
 ## Development Setup
 
 ```bash
 git clone https://github.com/anthropics/devscontext.git
 cd devscontext
+python -m venv venv
+source venv/bin/activate
 pip install -e ".[dev]"
 ```
 
+Configure for local testing:
+```bash
+cp .devscontext.yaml.example .devscontext.yaml
+# Edit .devscontext.yaml with your Jira URL
+export JIRA_EMAIL="you@company.com"
+export JIRA_API_TOKEN="your-token"
+```
+
 ## Running Tests
 
+Unit tests (no API keys needed):
+```bash
+pytest tests/ --ignore=tests/test_integration.py
+```
+
+Integration tests (requires real API keys):
 ```bash
-pytest tests/
+pytest tests/test_integration.py
 ```
 
-## Code Style
+## Adding a New Adapter
+
+1. Create `src/devscontext/adapters/your_source.py`:
+   - Extend the `Adapter` base class
+   - Implement `fetch_context(task_id)` and `health_check()`
+   - Add any source-specific methods (e.g., `search()`)
+
+2. Add config model to `src/devscontext/config.py`
 
-We use ruff for linting and formatting:
+3. Wire into `src/devscontext/core.py`:
+   - Add adapter initialization
+   - Include in fetch/search flows
 
+4. Add tests in `tests/test_your_source.py`
+
+See `adapters/jira.py` as reference.
+
+## Code Quality
+
+Before submitting:
 ```bash
 ruff check .
 ruff format .
 mypy src/
+pytest tests/ --ignore=tests/test_integration.py
 ```
 
-## Pull Requests
-
-1. Fork the repo and create a branch from `main`
-2. Add tests for any new functionality
-3. Ensure tests pass and code is formatted
-4. Submit a PR with a clear description
+Requirements:
+- Type hints on all functions
+- Pydantic models for data structures
+- Tests for new functionality
 
-## Adding a New Adapter
-
-Adapters live in `src/devscontext/adapters/`. To add a new source:
-
-1. Create `adapters/your_source.py` extending `Adapter` base class
-2. Implement `fetch_context()`, `health_check()`, and any source-specific methods
-3. Add configuration model to `config.py`
-4. Wire into `DevsContextCore` in `core.py`
-5. Add tests in `tests/test_your_source.py`
+## Pull Requests
 
-See `adapters/jira.py` as a reference implementation.
+1. Fork and create a branch from `main`
+2. Make your changes with tests
+3. Ensure all checks pass
+4. Open a PR describing what and why
 
 ## Questions?
 
-Open an issue or start a discussion.
+Open an issue.