Skip to content

Commit bc80753

Browse files
committed
Docs: No new top-level folders without the maintainer's approval (#115)
1 parent b248b02 commit bc80753

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,16 @@ ask first.**
3131

3232
Writing to *another* repository is not an exception either. Do it only when told to work there.
3333

34+
### Do not add top-level folders
35+
36+
**Never add a new directory (or a new file) at the repository root on your own.** The root layout is
37+
the maintainer's: source modules, `docs/`, `gradle/`, `.github/` and the files that tools require
38+
there. Work belongs inside an existing module or directory — sources under `src/<sourceSet>/`,
39+
CI-only scripts under `.github/scripts/`, temporary files under the git-ignored `.tmp/`. If you think
40+
a new top-level entry is needed, propose it (what, why, which alternatives inside existing
41+
directories you ruled out) and wait for approval. This was added after unapproved root folders
42+
(`ksp-fixtures/`, `tools/`, `kotlin-js-store/`, `iosApp/`, `sample/python`) had to be dismantled.
43+
3444
## 3. Worktrees link large artefacts instead of copying them
3545

3646
A worktree is a full checkout. Copying large untracked artefacts (prebuilt runtimes, vendored trees,

0 commit comments

Comments
 (0)