Thank you for helping improve an AuDHD-aware learning tool. The full contributor guide lives in the documentation: docs/contributing.md (published at docs/contributing.md). It covers the development environment, repository layout, how changes are made and tested, CI, documentation standards, the changelog, pull requests, issues, prioritisation, AI usage and models through a LiteLLM gateway, and security.
The short version:
git clone https://github.com/NetDevAutomate/StudyLoop.git studyloop
cd studyloop
uv sync --all-packages --all-extras
uv run playwright install chromium
uv run pre-commit install
just preflight- Branch from
mainwith afeat/,fix/,docs/ortest/prefix; neverlane/. - Tests first; docs and changelog in the same change;
just preflightgreen before you push. - Never include credentials, session transcripts, personal hostnames or unredacted local configuration in issues, fixtures, screenshots or logs.
- Conduct: CODE_OF_CONDUCT.md (Contributor Covenant 2.1).
- Security concerns go through GitHub's private advisory form, never a public issue.
StudyLoop is a 0.1.x pre-release with five first-party mentor harnesses (Kiro CLI, Codex and Claude Code are core; OpenCode and pi are preview). Proposals for another harness start with an issue, not a pull request.