From 138cb83ab1be5ab85a3dc51567f41a580b338742 Mon Sep 17 00:00:00 2001
From: Dominik Simonik <dominik.simonik@verygood.ventures>
Date: Tue, 29 Sep 2026 08:42:44 +0200
Subject: [PATCH] docs: update installation instructions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 README.md | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 1e33db8..421110c 100644
--- a/README.md
+++ b/README.md
@@ -37,11 +37,36 @@ The `ffca-architecture` skill defers to `layered-architecture` when it sees the
 
 ## Installation
 
-The plugin is published in the [Very Good Claude Marketplace](https://github.com/VeryGoodOpenSource/very-good-claude-code-marketplace). Inside Claude:
+One-line install from your terminal:
 
 ```bash
-/plugin marketplace add VeryGoodOpenSource/very-good-claude-code-marketplace
-/plugin install vgv-ffca-plugin
+claude plugin marketplace add VeryGoodOpenSource/very-good-claude-code-marketplace && claude plugin install vgv-ffca-plugin
+```
+
+Or inside an active Claude Code session, run these as **two separate commands** (the second only after the first completes):
+
+1. Add the marketplace:
+
+   ```text
+   /plugin marketplace add VeryGoodOpenSource/very-good-claude-code-marketplace
+   ```
+
+2. Install the plugin:
+
+   ```text
+   /plugin install vgv-ffca-plugin
+   ```
+
+For more details, see the [Very Good Claude Marketplace](https://github.com/VeryGoodOpenSource/very-good-claude-code-marketplace).
+
+### Local development
+
+Load the plugin from a local checkout, validate it, and run the validator tests:
+
+```bash
+claude --plugin-dir .
+claude plugin validate .
+cd scripts && dart test
 ```
 
 ## Skills