Problem
CONTRIBUTING.md lists broad areas where help is welcome but does not:
- Link to GitHub issues labeled "good first issue"
- Explain the data flow architecture for newcomers
- Mention the architecture docs in
docs/phase1-architecture.md and docs/phase2-architecture.md
- Suggest a reading order for understanding the codebase
What to do
Add a "Start Here" section to CONTRIBUTING.md that includes:
- Architecture overview — brief description of the data flow:
```
Claude Code Hooks → FastAPI Collector → Delta Engine → Anomaly Detection → Notifications
```
- Recommended reading order for new contributors:
- `config.py` → `models.py` → `delta_engine.py` → `anomaly.py`
- Links to architecture docs: `docs/phase1-architecture.md`, `docs/phase2-architecture.md`
- Link to good first issues: `https://github.com/roeimichael/ContextAnalyzerTerminal/labels/good%20first%20issue\`
Why this is a good first issue
It's a documentation-only change — perfect for getting familiar with the project structure before diving into code.
Problem
CONTRIBUTING.md lists broad areas where help is welcome but does not:
docs/phase1-architecture.mdanddocs/phase2-architecture.mdWhat to do
Add a "Start Here" section to CONTRIBUTING.md that includes:
```
Claude Code Hooks → FastAPI Collector → Delta Engine → Anomaly Detection → Notifications
```
Why this is a good first issue
It's a documentation-only change — perfect for getting familiar with the project structure before diving into code.