Starter Issue Index

This is a snapshot of open issues that are useful for first-time contributors. Pick one focused issue, comment if you want to claim it, then follow the first PR walkthrough.

  • Repository: https://github.com/duct-tape2/ai-language-partner
  • Generated on: 2026-07-09
  • Open issues indexed: 52
  • Good first issues: 26
  • Help wanted issues: 16
  • First PR walkthrough: docs/community/FIRST_PR_WALKTHROUGH.md
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Contributor interest form: https://github.com/duct-tape2/ai-language-partner/issues/new?template=contributor_interest.yml

Only useful, reviewable PRs count toward the Claude for OSS community-builder evidence. Do not split trivial changes just to create more PRs.

Lane Summary

Lane Open issues Best for
Mobile/accessibility 11 Expo, React Native, labels, touch targets, layout
Backend/API docs 14 FastAPI, OpenAPI, local STT/TTS setup, provider docs
Tests/tooling 4 Python, TypeScript, CI, repo checks, fixtures
Dialogue/content review 11 Japanese naturalness, Korean learner notes, JLPT review
Release/community 7 Issue taxonomy, review process, roadmap, sprint coordination
Korean/Japanese docs 5 Setup docs, architecture notes, learner-facing explanation

Mobile/accessibility

Expo, React Native, labels, touch targets, layout.

Issue Labels
#13: mobile: audit touch target sizes in bottom tabs good first issue, accessibility, mobile, up-for-grabs
#14: mobile: add accessibility labels to voice preview controls accessibility, mobile
#15: mobile: improve empty state copy for Daily Talk pack loading good first issue, mobile, up-for-grabs, first-timers-only
#16: mobile: document mock mode indicators good first issue, docs, mobile, up-for-grabs, first-timers-only
#17: mobile: add regression check for duplicate screen labels help wanted, mobile, tests
#18: mobile: review Korean UI strings for consistency good first issue, language-review, mobile, up-for-grabs, first-timers-only
#27: tests: add mobile package script inventory check mobile, tests
#33: mobile: plan Expo SDK upgrade for transitive security advisories help wanted, mobile, security
#38: mobile: add accessibility label audit for Daily Talk controls help wanted, accessibility, mobile
#39: mobile: improve small-screen layout for Voice Gallery cards accessibility, mobile
#48: mobile: add regression guard for missing accessibility labels accessibility, mobile, tests

Backend/API docs

FastAPI, OpenAPI, local STT/TTS setup, provider docs.

Issue Labels
#3: docs: clarify local whisper.cpp setup on macOS help wanted, docs, stt, up-for-grabs
#4: docs: clarify AivisSpeech and VOICEVOX-compatible setup help wanted, docs, tts, up-for-grabs
#6: docs: add API curl examples for Daily Talk endpoints help wanted, docs, backend, up-for-grabs
#19: backend: add provider-status example response to docs good first issue, docs, backend, up-for-grabs, first-timers-only
#20: backend: add dialogue match threshold explanation docs, backend, up-for-grabs
#21: backend: add tests for malformed dialogue pack metadata help wanted, backend, tests
#22: backend: add tests for path traversal rejection on pack zip route good first issue, backend, tests, up-for-grabs
#23: backend: document Redis rate-limit optional setup docs, backend, up-for-grabs
#24: backend: add OpenAPI examples for auth device trust docs, backend, up-for-grabs
#28: tests: add pack source schema check help wanted, backend, tests
#34: docs: add Korean troubleshooting notes for backend dependency install good first issue, docs, backend, up-for-grabs, first-timers-only
#40: backend: add OpenAPI example for dialogue pack listing good first issue, docs, backend, up-for-grabs, first-timers-only
#41: backend: document provider fallback labels docs, backend, up-for-grabs
#49: backend: add malformed multipart upload test for STT endpoint backend, tests

Tests/tooling

Python, TypeScript, CI, repo checks, fixtures.

Issue Labels
#25: tests: add public tree forbidden-file scan good first issue, tests, up-for-grabs, first-timers-only
#26: tests: add README command smoke script docs, tests
#42: tests: add script check that issue seed count stays above 30 good first issue, tests, community, up-for-grabs, first-timers-only
#43: tests: add contributor evidence script fixture test tests, community

Dialogue/content review

Japanese naturalness, Korean learner notes, JLPT review.

Issue Labels
#7: content: review yui v1 beginner dialogue Korean translations good first issue, content, language-review, up-for-grabs, first-timers-only
#8: content: review yui v1 Japanese naturalness help wanted, good first issue, content, language-review, up-for-grabs, first-timers-only
#9: content: review haruka v1 polite-tone consistency content, language-review
#10: content: review ren v1 casual-tone consistency content, language-review
#11: content: add notes for Korean learners on particle mistakes good first issue, docs, content, up-for-grabs, first-timers-only
#12: content: add beginner-safe cultural note review checklist good first issue, docs, content, up-for-grabs, first-timers-only
#35: docs: add Japanese explanation of the no-runtime-LLM design help wanted, good first issue, docs, language-review, up-for-grabs, first-timers-only
#36: content: add beginner examples for giving restaurant preferences good first issue, content, language-review, up-for-grabs, first-timers-only
#37: content: review honorific consistency in onboarding examples content, language-review
#46: content: add Korean notes for Japanese sentence-final particles good first issue, content, language-review, up-for-grabs, first-timers-only
#47: content: add cultural-safety review examples good first issue, docs, content, up-for-grabs, first-timers-only

Release/community

Issue taxonomy, review process, roadmap, sprint coordination.

Issue Labels
#29: chore: add issue-label taxonomy document good first issue, docs, community, up-for-grabs, first-timers-only
#30: chore: add release checklist for generated voice assets docs, release
#44: docs: improve first PR walkthrough good first issue, docs, community, up-for-grabs, first-timers-only
#45: docs: add maintainer review checklist good first issue, docs, community, up-for-grabs, first-timers-only
#50: docs: add public roadmap for dialogue-bank packs help wanted, good first issue, docs, community, up-for-grabs, first-timers-only
#52: community: 20 contributor sprint kickoff help wanted, community
#54: release: publish installable web demo path help wanted, docs, release, up-for-grabs

Korean/Japanese docs

Setup docs, architecture notes, learner-facing explanation.

Issue Labels
#1: docs: add Korean quick-start for backend mock mode help wanted, good first issue, docs, up-for-grabs, first-timers-only
#2: docs: add Japanese quick-start for mobile mock mode help wanted, good first issue, docs, up-for-grabs, first-timers-only
#5: docs: add architecture glossary for dialogue-bank terms good first issue, docs, up-for-grabs, first-timers-only
#31: docs: add FAQ about why no runtime LLM is used good first issue, docs, up-for-grabs, first-timers-only
#32: docs: add comparison table for dialogue bank versus chatbot tutor help wanted, docs