flyee 0.1.0

package/core/skills/atomic-design/references/stacks/stack-react.md

@@ -0,0 +1,239 @@
+# Stack Adapter: React (TSX)
+
+> For React projects using TypeScript, SCSS, and optionally Storybook.
+
+---
+
+## Folder Structure
+
+For a component named `Button` in the **atoms** category:
+
+```
+src/components/atoms/Button/
+├── index.ts              # Barrel export
+├── Button.tsx            # Component implementation
+├── Button.styles.scss    # BEM styles with design tokens
+├── Button.types.ts       # TypeScript interfaces
+├── Button.test.tsx       # Tests (Vitest + RTL)
+└── Button.stories.tsx    # Storybook story (optional)
+```
+
+**Category paths:**
+- `src/components/atoms/` — Buttons, Inputs, Icons
+- `src/components/molecules/` — SearchBar, FormField
+- `src/components/organisms/` — Header, Card, Modal
+
+---
+
+## Required Files (5 minimum)
+
+### 1. Types — `Button.types.ts` (ALWAYS FIRST)
+
+```tsx
+export interface ButtonProps {
+  readonly children: React.ReactNode;
+  readonly variant?: 'primary' | 'secondary';
+  readonly size?: 'sm' | 'md' | 'lg';
+  readonly disabled?: boolean;
+  readonly onClick?: () => void;
+}
+```
+
+**Rules:**
+- Use `Readonly` or `readonly` modifier on all props
+- Export interface separately for consumers
+- Define all variants as union types
+
+### 2. Component — `Button.tsx`
+
+```tsx
+import React from 'react';
+import type { ButtonProps } from './Button.types';
+import './Button.styles.scss';
+
+const Button: React.FC<ButtonProps> = ({
+  children,
+  variant = 'primary',
+  size = 'md',
+  disabled = false,
+  onClick,
+}) => {
+  return (
+    <button
+      className={`button button--${variant} button--${size}`}
+      disabled={disabled}
+      onClick={onClick}
+    >
+      {children}
+    </button>
+  );
+};
+
+export default Button;
+```
+
+**Rules:**
+- Functional components only (no class components)
+- Default export for the component
+- Import styles directly (NOT CSS Modules)
+- All props with defaults where sensible
+
+### 3. Styles — `Button.styles.scss`
+
+```scss
+.button {
+  padding: var(--spacing-sm) var(--spacing-md);
+  font-size: var(--font-size-md);
+  font-weight: var(--font-weight-medium);
+  border: 1px solid transparent;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: background-color 0.2s ease, opacity 0.2s ease;
+
+  &--primary {
+    background-color: var(--color-primary);
+    color: var(--color-background);
+  }
+
+  &--secondary {
+    background-color: transparent;
+    color: var(--color-primary);
+    border-color: var(--color-primary);
+  }
+
+  &--sm { padding: var(--spacing-xs) var(--spacing-sm); font-size: var(--font-size-sm); }
+  &--lg { padding: var(--spacing-md) var(--spacing-lg); font-size: var(--font-size-lg); }
+
+  &:hover:not(:disabled) { opacity: 0.85; }
+
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+}
+```
+
+**Rules:**
+- BEM methodology strictly
+- ALL values from design tokens (CSS variables)
+- ZERO hardcoded hex/px values
+- Import pattern: `import './Button.styles.scss';` (not modules)
+
+### 4. Tests — `Button.test.tsx`
+
+```tsx
+import { render, screen, fireEvent } from '@testing-library/react';
+import { describe, it, expect, vi } from 'vitest';
+import Button from './Button';
+
+describe('Button', () => {
+  it('renders children correctly', () => {
+    render(<Button>Click me</Button>);
+    expect(screen.getByText('Click me')).toBeInTheDocument();
+  });
+
+  it('applies variant class', () => {
+    render(<Button variant="secondary">Test</Button>);
+    expect(screen.getByText('Test')).toHaveClass('button--secondary');
+  });
+
+  it('calls onClick when clicked', () => {
+    const handleClick = vi.fn();
+    render(<Button onClick={handleClick}>Click me</Button>);
+    fireEvent.click(screen.getByText('Click me'));
+    expect(handleClick).toHaveBeenCalledTimes(1);
+  });
+
+  it('is disabled when disabled prop is true', () => {
+    render(<Button disabled>Click me</Button>);
+    expect(screen.getByText('Click me')).toBeDisabled();
+  });
+
+  it('does not call onClick when disabled', () => {
+    const handleClick = vi.fn();
+    render(<Button disabled onClick={handleClick}>Click me</Button>);
+    fireEvent.click(screen.getByText('Click me'));
+    expect(handleClick).not.toHaveBeenCalled();
+  });
+});
+```
+
+**Rules:**
+- Vitest + React Testing Library
+- Test: rendering, props, interactions, disabled state
+- Minimum 80% coverage
+
+### 5. Barrel Export — `index.ts`
+
+```ts
+export { default } from './Button';
+export type { ButtonProps } from './Button.types';
+```
+
+---
+
+## Optional: Storybook Story — `Button.stories.tsx`
+
+```tsx
+import type { Meta, StoryObj } from '@storybook/react';
+import Button from './Button';
+
+const meta: Meta<typeof Button> = {
+  title: 'Atoms/Button',
+  component: Button,
+  tags: ['autodocs'],
+};
+
+export default meta;
+type Story = StoryObj<typeof Button>;
+
+export const Primary: Story = {
+  args: { children: 'Primary Button', variant: 'primary' },
+};
+
+export const Secondary: Story = {
+  args: { children: 'Secondary Button', variant: 'secondary' },
+};
+
+export const Disabled: Story = {
+  args: { children: 'Disabled', disabled: true },
+};
+```
+
+**Title pattern:** `{Category}/{ComponentName}` (e.g., `Atoms/Button`, `Molecules/SearchBar`)
+
+---
+
+## Composition with shadcn/ui
+
+When the user opts to use shadcn as a base:
+
+1. Check `components.json` exists. If not: `npx shadcn@latest init`
+2. Identify matching primitive: `npx shadcn@latest add button`
+3. Import and wrap:
+
+```tsx
+import { Button as ShadcnButton } from '@/components/ui/button';
+import type { ButtonProps } from './Button.types';
+import './Button.styles.scss';
+
+const Button: React.FC<ButtonProps> = ({ children, variant, ...props }) => (
+  <ShadcnButton className={`button button--${variant}`} {...props}>
+    {children}
+  </ShadcnButton>
+);
+```
+
+**Rule:** Use shadcn for behavior, BEM/tokens for custom visuals.
+
+---
+
+## Infrastructure Detection
+
+| Check | File to Scan | Install Command |
+|-------|-------------|----------------|
+| React | `package.json` → `react` | — |
+| TypeScript | `tsconfig.json` | `npm install -D typescript @types/react` |
+| SCSS | `package.json` → `sass` | `npm install -D sass` |
+| Vitest | `vitest.config.*` | `npm install -D vitest @testing-library/react @testing-library/jest-dom` |
+| Storybook | `.storybook/` dir | `npx storybook@latest init` |

package/core/skills/atomic-design/references/stacks/stack-vue.md

@@ -0,0 +1,224 @@
+# Stack Adapter: Vue 3 (SFC + TypeScript)
+
+> For Vue 3 projects using Composition API, TypeScript, and SCSS.
+
+---
+
+## Folder Structure
+
+For a component named `BaseButton` in the **atoms** category:
+
+```
+src/components/atoms/BaseButton/
+├── index.ts                  # Barrel export
+├── BaseButton.vue            # SFC (template + script + style)
+├── BaseButton.types.ts       # TypeScript interfaces
+├── BaseButton.test.ts        # Tests (Vitest + Vue Test Utils)
+└── BaseButton.stories.ts     # Storybook story (optional)
+```
+
+**Naming convention:** Vue components use `Base` prefix for atoms to avoid conflicts with HTML elements.
+
+**Category paths:**
+- `src/components/atoms/` — BaseButton, BaseInput, BaseIcon
+- `src/components/molecules/` — SearchBar, FormField
+- `src/components/organisms/` — AppHeader, DataTable, SideBar
+
+---
+
+## Required Files (4 minimum)
+
+### 1. Types — `BaseButton.types.ts` (ALWAYS FIRST)
+
+```ts
+export interface BaseButtonProps {
+  variant?: 'primary' | 'secondary';
+  size?: 'sm' | 'md' | 'lg';
+  disabled?: boolean;
+}
+
+export interface BaseButtonEmits {
+  (e: 'click'): void;
+}
+```
+
+### 2. Component — `BaseButton.vue`
+
+```vue
+<script setup lang="ts">
+import type { BaseButtonProps, BaseButtonEmits } from './BaseButton.types';
+
+withDefaults(defineProps<BaseButtonProps>(), {
+  variant: 'primary',
+  size: 'md',
+  disabled: false,
+});
+
+defineEmits<BaseButtonEmits>();
+</script>
+
+<template>
+  <button
+    :class="['button', `button--${variant}`, `button--${size}`]"
+    :disabled="disabled"
+    @click="$emit('click')"
+  >
+    <slot />
+  </button>
+</template>
+
+<style lang="scss" scoped>
+.button {
+  padding: var(--spacing-sm) var(--spacing-md);
+  font-size: var(--font-size-md);
+  font-weight: var(--font-weight-medium);
+  border: 1px solid transparent;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: background-color 0.2s ease, opacity 0.2s ease;
+
+  &--primary {
+    background-color: var(--color-primary);
+    color: var(--color-background);
+  }
+
+  &--secondary {
+    background-color: transparent;
+    color: var(--color-primary);
+    border-color: var(--color-primary);
+  }
+
+  &--sm { padding: var(--spacing-xs) var(--spacing-sm); font-size: var(--font-size-sm); }
+  &--lg { padding: var(--spacing-md) var(--spacing-lg); font-size: var(--font-size-lg); }
+
+  &:hover:not(:disabled) { opacity: 0.85; }
+
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+}
+</style>
+```
+
+**Rules:**
+- `<script setup>` with `lang="ts"` (Composition API)
+- `defineProps<T>()` with `withDefaults()` for typed props
+- `defineEmits<T>()` for typed events
+- `<style lang="scss" scoped>` for scoped BEM styles
+- Slots instead of `children` prop
+
+### 3. Tests — `BaseButton.test.ts`
+
+```ts
+import { mount } from '@vue/test-utils';
+import { describe, it, expect } from 'vitest';
+import BaseButton from './BaseButton.vue';
+
+describe('BaseButton', () => {
+  it('renders slot content', () => {
+    const wrapper = mount(BaseButton, {
+      slots: { default: 'Click me' },
+    });
+    expect(wrapper.text()).toContain('Click me');
+  });
+
+  it('applies variant class', () => {
+    const wrapper = mount(BaseButton, {
+      props: { variant: 'secondary' },
+      slots: { default: 'Test' },
+    });
+    expect(wrapper.classes()).toContain('button--secondary');
+  });
+
+  it('emits click event', async () => {
+    const wrapper = mount(BaseButton, {
+      slots: { default: 'Click me' },
+    });
+    await wrapper.trigger('click');
+    expect(wrapper.emitted('click')).toHaveLength(1);
+  });
+
+  it('is disabled when prop is set', () => {
+    const wrapper = mount(BaseButton, {
+      props: { disabled: true },
+      slots: { default: 'Disabled' },
+    });
+    expect(wrapper.attributes('disabled')).toBeDefined();
+  });
+});
+```
+
+### 4. Barrel Export — `index.ts`
+
+```ts
+export { default as BaseButton } from './BaseButton.vue';
+export type { BaseButtonProps, BaseButtonEmits } from './BaseButton.types';
+```
+
+---
+
+## Optional: Storybook Story — `BaseButton.stories.ts`
+
+```ts
+import type { Meta, StoryObj } from '@storybook/vue3';
+import BaseButton from './BaseButton.vue';
+
+const meta: Meta<typeof BaseButton> = {
+  title: 'Atoms/BaseButton',
+  component: BaseButton,
+  tags: ['autodocs'],
+};
+
+export default meta;
+type Story = StoryObj<typeof BaseButton>;
+
+export const Primary: Story = {
+  args: { variant: 'primary' },
+  render: (args) => ({
+    components: { BaseButton },
+    setup: () => ({ args }),
+    template: '<BaseButton v-bind="args">Primary</BaseButton>',
+  }),
+};
+
+export const Secondary: Story = {
+  args: { variant: 'secondary' },
+  render: (args) => ({
+    components: { BaseButton },
+    setup: () => ({ args }),
+    template: '<BaseButton v-bind="args">Secondary</BaseButton>',
+  }),
+};
+```
+
+---
+
+## Composables Pattern
+
+For components with complex logic, extract to composables:
+
+```
+src/composables/useButton.ts
+```
+
+```ts
+import { computed } from 'vue';
+
+export function useButton(variant: string) {
+  const classes = computed(() => ['button', `button--${variant}`]);
+  return { classes };
+}
+```
+
+---
+
+## Infrastructure Detection
+
+| Check | File to Scan | Install Command |
+|-------|-------------|----------------|
+| Vue 3 | `package.json` → `vue` | — |
+| TypeScript | `tsconfig.json` | `npm install -D typescript vue-tsc` |
+| SCSS | `package.json` → `sass` | `npm install -D sass` |
+| Vitest | `vitest.config.*` | `npm install -D vitest @vue/test-utils` |
+| Storybook | `.storybook/` dir | `npx storybook@latest init --type vue3` |

package/core/skills/bash-linux/SKILL.md

@@ -0,0 +1,199 @@
+---
+name: bash-linux
+description: Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# Bash Linux Patterns
+
+> Essential patterns for Bash on Linux/macOS.
+
+---
+
+## 1. Operator Syntax
+
+### Chaining Commands
+
+| Operator | Meaning | Example |
+|----------|---------|---------|
+| `;` | Run sequentially | `cmd1; cmd2` |
+| `&&` | Run if previous succeeded | `npm install && npm run dev` |
+| `\|\|` | Run if previous failed | `npm test \|\| echo "Tests failed"` |
+| `\|` | Pipe output | `ls \| grep ".js"` |
+
+---
+
+## 2. File Operations
+
+### Essential Commands
+
+| Task | Command |
+|------|---------|
+| List all | `ls -la` |
+| Find files | `find . -name "*.js" -type f` |
+| File content | `cat file.txt` |
+| First N lines | `head -n 20 file.txt` |
+| Last N lines | `tail -n 20 file.txt` |
+| Follow log | `tail -f log.txt` |
+| Search in files | `grep -r "pattern" --include="*.js"` |
+| File size | `du -sh *` |
+| Disk usage | `df -h` |
+
+---
+
+## 3. Process Management
+
+| Task | Command |
+|------|---------|
+| List processes | `ps aux` |
+| Find by name | `ps aux \| grep node` |
+| Kill by PID | `kill -9 <PID>` |
+| Find port user | `lsof -i :3000` |
+| Kill port | `kill -9 $(lsof -t -i :3000)` |
+| Background | `npm run dev &` |
+| Jobs | `jobs -l` |
+| Bring to front | `fg %1` |
+
+---
+
+## 4. Text Processing
+
+### Core Tools
+
+| Tool | Purpose | Example |
+|------|---------|---------|
+| `grep` | Search | `grep -rn "TODO" src/` |
+| `sed` | Replace | `sed -i 's/old/new/g' file.txt` |
+| `awk` | Extract columns | `awk '{print $1}' file.txt` |
+| `cut` | Cut fields | `cut -d',' -f1 data.csv` |
+| `sort` | Sort lines | `sort -u file.txt` |
+| `uniq` | Unique lines | `sort file.txt \| uniq -c` |
+| `wc` | Count | `wc -l file.txt` |
+
+---
+
+## 5. Environment Variables
+
+| Task | Command |
+|------|---------|
+| View all | `env` or `printenv` |
+| View one | `echo $PATH` |
+| Set temporary | `export VAR="value"` |
+| Set in script | `VAR="value" command` |
+| Add to PATH | `export PATH="$PATH:/new/path"` |
+
+---
+
+## 6. Network
+
+| Task | Command |
+|------|---------|
+| Download | `curl -O https://example.com/file` |
+| API request | `curl -X GET https://api.example.com` |
+| POST JSON | `curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL` |
+| Check port | `nc -zv localhost 3000` |
+| Network info | `ifconfig` or `ip addr` |
+
+---
+
+## 7. Script Template
+
+```bash
+#!/bin/bash
+set -euo pipefail  # Exit on error, undefined var, pipe fail
+
+# Colors (optional)
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+# Script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Functions
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1" >&2; }
+
+# Main
+main() {
+    log_info "Starting..."
+    # Your logic here
+    log_info "Done!"
+}
+
+main "$@"
+```
+
+---
+
+## 8. Common Patterns
+
+### Check if command exists
+
+```bash
+if command -v node &> /dev/null; then
+    echo "Node is installed"
+fi
+```
+
+### Default variable value
+
+```bash
+NAME=${1:-"default_value"}
+```
+
+### Read file line by line
+
+```bash
+while IFS= read -r line; do
+    echo "$line"
+done < file.txt
+```
+
+### Loop over files
+
+```bash
+for file in *.js; do
+    echo "Processing $file"
+done
+```
+
+---
+
+## 9. Differences from PowerShell
+
+| Task | PowerShell | Bash |
+|------|------------|------|
+| List files | `Get-ChildItem` | `ls -la` |
+| Find files | `Get-ChildItem -Recurse` | `find . -type f` |
+| Environment | `$env:VAR` | `$VAR` |
+| String concat | `"$a$b"` | `"$a$b"` (same) |
+| Null check | `if ($x)` | `if [ -n "$x" ]` |
+| Pipeline | Object-based | Text-based |
+
+---
+
+## 10. Error Handling
+
+### Set options
+
+```bash
+set -e          # Exit on error
+set -u          # Exit on undefined variable
+set -o pipefail # Exit on pipe failure
+set -x          # Debug: print commands
+```
+
+### Trap for cleanup
+
+```bash
+cleanup() {
+    echo "Cleaning up..."
+    rm -f /tmp/tempfile
+}
+trap cleanup EXIT
+```
+
+---
+
+> **Remember:** Bash is text-based. Use `&&` for success chains, `set -e` for safety, and quote your variables!