MoonshotAI / MoonshotAI/kimi-code

Wayfinder: Restructure monorepo per repository organization conventions

Open
#2,517 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
7.5k
Forks
1.2k
Avg merge
11h 53m
Merged PRs (30d)
350

Description

Destination

Restructure the monorepo to follow the repository organization conventions from the wayfinder skill content — top-level layout, Diátaxis documentation structure, agent skills format, packaging conventions, and cleanup strategy.

Notes

Domain: TypeScript monorepo for Kimi Code CLI. Skills to consult: repository-organization (the skill content provided), domain-modeling, grilling. Standing preferences: follow conventions exactly, use git mv for moves, archive superseded docs, ignore generated artifacts.

Decisions so far

  • Inventory current repository structure — Complete. 6,948 files categorized: 1,682 source, 417 docs, 2,341 tests, 321 build outputs (18.6 GB), 187 dev files. Key finding: massive build output in apps/*/dist directories.
  • Monorepo package structure conventions — Complete. 17 packages audited: 15 compliant with src/tests/README pattern, 2 exceptions (kimi-code, vis) need restructuring.

Not yet specified

  • Top-level directory layout alignment (src/, docs/, tests/, assets/, scripts/, dist/, scratch/) — #2518
  • Root directory cleanup (tool-mandated + community health files only) — #2519
  • Source files organization (what ships vs what doesn't) — #2530
  • Documentation restructure to Diátaxis quadrants (tutorials/, how-to/, reference/, explanation/) — #2520
  • Tests and evidence organization — #2521
  • Assets classification (shipped vs project assets) — #2522
  • Workspace layout: ignored directories (dist/, build/, node_modules/, scratch/) — #2523
  • Cleanup strategy implementation — #2524
  • Packaging conventions (build from src/, stage, validate, package) — #2525
  • Agent skills portable bundle format compliance — #2526
  • Publication preparation checklist — #2527
  • Decide target tree on paper before moving anything — #2531

Out of scope

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the repository-organization skill content and the completed inventory in issue #2528 and package audit in #2529. Resolve the target tree on paper in issue #2531 before coordinating the remaining layout, documentation, tests, packaging, skills, and cleanup issues; done means the monorepo follows the agreed conventions without moving generated artifacts.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
build-system, documentation, tooling
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.