chore: prepare repository for public release

.claude-plugin/plugin.json

@@ -5,6 +5,18 @@
   "author": {
     "name": "Very Good Ventures",
     "url": "https://verygood.ventures",
-    "email": "hello@verygood.ventures"
-  }
+    "email": "tools@verygood.ventures"
+  },
+  "homepage": "https://github.com/VeryGoodOpenSource/vgv-ffca-plugin",
+  "repository": "https://github.com/VeryGoodOpenSource/vgv-ffca-plugin",
+  "keywords": [
+    "flutter",
+    "dart",
+    "clean architecture",
+    "feature-first",
+    "monorepo",
+    "architecture",
+    "layer validation",
+    "ai assisted engineering"
+  ]
 }

.github/workflows/ci.yaml

@@ -0,0 +1,68 @@
+name: ci
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  markdown:
+    name: 📝 Markdown Quality
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Lint Markdown
+        uses: DavidAnson/markdownlint-cli2-action@v24.2.0
+        with:
+          globs: |
+            **/*.md
+            !CHANGELOG.md
+            !references/ffca_architecture.md
+          config: 'config/custom.markdownlint.jsonc'
+
+  spelling:
+    name: ✍️ Spelling Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Spell Check
+        uses: streetsidesoftware/cspell-action@v9
+        with:
+          files: |
+            **/*.md
+            !CHANGELOG.md
+          config: 'config/cspell.json'
+
+  validator:
+    name: 🧪 Layer Validator
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: scripts
+    steps:
+      - uses: actions/checkout@v7
+      - uses: dart-lang/setup-dart@v1
+      - name: Install dependencies
+        run: dart pub get
+      - name: Analyze
+        run: dart analyze --fatal-infos
+      - name: Format
+        run: dart format --output=none --set-exit-if-changed .
+      - name: Test
+        run: dart test
+
+  skills-lint:
+    name: 🔍 Skills Lint
+    uses: VeryGoodOpenSource/very_good_workflows/.github/workflows/skills_lint.yml@v1.21.1
+    with:
+      skills_directories: 'skills'
+
+  plugin-validate:
+    name: 📦 Plugin Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install Claude Code
+        run: npm install -g @anthropic-ai/claude-code
+      - name: Validate Plugin
+        run: claude plugin validate .

.github/workflows/release_please.yaml

@@ -0,0 +1,22 @@
+name: release_please
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+jobs:
+  create_release_pr:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: googleapis/release-please-action@v5
+        with:
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          manifest-file: ".release-please-manifest.json"
+          config-file: ".release-please-config.json"

.release-please-config.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "bump-minor-pre-major": true,
+  "bump-patch-for-minor-pre-major": true,
+  "changelog-sections": [
+    { "type": "feat", "section": "Features" },
+    { "type": "fix", "section": "Bug Fixes" },
+    { "type": "refactor", "section": "Refactors" },
+    { "type": "chore", "section": "Miscellaneous Chores" },
+    { "type": "docs", "section": "Docs" }
+  ],
+  "pull-request-header": ":rotating_light: There are changes ready for release :rocket:\n\nℹ Merge this PR once the team confirms the release is ready.\n",
+  "pull-request-title-pattern": "chore: ${version}",
+  "extra-label": "no-auto-update",
+  "include-component-in-tag": false,
+  "packages": {
+    ".": {
+      "release-type": "simple",
+      "changelog-path": "CHANGELOG.md",
+      "extra-files": [
+        {
+          "type": "json",
+          "path": ".claude-plugin/plugin.json",
+          "jsonpath": "$.version"
+        }
+      ]
+    }
+  },
+  "exclude-paths": [
+    ".github",
+    ".release-please-manifest.json",
+    ".release-please-config.json"
+  ]
+}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+### Features
+
+- FFCA skills: architecture, feature, routing, cross-feature, and audit
+- Blocking `pubspec.yaml` layer-dependency validation hook
+- `ffca-layer-auditor` agent for whole-repo architecture audits
+- Very Good CLI MCP server configuration

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Very Good Ventures
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -37,22 +37,13 @@ The `ffca-architecture` skill defers to `layered-architecture` when it sees the
 
 ## Installation
 
-The plugin is currently a private repository in the VeryGoodOpenSource organization. Anyone with git access (via `gh auth`) can install it as a Claude Code marketplace.
-
-For the platform team pilot, add the repository as a marketplace and install:
-
-```bash
-claude plugin marketplace add VeryGoodOpenSource/vgv-ffca-plugin && claude plugin install vgv-ffca-plugin
-```
-
-For local iteration, install from a checkout path:
+The plugin is published in the [Very Good Claude Marketplace](https://github.com/VeryGoodOpenSource/very-good-claude-code-marketplace). Inside Claude:
 
 ```bash
-claude plugin marketplace add /path/to/vgv-ffca-plugin && claude plugin install vgv-ffca-plugin
+/plugin marketplace add VeryGoodOpenSource/very-good-claude-code-marketplace
+/plugin install vgv-ffca-plugin
 ```
 
-At v1.0 the repository goes public and registers in the `very_good_claude_marketplace` for one-line public install.
-
 ## Skills
 
 | Skill | Description |

config/cspell.json

@@ -0,0 +1,18 @@
+{
+  "language": "en",
+  "words": [
+    "dtos",
+    "ffca",
+    "mappr",
+    "mocktail",
+    "operationalizes",
+    "posthog",
+    "pubspec",
+    "pubspecs",
+    "rebuildable",
+    "riverpod",
+    "subcomponents",
+    "subfeature"
+  ],
+  "flagWords": []
+}

config/custom.markdownlint.jsonc

@@ -0,0 +1,8 @@
+{
+  "MD009": false,
+  "MD013": false,
+  "MD032": false,
+  "MD033": false,
+  "MD036": false,
+  "MD060": false
+}