diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4fc867e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# @bsu/wp-coding-standards
+
+PHP tool binaries for BSU WordPress development. Installed via npm, ships the following tools in `vendor/bin/`:
+
+| Binary | Version | Purpose |
+|---|---|---|
+| `phpcs` | 4.x | PHP CodeSniffer — enforces BSUWordPressCS coding standards |
+| `phpcbf` | 4.x | PHP Code Beautifier — auto-fixes PHPCS violations |
+| `phpstan` | 1.x | PHPStan — static analysis for type safety and correctness |
+
+## Usage in bsuwp
+
+These binaries are referenced directly by path in `bsuwp/package.json` scripts:
+
+```bash
+npm run lint:php        # phpcs via this package
+npm run fix:php         # phpcbf via this package
+npm run analyse:php     # phpstan via this package
+```
+
+## Updating
+
+To update tool versions, modify `composer.json` and run `composer update`, then commit the updated `composer.lock` and `vendor/` in a PR to `release`.
diff --git a/vendor/phpcsstandards/php_codesniffer/CodeSniffer.conf b/vendor/phpcsstandards/php_codesniffer/CodeSniffer.conf
new file mode 100644
index 0000000..1418d3c
--- /dev/null
+++ b/vendor/phpcsstandards/php_codesniffer/CodeSniffer.conf
@@ -0,0 +1,5 @@
+<?php
+ $phpCodeSnifferConfig = array (
+  'installed_paths' => '../../phpcsstandards/phpcsextra,../../phpcsstandards/phpcsutils,../../wp-coding-standards/wpcs,../../../../BSUWordPressCS',
+);
+?>
\ No newline at end of file