First PR Recipes

These recipes are generated from open good first issue items. They are also posted as issue comments so first-time contributors can start without searching the whole repository.

  • Repository: https://github.com/duct-tape2/ai-language-partner
  • Generated on: 2026-07-10
  • Issues covered: 26

#1: docs: add Korean quick-start for backend mock mode

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ko/index.md
  • apps/api/README.md
  • README.md

Acceptance signal

Acceptance: backend setup works without STT/TTS engines; Korean instructions

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/api && .venv/bin/python -m pytest

PR body checklist

  • Link this issue: Closes #1 or Refs #1
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#2: docs: add Japanese quick-start for mobile mock mode

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ja/index.md
  • apps/mobile/README.md
  • README.md

Acceptance signal

Acceptance: mobile setup covers npm install, Expo web, and mock API defaults.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify

PR body checklist

  • Link this issue: Closes #2 or Refs #2
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#5: docs: add architecture glossary for dialogue-bank terms

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ARCHITECTURE.md
  • README.md

Acceptance signal

Acceptance: defines persona, pack, node, lineId, variants, match, confirm,

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual docs review: verify links and wording

PR body checklist

  • Link this issue: Closes #5 or Refs #5
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#7: content: review yui v1 beginner dialogue Korean translations

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • packs/yui/v1/story.json
  • packs/yui/v1/variants.csv

Acceptance signal

Acceptance: PR fixes unnatural Korean explanations without changing line IDs.

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #7 or Refs #7
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#8: content: review yui v1 Japanese naturalness

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • packs/yui/v1/story.json
  • packs/yui/v1/variants.csv

Acceptance signal

Acceptance: PR improves Japanese dialogue while preserving beginner level.

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #8 or Refs #8
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#11: content: add notes for Korean learners on particle mistakes

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ko/index.md
  • apps/mobile/src/grammar/grammarData.ts
  • apps/mobile/src/mistakes/mistakesData.ts

Acceptance signal

Acceptance: adds concise examples for は/が, を/に, and で/に.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #11 or Refs #11
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#12: content: add beginner-safe cultural note review checklist

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/community/CONTRIBUTOR_LANDING.md
  • apps/mobile/src/culture/cultureNotes.ts

Acceptance signal

Acceptance: checklist avoids stereotypes and flags context-sensitive terms.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #12 or Refs #12
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#13: mobile: audit touch target sizes in bottom tabs

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/mobile/App.tsx
  • apps/mobile/scripts/verify-frontend-regressions.mjs

Acceptance signal

  • Each of the five bottom tabs has a stable target height of at least 48 logical pixels.
  • Labels and icons remain centered and do not overlap at narrow mobile width.
  • Existing accessibility metadata remains intact.
  • cd apps/mobile && npm run verify passes.
  • python3 scripts/check_public_tree.py passes.
  • The PR body includes Closes #13 and briefly explains the accessibility benefit.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify

PR body checklist

  • Link this issue: Closes #13 or Refs #13
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#15: mobile: improve empty state copy for Daily Talk pack loading

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/mobile/src/screens/DailyTalkScreen.tsx
  • apps/mobile/src/dialogue/packManager.ts

Acceptance signal

Acceptance: no technical jargon; tells learner what to do next.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify

PR body checklist

  • Link this issue: Closes #15 or Refs #15
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#16: mobile: document mock mode indicators

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ARCHITECTURE.md
  • docs/ja/index.md
  • docs/ko/index.md

Acceptance signal

Acceptance: explains when UI is fixture-backed versus live API-backed.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify

PR body checklist

  • Link this issue: Closes #16 or Refs #16
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#18: mobile: review Korean UI strings for consistency

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/mobile/src/i18n.ts
  • apps/mobile/src/text.ts
  • apps/mobile/src/screens/

Acceptance signal

Acceptance: consistent honorifics and app terminology.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #18 or Refs #18
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#19: backend: add provider-status example response to docs

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/api/README.md
  • docs/backend/API_RUNBOOK.md
  • contracts/openapi_v0.yaml

Acceptance signal

Acceptance: includes mock, fallback, and local engine examples.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/api && .venv/bin/python -m pytest

PR body checklist

  • Link this issue: Closes #19 or Refs #19
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#22: backend: add tests for path traversal rejection on pack zip route

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/api/tests/test_api_contract.py
  • apps/api/app/main.py

Acceptance signal

Acceptance: .. and slash injection return 400/404 safely.

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/api && .venv/bin/python -m pytest
  • python3 -m unittest discover -s scripts -p 'test_*.py'

PR body checklist

  • Link this issue: Closes #22 or Refs #22
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#25: tests: add public tree forbidden-file scan

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • scripts/check_public_tree.py
  • scripts/test_claude_for_oss_evidence.py

Acceptance signal

Acceptance: CI fails if generated engines, databases, zip, wav, or npy files

Suggested checks

  • python3 scripts/check_public_tree.py
  • python3 -m unittest discover -s scripts -p 'test_*.py'

PR body checklist

  • Link this issue: Closes #25 or Refs #25
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#29: chore: add issue-label taxonomy document

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/community/LABELS.md
  • docs/community/ISSUE_SEEDS.md

Acceptance signal

Acceptance: documents labels and when maintainers apply them.

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual docs review: verify links and wording

PR body checklist

  • Link this issue: Closes #29 or Refs #29
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#31: docs: add FAQ about why no runtime LLM is used

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • README.md
  • docs/ARCHITECTURE.md
  • docs/index.md

Acceptance signal

Acceptance: explains cost, latency, privacy, and quality-control tradeoffs.

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual docs review: verify links and wording

PR body checklist

  • Link this issue: Closes #31 or Refs #31
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#34: docs: add Korean troubleshooting notes for backend dependency install

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/api/README.md
  • contracts/openapi_v0.yaml
  • apps/api/tests/test_api_contract.py

Acceptance signal

Acceptance: covers common Python venv, pip, and macOS command-line tools

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/api && .venv/bin/python -m pytest

PR body checklist

  • Link this issue: Closes #34 or Refs #34
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#35: docs: add Japanese explanation of the no-runtime-LLM design

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ja/index.md
  • docs/index.md
  • docs/ARCHITECTURE.md

Acceptance signal

Acceptance: Japanese text explains cost, privacy, latency, and quality

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #35 or Refs #35
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#36: content: add beginner examples for giving restaurant preferences

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • packs/yui/v1/story.json
  • packs/haruka/v1/story.json
  • authoring/scenarios/

Acceptance signal

Acceptance: adds beginner-safe Japanese examples with Korean notes and does

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #36 or Refs #36
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#40: backend: add OpenAPI example for dialogue pack listing

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • contracts/openapi_v0.yaml
  • contracts/README_API_CONTRACT.md
  • apps/api/tests/test_api_contract.py

Acceptance signal

Acceptance: contracts/openapi_v0.yaml includes a realistic response

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/api && .venv/bin/python -m pytest

PR body checklist

  • Link this issue: Closes #40 or Refs #40
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#42: tests: add script check that issue seed count stays above 30

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • scripts/
  • apps/api/tests/test_api_contract.py

Acceptance signal

Acceptance: CI or a repo script fails if docs/community/ISSUE_SEEDS.md

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/api && .venv/bin/python -m pytest
  • python3 -m unittest discover -s scripts -p 'test_*.py'

PR body checklist

  • Link this issue: Closes #42 or Refs #42
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#44: docs: improve first PR walkthrough

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/community/FIRST_PR_WALKTHROUGH.md
  • docs/ko/index.md
  • docs/ja/index.md

Acceptance signal

Acceptance: improves docs/community/FIRST_PR_WALKTHROUGH.md with clearer

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual docs review: verify links and wording

PR body checklist

  • Link this issue: Closes #44 or Refs #44
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#45: docs: add maintainer review checklist

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/community/MAINTAINER_PR_REVIEW_RUNBOOK.md

Acceptance signal

Acceptance: summarizes useful-review requirements before merging counted

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual docs review: verify links and wording

PR body checklist

  • Link this issue: Closes #45 or Refs #45
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#46: content: add Korean notes for Japanese sentence-final particles

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/ko/index.md
  • apps/mobile/src/grammar/grammarData.ts
  • apps/mobile/src/mistakes/mistakesData.ts

Acceptance signal

Acceptance: covers よ, ね, よね, かな at a beginner-safe level with Korean

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #46 or Refs #46
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#47: content: add cultural-safety review examples

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • apps/mobile/src/culture/cultureNotes.ts
  • docs/community/CONTRIBUTOR_LANDING.md

Acceptance signal

Acceptance: includes examples of stereotypes to avoid and context-sensitive

Suggested checks

  • python3 scripts/check_public_tree.py
  • cd apps/mobile && npm run verify
  • manual language/content review: explain what wording you checked

PR body checklist

  • Link this issue: Closes #47 or Refs #47
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html

#50: docs: add public roadmap for dialogue-bank packs

First PR recipe

Thanks for considering this issue. A small useful PR is enough; please keep the change focused and avoid generated/private assets.

Likely files to inspect

  • docs/community/CONTRIBUTOR_GROWTH_PLAN.md
  • docs/community/CONTRIBUTOR_SPRINT.md

Acceptance signal

Acceptance: lists planned persona/topic/JLPT pack areas and names which

Suggested checks

  • python3 scripts/check_public_tree.py
  • manual docs review: verify links and wording

PR body checklist

  • Link this issue: Closes #50 or Refs #50
  • Explain what changed and why it helps learners or contributors
  • Say which check you ran, or say that it was docs/content review only
  • Do not commit generated audio, archives, local engines, SQLite files, secrets, screenshots, or private notes

Useful links:

  • Contributor page: https://duct-tape2.github.io/ai-language-partner/
  • Directory first PR fast lane: https://duct-tape2.github.io/ai-language-partner/community/DIRECTORY_FIRST_PR.html
  • First issue matcher: https://duct-tape2.github.io/ai-language-partner/community/FIRST_ISSUE_MATCHER.html
  • Five-minute first PR: https://duct-tape2.github.io/ai-language-partner/community/FIVE_MINUTE_FIRST_PR.html
  • Codespaces first PR guide: https://duct-tape2.github.io/ai-language-partner/community/CODESPACES_FIRST_PR.html
  • No-install first PR board: https://duct-tape2.github.io/ai-language-partner/community/NO_INSTALL_FIRST_PRS.html
  • Language review first PR kit: https://duct-tape2.github.io/ai-language-partner/community/LANGUAGE_REVIEW_FIRST_PR_KIT.html
  • First PR walkthrough: https://duct-tape2.github.io/ai-language-partner/community/FIRST_PR_WALKTHROUGH.html
  • First PR help desk: https://github.com/duct-tape2/ai-language-partner/discussions/53
  • Counting policy: https://duct-tape2.github.io/ai-language-partner/community/PR_REVIEW_AND_COUNTING_POLICY.html