diff --git a/README.md b/README.md
index dc96839e..ccb216df 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,82 @@
-# VCV Community repository
+# VCV community repository
 
+The VCV community members are responsible for curating Rack plugins into a centralized database.
+[Anyone is welcome to join.](https://github.com/VCVRack/community/issues/248)
 
-## Package team
+All Rack plugins are welcome assuming they
+- are not malware (i.e. harm your computer or your privacy)
+- do not misuse intellectual property (legally or morally).
 
-### Building repos
+
+## [Library team](https://github.com/VCVRack/community/issues/352)
+
+Tasks:
+- Keep plugin manifests correct and up-to-date.
+- Handle issues opened by plugin developers who want to add/update their plugin.
+- Seek new plugins/updates when developers don't notify us.
+
+#### Manifest example
+
+Filename should be `YourSlug.json`.
+
+```json
+{
+  "name": "Fundamental",
+  "license": "BSD 3-clause",
+  "author": "VCV",
+  "contactEmail": "contact@vcvrack.com",
+  "websiteUrl": "https://vcvrack.com/Fundamental.html",
+  "manualUrl": "https://vcvrack.com/Fundamental.html#manual",
+  "sourceUrl": "https://github.com/VCVRack/Fundamental",
+  "latestVersion": "0.6.0",
+  "status": ""
+}
+```
+
+#### Manifest properties
+
+All properties are optional.
+
+- **name**: Human-readable display name for your plugin. You can change this on a whim, unlike slugs.
+- **license**: The license type of your plugin. Use "proprietary" if all rights are reserved. If your license is in the [SPDX license list](https://spdx.org/licenses/), use its abbreviation in the "Identifier" column.
+- **author**: Your name, company, alias, or GitHub username.
+- **contactEmail**: Your email address for support inquiries.
+- **websiteUrl**: The homepage page of your plugin. Omit if redundant with the source URL.
+- **manualUrl**: The manual of your plugin. HTML, PDF, or GitHub readme/wiki are fine.
+- **sourceUrl**: The source code homepage. E.g. GitHub repo.
+- **donateUrl**: Link to donation page for users who wish to donate. E.g. PayPal URL.
+- **latestVersion**: Your plugin's latest version, using the guidelines at https://github.com/VCVRack/Rack/issues/266. Do not include the "v" prefix.
+- **productId**: ID for plugins sold through the VCV Store.
+- **status**: *TODO*
+
+
+## [Review team](https://github.com/VCVRack/community/issues/354)
+
+*TODO*
+
+
+## [Repair team](https://github.com/VCVRack/community/issues/269)
+
+Tasks:
+- Fix broken plugins, in particular caused by Rack API updates, by opening issues, sending PRs, or even forking and adopting plugins.
+
+
+## [Build team](https://github.com/VCVRack/community/issues/353)
+
+*TODO*
+
+#### Building repos
 
 Clone all repos with `git submodule update --init --recursive`
 
 Then build all repos with `RACK_DIR=<path to Rack directory> make dist_all`
 
-### Adding a repo
+#### Adding a repo
 
 The folder name should match the slug, even if it is not the repository name.
 Be sure to check out the correct branch.
 
-`git submodule add -b v0.6 https://github.com/VCVRack/Fundamental.git Fundamental`
+```
+cd repos
+git submodule add -b v0.6 https://github.com/VCVRack/Fundamental.git Fundamental
+```