@smartsoft001/pro-claude-plugins 0.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,26 @@
+{
+  "name": "smart-pro",
+  "description": "Smart-pro Integration Plugins",
+  "owner": {
+    "name": "Smartflow",
+    "email": "office@smartflow.biz.pl"
+  },
+  "plugins": [
+    {
+      "name": "smart-pro",
+      "source": "./plugins/smart-pro"
+    },
+    {
+      "name": "flow",
+      "source": "./plugins/flow"
+    },
+    {
+      "name": "flow-legacy",
+      "source": "./plugins/flow-legacy"
+    },
+    {
+      "name": "flow-external",
+      "source": "./plugins/flow-external"
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,56 @@
+# @smartsoft001/pro-claude-plugins
+
+![npm](https://img.shields.io/npm/v/@smartsoft001/pro-claude-plugins) ![downloads](https://img.shields.io/npm/dm/@smartsoft001/pro-claude-plugins)
+
+Claude Code plugins marketplace for the `@smartsoft001/pro-*` framework.
+
+## Installation
+
+### External consumers (after publish)
+
+```bash
+npm i @smartsoft001/pro-claude-plugins
+claude plugin marketplace add ./node_modules/@smartsoft001/pro-claude-plugins
+```
+
+### Local development consumption (this repo)
+
+The source-of-truth marketplace lives in `src/.claude-plugin/marketplace.json`. Run once after cloning:
+
+```bash
+claude plugin marketplace add ./packages/shared/claude-plugins/src
+claude plugin list
+```
+
+The command is idempotent — safe to re-run.
+
+## Plugins
+
+### smart-pro
+
+Pro UI components for `@smartsoft001/pro-angular` (Tailwind). Includes hooks for skill activation, safety validation, formatting, and audit logging.
+
+| Documentation | Description |
+|---------------|-------------|
+| [README](src/plugins/smart-pro/hooks/README.md) | Overview of available hooks |
+| [CONFIG](src/plugins/smart-pro/hooks/CONFIG.md) | Configuration and customization guide |
+
+### flow
+
+Development flow skills for Linear-driven development workflow (current Angular version).
+
+### flow-legacy
+
+Development flow skills for legacy Angular 14 projects with Linear-driven workflow.
+
+### flow-external
+
+Development flow skills for standalone Angular 6-11 projects without framework (Angular CLI, Karma/Jasmine, Bootstrap 4).
+
+## Changelog
+
+All notable changes to this project will be documented in the [CHANGELOG](../../../CHANGELOG.md).
+
+## License
+
+This project is licensed under the MIT License.

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@smartsoft001/pro-claude-plugins",
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "postinstall": "claude plugin update smart-pro@smart-pro flow@smart-pro flow-legacy@smart-pro flow-external@smart-pro --scope project || true"
+  },
+  "types": "./src/index.d.ts",
+  "module": "./src/index.js",
+  "type": "module",
+  "main": "./src/index.js"
+}

package/plugins/flow/.claude-plugin/README.md

@@ -0,0 +1,91 @@
+# Flow Plugin for Claude Code
+
+Development flow skills for Linear-driven development workflow.
+
+## Workflow Skills
+
+| Skill | Description |
+|-------|-------------|
+| `/commit` | Create conventional commit based on Linear task |
+| `/impl` | Implement plans from `plan.md` attachment on Linear issue; orchestration saved as `orchestration.md` attachment |
+| `/plan` | Create implementation plan, save as `plan.md` attachment on Linear issue, add `AI Plan` label |
+| `/push` | Push changes and update Linear status (keeps `plan.md` / `orchestration.md` attachments on the issue) |
+
+## Installation
+
+### 1. Enable plugin in project's `.claude/settings.json`:
+
+```json
+{
+  "enabledPlugins": {
+    "flow@smart-pro": true
+  }
+}
+```
+
+### 2. Merge permissions from template
+
+Copy permissions from `settings.template.json` to your project's `.claude/settings.json`.
+
+**Quick merge script:**
+
+```bash
+# From project root
+node -e "
+const template = require('node_modules/@smartsoft001/pro-claude-plugins/plugins/flow/.claude-plugin/settings.template.json');
+const settings = require('.claude/settings.json');
+
+settings.permissions = settings.permissions || { allow: [], deny: [], ask: [] };
+settings.permissions.allow = [...new Set([...settings.permissions.allow, ...template.permissions.allow])];
+settings.permissions.ask = [...new Set([...settings.permissions.ask, ...template.permissions.ask])];
+
+require('fs').writeFileSync('.claude/settings.json', JSON.stringify(settings, null, 2));
+console.log('Permissions merged!');
+"
+```
+
+## Required MCP Servers
+
+Configure these in your `.mcp.json`:
+
+- `linear` - Linear API integration (MCP prefix `mcp__linear__`)
+- `playwright` - Browser automation for screenshots
+
+### Linear MCP tool dependencies
+
+`/plan`, `/impl`, and `/push` depend on the following `mcp__linear__*` tools (in addition to the standard comment/issue tools):
+
+- `create_attachment` (base64 upload), `get_attachment`, `delete_attachment` — for persisting `plan.md` / `orchestration.md` on issues (attachments are also returned by `get_issue`)
+- `list_issue_labels` — to find the workspace-level `AI Plan` label (the label is pre-configured organization-wide; `/plan` does not create it)
+
+Run `/mcp` after authenticating the Linear MCP server to see the exact loaded tool names. If a tool is exposed under a different name in your deployment, update `settings.template.json` and the `allowed-tools` lists in the three skills accordingly.
+
+## Permission Strategy
+
+### Automatic (allow)
+- Git read operations (status, diff, log, show)
+- Nx commands (test, lint, build)
+- Linear API (read/write issues, comments)
+- Playwright (screenshots)
+- Utility skills
+
+### Requires Confirmation (ask)
+- Workflow skills (/commit, /impl, /plan, /push)
+- `git commit` - creating commits
+- `git push` - pushing to remote
+- `gh pr create` - creating pull requests
+
+## Utility Skills
+
+| Skill | Description |
+|-------|-------------|
+| `maia-files-upload` | Upload files to Maia API |
+| `maia-files-delete` | Delete files from Maia API |
+| `browser-capture` | Capture screenshots with Playwright |
+| `linear-suggestion` | Create Linear issues for improvements |
+| `test-unit` | Run unit tests with coverage |
+| `a11y-audit` | Accessibility audit |
+
+## Agents
+
+See `agents/` directory for full list of specialized agents used by flow skills.

package/plugins/flow/.claude-plugin/merge-permissions.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/**
+ * Merge flow plugin permissions into project's .claude/settings.json
+ *
+ * Usage:
+ *   npx @smartsoft001/pro-claude-plugins flow:merge-permissions
+ *
+ * Or directly:
+ *   node node_modules/@smartsoft001/pro-claude-plugins/plugins/flow/.claude-plugin/merge-permissions.js
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const SETTINGS_PATH = path.join(process.cwd(), '.claude', 'settings.json');
+const TEMPLATE_PATH = path.join(__dirname, 'settings.template.json');
+
+function loadJson(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch (e) {
+    return null;
+  }
+}
+
+function mergeArrays(existing, template) {
+  return [...new Set([...existing, ...template])];
+}
+
+function main() {
+  console.log('Flow Plugin - Merge Permissions\n');
+
+  // Load template
+  const template = loadJson(TEMPLATE_PATH);
+  if (!template) {
+    console.error('ERROR: Could not load template from:', TEMPLATE_PATH);
+    process.exit(1);
+  }
+
+  // Load or create settings
+  let settings = loadJson(SETTINGS_PATH);
+  if (!settings) {
+    console.log('Creating new .claude/settings.json...');
+    fs.mkdirSync(path.dirname(SETTINGS_PATH), { recursive: true });
+    settings = { permissions: { allow: [], deny: [], ask: [] } };
+  }
+
+  // Ensure permissions structure exists
+  settings.permissions = settings.permissions || {
+    allow: [],
+    deny: [],
+    ask: [],
+  };
+  settings.permissions.allow = settings.permissions.allow || [];
+  settings.permissions.ask = settings.permissions.ask || [];
+  settings.permissions.deny = settings.permissions.deny || [];
+
+  // Count before
+  const beforeAllow = settings.permissions.allow.length;
+  const beforeAsk = settings.permissions.ask.length;
+
+  // Merge permissions
+  settings.permissions.allow = mergeArrays(
+    settings.permissions.allow,
+    template.permissions.allow,
+  );
+  settings.permissions.ask = mergeArrays(
+    settings.permissions.ask,
+    template.permissions.ask,
+  );
+
+  // Enable plugin
+  settings.enabledPlugins = settings.enabledPlugins || {};
+  settings.enabledPlugins['flow@smart-pro'] = true;
+
+  // Merge env (shallow merge — template values don't overwrite existing project values)
+  if (template.env) {
+    settings.env = settings.env || {};
+    let addedEnv = 0;
+    for (const [key, value] of Object.entries(template.env)) {
+      if (!(key in settings.env)) {
+        settings.env[key] = value;
+        addedEnv++;
+      }
+    }
+  }
+
+  // Write back
+  fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
+
+  // Report
+  const addedAllow = settings.permissions.allow.length - beforeAllow;
+  const addedAsk = settings.permissions.ask.length - beforeAsk;
+  const envKeys = template.env
+    ? Object.keys(template.env).filter((k) => !k.startsWith('_'))
+    : [];
+  const existingEnvKeys = settings.env ? Object.keys(settings.env) : [];
+
+  console.log('Permissions merged successfully!\n');
+  console.log(
+    `  allow: ${beforeAllow} -> ${settings.permissions.allow.length} (+${addedAllow})`,
+  );
+  console.log(
+    `  ask:   ${beforeAsk} -> ${settings.permissions.ask.length} (+${addedAsk})`,
+  );
+  if (envKeys.length > 0) {
+    console.log(
+      `  env:   ${envKeys.length} key(s) from template (existing values preserved)`,
+    );
+  }
+  console.log(`\nPlugin enabled: flow@smart-pro`);
+  console.log(`\nFile updated: ${SETTINGS_PATH}`);
+}
+
+main();

package/plugins/flow/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "flow",
+  "description": "Development flow skills for Linear-driven development workflow",
+  "version": "0.0.1"
+}

package/plugins/flow/.claude-plugin/settings.template.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.schema.json",
+  "_description": "Template permissions for flow@smart-pro plugin. Merge these into your project's .claude/settings.json",
+  "permissions": {
+    "allow": [
+      "Bash(git status:*)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(git show:*)",
+      "Bash(git add:*)",
+      "Bash(git fetch:*)",
+      "Bash(git pull:*)",
+      "Bash(gh run list:*)",
+      "Bash(gh run view:*)",
+      "Bash(gh pr list:*)",
+      "Bash(nx:*)",
+      "Bash(npx nx:*)",
+      "Bash(npx tsc:*)",
+      "Bash(npm start)",
+      "Bash(npm run format:*)",
+      "Bash(npm audit:*)",
+      "Bash(npm install:*)",
+      "Bash(source:*)",
+      "Bash(nvm use:*)",
+      "Bash(curl:*)",
+      "Bash(lsof:*)",
+      "Bash(ls:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(xargs:*)",
+      "Bash(sleep:*)",
+      "Bash(rm:*)",
+      "Bash(test:*)",
+      "Bash(for:*)",
+      "Bash(node:*)",
+      "Bash(mkdir:*)",
+      "mcp__linear__get_issue",
+      "mcp__linear__list_issues",
+      "mcp__linear__list_comments",
+      "mcp__linear__save_comment",
+      "mcp__linear__delete_comment",
+      "mcp__linear__save_issue",
+      "mcp__linear__list_issue_statuses",
+      "mcp__linear__create_attachment",
+      "mcp__linear__get_attachment",
+      "mcp__linear__delete_attachment",
+      "mcp__linear__list_issue_labels",
+      "mcp__playwright__browser_snapshot",
+      "mcp__playwright__browser_take_screenshot",
+      "mcp__playwright__browser_navigate",
+      "mcp__playwright__browser_close",
+      "mcp__playwright__browser_wait_for",
+      "mcp__playwright__browser_click",
+      "mcp__playwright__browser_resize",
+      "mcp__playwright__browser_evaluate",
+      "mcp__playwright__browser_console_messages",
+      "mcp__playwright__browser_press_key",
+      "mcp__playwright__browser_network_requests",
+      "Skill(flow:maia-files-upload)",
+      "Skill(flow:maia-files-delete)",
+      "Skill(flow:browser-capture)",
+      "Skill(flow:linear-suggestion)",
+      "Skill(flow:test-unit)",
+      "Skill(flow:a11y-audit)",
+      "Skill(flow:test-e2e)",
+      "Skill(flow:review)",
+      "Bash(npx playwright:*)"
+    ],
+    "ask": [
+      "Skill(flow:commit)",
+      "Skill(flow:impl)",
+      "Skill(flow:plan)",
+      "Skill(flow:push)",
+      "Skill(flow:review)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(gh pr create:*)"
+    ]
+  },
+  "enabledPlugins": {
+    "flow@smart-pro": true
+  },
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  }
+}

package/plugins/flow/agents/angular-component-scaffolder.md

@@ -0,0 +1,176 @@
+---
+name: angular-component-scaffolder
+description: Create Angular standalone components with signals and modern patterns. Use when scaffolding new components following Angular 20+ best practices.
+tools: Read, Write, Glob, Grep
+skills: karpathy-guidelines
+model: sonnet
+color: '#DD0031'
+---
+
+You are an expert at creating Angular standalone components following modern best practices.
+
+## Primary Responsibility
+
+Create Angular components using Angular 20+ patterns including signals, standalone architecture, and modern control flow.
+
+## When to Use
+
+- Creating new Angular components
+- Scaffolding component structure with template and styles
+- Setting up component with proper DI using inject()
+
+## Project-Specific Patterns
+
+This project uses:
+
+- **No explicit `standalone: true`** - Angular 19+ defaults to standalone
+- **TranslatePipe** from `@ngx-translate/core` for i18n
+- **CapitalizePipe** from project pipes
+- **Tailwind CSS** with `smart-` prefix
+
+## Component Template
+
+### Basic Component
+
+```typescript
+import { Component, signal, computed, inject } from '@angular/core';
+import { TranslatePipe } from '@ngx-translate/core';
+
+import { CapitalizePipe } from '../../pipes';
+
+@Component({
+  selector: 'app-feature-name',
+  imports: [TranslatePipe, CapitalizePipe],
+  templateUrl: './feature-name.component.html',
+})
+export class FeatureNameComponent {
+  // Injected services (at top)
+  private readonly dataService = inject(DataService);
+
+  // Signals for local state
+  readonly isLoading = signal(false);
+  readonly data = signal<DataType[]>([]);
+
+  // Computed values for derived state
+  readonly itemCount = computed(() => this.data().length);
+  readonly hasData = computed(() => this.data().length > 0);
+}
+```
+
+### Component with Inputs/Outputs
+
+```typescript
+import { Component, input, output, model, signal } from '@angular/core';
+import { TranslatePipe } from '@ngx-translate/core';
+
+import { CapitalizePipe } from '../../pipes';
+
+@Component({
+  selector: 'app-item-card',
+  imports: [TranslatePipe, CapitalizePipe],
+  templateUrl: './item-card.component.html',
+})
+export class ItemCardComponent {
+  // Required inputs
+  label = input.required<string>();
+  item = input.required<Item>();
+
+  // Optional input with default
+  showActions = input<boolean>(true);
+
+  // Input with transform
+  page = input<number, number>(1, {
+    transform: (val: number) => (val < 1 ? 1 : val),
+  });
+
+  // Output events
+  selected = output<Item>();
+  closed = output();
+
+  // Two-way binding (model)
+  searchText = model<string>('');
+
+  // Internal signals
+  isOpen = signal(false);
+
+  // Methods
+  toggleDropdown(force?: boolean) {
+    this.isOpen.update((val) => force ?? !val);
+  }
+}
+```
+
+## Template Patterns
+
+### Modern Control Flow
+
+```html
+@if (isLoading()) {
+<app-spinner />
+} @else if (error()) {
+<app-error [message]="error()?.message" />
+} @else {
+<div class="smart-grid smart-gap-4">
+  @for (item of items(); track item.id) {
+  <app-item-card [item]="item" (selected)="onSelect($event)" />
+  } @empty {
+  <p class="smart-text-gray-500">
+    {{ 'COMMON.noItems' | translate | capitalize }}
+  </p>
+  }
+</div>
+}
+```
+
+## File Structure
+
+```
+feature-name/
+  feature-name.component.ts      # Component class
+  feature-name.component.html    # Template
+  feature-name.component.scss    # Styles (optional)
+```
+
+## Scaffolding Checklist
+
+- [ ] NO `standalone: true` (Angular 19+ default)
+- [ ] Uses `inject()` for DI at top of class
+- [ ] Uses `signal()` for internal state
+- [ ] Uses `computed()` for derived values
+- [ ] Uses `input()`/`input.required()` for inputs
+- [ ] Uses `output()` for outputs
+- [ ] Uses `model()` for two-way binding
+- [ ] Uses `@if`/`@for` in template
+- [ ] Has `track` in all `@for` loops
+- [ ] Imports `TranslatePipe` if using translations
+- [ ] Imports `CapitalizePipe` if capitalizing text
+- [ ] Tailwind classes with `smart-` prefix
+
+## Output Format
+
+```markdown
+## Component Scaffolded
+
+### Files Created
+
+| File                          | Purpose         |
+| ----------------------------- | --------------- |
+| `feature-name.component.ts`   | Component class |
+| `feature-name.component.html` | Template        |
+
+### Component API
+
+**Inputs:**
+
+- `item: Item` (required)
+- `showActions: boolean` (default: true)
+
+**Outputs:**
+
+- `selected: Item`
+
+### Next Steps
+
+1. Implement component logic
+2. Add to routing or parent component
+```