{
  "markdown": "# Asian Language Learning Platform\n\nSituational-fluency travel-language platform for English speakers visiting\nJapan, Thailand, Vietnam, Taiwan/China, and South Korea. Voice roleplay,\npronunciation scoring, spaced repetition, and an offline travel phrasebook,\nbuilt from a 1,000-micro-task engineering specification (10 tracks × 100\ntasks) spanning Kubernetes, a Python/FastAPI backend, TTS/STT audio\npipelines, an LLM roleplay engine, a Convex database, this Next.js\nfrontend, and (if/when built — see ADR 0001/0002) native Kotlin Android\nand Swift iOS apps.\n\nPublic repo, one exception: **Convex deployment data is not** — see\n`SECURITY.md`.\n\n## Repo layout\n\n```\nasian/\n  apps/\n    web/                  Next.js 16 app (App Router, Bun, Tailwind) — Track 9\n      e2e/                  Playwright E2E smoke tests, required CI check\n    android/              Kotlin + Compose scaffold — see ADR 0001, apps/android/README.md\n    ios/                   Swift 6.2 + XcodeGen scaffold — see ADR 0002, apps/ios/README.md\n  docs/\n    knowledge/            Wikillm-style knowledge base — START HERE\n      INDEX.md              map of content\n      PACKAGE-FORMAT.md     the note format every package follows\n      style-guide.md        documentation writing rules (ASD-STE100-derived)\n      ai-agent-docs-guide.md   writing rules for agent-consumed docs specifically\n      glossary.md            project/domain terms\n      adr/                   architecture decision records\n      tracks/                one page per engineering track (10)\n      modules/                one page per module/domain within a track\n    source-specs/          original spec doc + provenance/completeness notes\n  .github/\n    workflows/             CI (web: lint/typecheck/build/format/e2e; android: ktlint/lint/assemble; ios: build/test) + Dependabot auto-merge\n    ISSUE_TEMPLATE/, PULL_REQUEST_TEMPLATE.md, CODEOWNERS, dependabot.yml\n  netlify.toml             deploy config (base: apps/web)\n  turbo.json               task orchestration + caching across workspaces\n  bunfig.toml              hoisted linker — single node_modules at root\n  lefthook.yml             git hooks (pre-commit format/lint, commit-msg, pre-push check)\n  package.json             bun workspace root\n```\n\n## Getting started\n\n```bash\nbun install     # installs everything + wires up git hooks — that's the whole setup\nbun run dev     # apps/web on :3000\n```\n\nOne command in, dev server up. See `CONTRIBUTING.md` for the full command\nlist (`lint`, `typecheck`, `format`, `check`), how the git hooks work, and\nthe branching/PR workflow — `main` is protected, PRs required.\n\nRead `apps/web/AGENTS.md` before writing frontend code — Next.js 16 ships\nits own agent-facing warning that its APIs differ from what's in most\nmodels' training data, and points at `node_modules/next/dist/docs/`\n(hoisted to the repo root — see `bunfig.toml`) as the authoritative\nreference. Read `apps/android/README.md` / `apps/ios/README.md` before\ntouching either native scaffold — different toolchains (Gradle/JDK,\nXcode/XcodeGen), different constraints.\n\n## Docs and knowledge base\n\nEverything about _what to build_ — the actual 1,000-task specification —\nlives under `docs/knowledge/`, reorganized from the raw spec doc into\nsmall, linkable packages (one per module/domain, not one per task or one\ngiant file per track). Start at `docs/knowledge/INDEX.md`.\n\nThe source specification is **not fully complete** — see\n`docs/source-specs/README.md` for exactly which tracks have full task\ndetail (1–5), which are partial (6), and which are scope-only stubs (7–10).\n\nArchitecture decisions that aren't in the spec (like the Android/Kotlin\nchoice) live in `docs/knowledge/adr/`.\n\n## Deploy\n\nNetlify project `asian-language-platform` is linked from `apps/web`\n(`apps/web/.netlify/state.json`) — the repo-root `netlify.toml` points its\n`base` there, so run deploys from inside that directory:\n\n```bash\ncd apps/web\nbunx netlify-cli deploy --build          # preview deploy\nbunx netlify-cli deploy --build --prod   # production deploy\n```\n",
  "bytes": 4055,
  "sha": "73f8a09b4a7371b632477f6e2b4b3470285edd091059e09db3919cfc0a958cfb",
  "repo_slug": "4cecoder/asian",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_4cecoder_asian_docs_knowledge_index_md_71619999/readme"
}