feat: plugin modernization — adopt best patterns from ecosystem

.editorconfig

@@ -0,0 +1,27 @@
+# EditorConfig — consistent formatting across editors
+# https://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.rs]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml,json,toml}]
+indent_size = 2
+
+[*.sh]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

.github/workflows/ci.yml

@@ -5,12 +5,20 @@ on:
     branches: [main]
     paths:
       - "flowctl/**"
+      - "scripts/**"
+      - "skills/**/*.md"
+      - "agents/**/*.md"
       - ".github/workflows/ci.yml"
+      - ".markdownlint.json"
   pull_request:
     branches: [main]
     paths:
       - "flowctl/**"
+      - "scripts/**"
+      - "skills/**/*.md"
+      - "agents/**/*.md"
       - ".github/workflows/ci.yml"
+      - ".markdownlint.json"
 
 env:
   CARGO_TERM_COLOR: always
@@ -53,6 +61,66 @@ jobs:
       - name: Clippy
         run: cargo clippy --all-targets -- -D warnings
 
+  smoke-test:
+    name: Shell Smoke Tests
+    runs-on: ubuntu-latest
+    needs: [test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo registry & build
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            flowctl/target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('flowctl/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Build flowctl
+        run: cd flowctl && cargo build --release
+
+      - name: Run smoke tests
+        run: bash scripts/smoke_test.sh
+
+  security-audit:
+    name: Dependency Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install cargo-audit
+        run: cargo install cargo-audit --locked
+
+      - name: Run cargo audit
+        working-directory: flowctl
+        run: cargo audit
+
+  markdown-lint:
+    name: Markdown Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install markdownlint-cli2
+        run: npm install -g markdownlint-cli2
+
+      - name: Lint skill and agent markdown
+        run: markdownlint-cli2 "skills/**/*.md" "agents/**/*.md"
+
   coverage:
     name: Test Coverage
     runs-on: ubuntu-latest

.markdownlint.json

@@ -0,0 +1,15 @@
+{
+  "default": true,
+  "MD013": {
+    "line_length": 300,
+    "code_blocks": false,
+    "tables": false,
+    "headings": false
+  },
+  "MD024": {
+    "siblings_only": true
+  },
+  "MD033": false,
+  "MD041": false,
+  "MD046": false
+}

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [0.1.31] - 2026-04-07
+
+### Added
+- Anti-rationalization sections to 4 core skills (plan, work, impl-review, epic-review)
+- Adversarial review iteration 2 findings addressed
+- Simplify-ignore hook improvements from adversarial review
+- Borrow agent skills patterns and anti-patterns documentation
+- README overhaul with architecture diagram, skill inventory table, and streamlined quick start
+- CHANGELOG.md (this file)
+
+### Changed
+- skill-create updated to enforce skill-anatomy.md template
+- README.md restructured for clarity: badges, one-liner, install, quick start, full skill inventory, architecture, commands reference, contributing, and license sections
+
+## [0.1.30] and earlier
+
+See [git log](https://github.com/z23cc/flow-code/commits/main) for full history.