diff --git a/readme.md b/readme.md
index 72b07ed38b..4c556b1562 100644
--- a/readme.md
+++ b/readme.md
@@ -35,17 +35,19 @@ For usage information please refer to the [State Tool Documentation](http://docs
 
 ### Building & Testing
 
-First run `state run install-deps` followed by `state run preprocess` if you are building for the first time.
+First run `state run install-deps-dev` followed by `state run preprocess` if you are building for the first time.
 
 * **Building:** `state run build`
   * The built executable will be stored in the `build` directory
   * If you modified assets or switched branches, you need to re-run `state run preprocess` first
 * **Testing:**
   * **Unit tests\*:** `state run test`
-  * **Integration tests:** `state run integration-tests`
+  * **Integration tests\*\*:** `state run build-svc && state run build-exec && state run integration-tests`
 
 <sup>
 * Our unit tests are in a state of slowly being converted to standalone
  integration tests, meaning that while we refer to them as unit tests
  they still contain a lot of tests that are better described as integration tests.
+ 
+** Our integration tests rely on the secrets feature, which is (as of writing) not ready for production use. You must enable it with `state config set optin.unstable true` and authenticate with `state auth --prompt`.
 </sup>