@synapta/skills 0.1.1 → 0.2.0

package/skills/repo-bootstrap/references/examples/php-with-frontend/web/src/Button.tsx

@@ -0,0 +1,10 @@
+import React from 'react';
+
+export interface ButtonProps {
+  label: string;
+  onClick: () => void;
+}
+
+export function Button({ label, onClick }: ButtonProps) {
+  return <button onClick={onClick}>{label}</button>;
+}

package/skills/repo-bootstrap/references/examples/php-with-frontend/web/src/Footer.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+
+export function Footer() {
+  return (
+    <footer>
+      <p>2026 My App</p>
+    </footer>
+  );
+}

package/skills/repo-bootstrap/references/examples/php-with-frontend/web/src/Header.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+
+export function Header() {
+  return (
+    <header>
+      <h1>My App</h1>
+    </header>
+  );
+}

package/skills/repo-bootstrap/references/examples/php-with-frontend/web/src/main.tsx

@@ -0,0 +1,3 @@
+import React from 'react';
+import App from './App';
+export { App };

package/skills/repo-bootstrap/references/examples/php-with-frontend/web/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "jsx": "react-jsx",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

package/skills/repo-bootstrap/references/examples/pnpm-workspace/AGENTS.md

@@ -0,0 +1,75 @@
+<!-- FOR AI AGENTS - Human readability is a side effect, not a goal -->
+<!-- Managed by agent: keep sections and order; edit content, not structure -->
+<!-- Last updated: 2026-02-05 | Last verified: never -->
+
+# AGENTS.md
+
+**Precedence:** the **closest `AGENTS.md`** to the files you're changing wins. Root holds global defaults only.
+
+## Commands (unverified)
+> Source: package.json — CI-sourced commands are most reliable
+
+<!-- AGENTS-GENERATED:START commands -->
+| Task | Command | ~Time |
+|------|---------|-------|
+| Typecheck | pnpm dlx tsc --noEmit | ~15s |
+| Lint | pnpm dlx eslint . | ~10s |
+| Format | pnpm dlx prettier --write . | ~5s |
+<!-- AGENTS-GENERATED:END commands -->
+
+> If commands fail, verify against Makefile/package.json/composer.json or ask user to update.
+
+## Workflow
+1. **Before coding**: Read nearest `AGENTS.md` + check Golden Samples for the area you're touching
+2. **After each change**: Run the smallest relevant check (lint → typecheck → single test)
+3. **Before committing**: Run full test suite if changes affect >2 files or touch shared code
+
+## File Map
+<!-- AGENTS-GENERATED:START filemap -->
+```
+packages/        → project files
+```
+<!-- AGENTS-GENERATED:END filemap -->
+
+## Heuristics (quick decisions)
+<!-- AGENTS-GENERATED:START heuristics -->
+| When | Do |
+|------|-----|
+| Committing | Use Conventional Commits (feat:, fix:, docs:, etc.) |
+| Merging PRs | Squash and merge |
+| Adding dependency | Ask first - we minimize deps |
+| Unsure about pattern | Check Golden Samples above |
+<!-- AGENTS-GENERATED:END heuristics -->
+
+## Repository Settings
+<!-- AGENTS-GENERATED:START repo-settings -->
+- **Default branch:** `main`
+- **Merge strategy:** squash, merge, rebase
+<!-- AGENTS-GENERATED:END repo-settings -->
+
+## Boundaries
+
+### Always Do
+- Run pre-commit checks before committing
+- Add tests for new code paths
+- Use conventional commit format: `type(scope): subject`
+- Use TypeScript strict mode with proper type annotations
+
+### Ask First
+- Adding new dependencies
+- Modifying CI/CD configuration
+- Changing public API signatures
+- Running full e2e test suites
+- Repo-wide refactoring or rewrites
+
+### Never Do
+- Commit secrets, credentials, or sensitive data
+- Modify vendor/, node_modules/, or generated files
+- Push directly to main/master branch
+- Delete migration files or schema changes
+- Commit package-lock.json without package.json changes
+- Use any type without justification
+
+## When instructions conflict
+The nearest `AGENTS.md` wins. Explicit user prompts override files.
+- For TypeScript/JavaScript patterns, follow project eslint/prettier config

package/skills/repo-bootstrap/references/examples/pnpm-workspace/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "workspace-root",
+  "private": true,
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/skills/repo-bootstrap/references/examples/pnpm-workspace/packages/web/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@workspace/web",
+  "version": "1.0.0",
+  "dependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0"
+  }
+}

package/skills/repo-bootstrap/references/examples/pnpm-workspace/packages/web/src/index.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+
+const App: React.FC = () => {
+  return <div>Hello from workspace package</div>;
+};
+
+const root = document.getElementById('root');
+if (root) {
+  ReactDOM.createRoot(root).render(<App />);
+}

package/skills/repo-bootstrap/references/examples/pnpm-workspace/pnpm-lock.yaml

@@ -0,0 +1,42 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      typescript:
+        specifier: ^5.0.0
+        version: 5.3.3
+
+  packages/web:
+    dependencies:
+      react:
+        specifier: ^18.2.0
+        version: 18.2.0
+      react-dom:
+        specifier: ^18.2.0
+        version: 18.2.0(react@18.2.0)
+    devDependencies:
+      '@types/react':
+        specifier: ^18.2.0
+        version: 18.2.45
+
+packages:
+
+  '@types/react@18.2.45':
+    resolution: {integrity: sha512-TtAxCNrlrBp8GoeGmtE1KJSz==}
+
+  react-dom@18.2.0:
+    resolution: {integrity: sha512-6IMTriUmvsjHUjNtEDudZfuDQUoWXVxKHhlEGSk81n==}
+    peerDependencies:
+      react: ^18.2.0
+
+  react@18.2.0:
+    resolution: {integrity: sha512-/3IjMdb2L9QbBdWiW5e3P2/npwMBaU9mHCSCUzNln0ZCY==}
+
+  typescript@5.3.3:
+    resolution: {integrity: sha512-pXWcraxM0uxAS+tN0AG/BF2TyqmHO014Z070Us==}

package/skills/repo-bootstrap/references/examples/pnpm-workspace/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - "packages/*"

package/skills/repo-bootstrap/references/examples/simple-ldap-go/AGENTS.md

@@ -0,0 +1,70 @@
+<!-- FOR AI AGENTS - Human readability is a side effect, not a goal -->
+<!-- Managed by agent: keep sections and order; edit content, not structure -->
+<!-- Last updated: 2026-02-05 | Last verified: never -->
+
+# AGENTS.md
+
+**Precedence:** the **closest `AGENTS.md`** to the files you're changing wins. Root holds global defaults only.
+
+## Commands (unverified)
+> Source: go.mod — CI-sourced commands are most reliable
+
+<!-- AGENTS-GENERATED:START commands -->
+| Task | Command | ~Time |
+|------|---------|-------|
+| Typecheck | go build -v ./... | ~15s |
+| Format | gofmt -w . | ~5s |
+| Test (single) | go test -v -race | ~2s |
+| Test (all) | go test -v -race -short ./... | ~30s |
+| Build | go build -v ./... | ~30s |
+<!-- AGENTS-GENERATED:END commands -->
+
+> If commands fail, verify against Makefile/package.json/composer.json or ask user to update.
+
+## Workflow
+1. **Before coding**: Read nearest `AGENTS.md` + check Golden Samples for the area you're touching
+2. **After each change**: Run the smallest relevant check (lint → typecheck → single test)
+3. **Before committing**: Run full test suite if changes affect >2 files or touch shared code
+
+## Heuristics (quick decisions)
+<!-- AGENTS-GENERATED:START heuristics -->
+| When | Do |
+|------|-----|
+| Adding package | Internal → `internal/`, Public → `pkg/` |
+| Committing | Use Conventional Commits (feat:, fix:, docs:, etc.) |
+| Merging PRs | Squash and merge |
+| Adding dependency | Ask first - we minimize deps |
+| Unsure about pattern | Check Golden Samples above |
+<!-- AGENTS-GENERATED:END heuristics -->
+
+## Repository Settings
+<!-- AGENTS-GENERATED:START repo-settings -->
+- **Default branch:** `main`
+- **Merge strategy:** squash, merge, rebase
+<!-- AGENTS-GENERATED:END repo-settings -->
+
+## Boundaries
+
+### Always Do
+- Run pre-commit checks before committing
+- Add tests for new code paths
+- Use conventional commit format: `type(scope): subject`
+- Follow Go 1.25 conventions and idioms
+
+### Ask First
+- Adding new dependencies
+- Modifying CI/CD configuration
+- Changing public API signatures
+- Running full e2e test suites
+- Repo-wide refactoring or rewrites
+
+### Never Do
+- Commit secrets, credentials, or sensitive data
+- Modify vendor/, node_modules/, or generated files
+- Push directly to main/master branch
+- Delete migration files or schema changes
+- Commit go.sum without go.mod changes
+
+## When instructions conflict
+The nearest `AGENTS.md` wins. Explicit user prompts override files.
+- For Go-specific patterns, defer to language idioms and standard library conventions

package/skills/repo-bootstrap/references/examples/simple-ldap-go/examples-AGENTS.md

@@ -0,0 +1,45 @@
+<!-- Managed by agent: keep sections and order; edit content, not structure. Last updated: 2025-09-29 -->
+
+# AGENTS.md — Examples
+
+## Overview
+Example applications demonstrating library usage patterns for authentication, user management, performance optimization, context handling, and error patterns. Entry points are the main.go files in each subdirectory.
+
+## Setup & environment
+- Install: `go mod download`
+- Run example: `go run examples/<name>/main.go`
+- Env: Examples use environment variables from `.env` files when present
+
+## Build & tests (prefer file-scoped)
+- Typecheck a file: `go build -v examples/<name>/main.go`
+- Format a file: `gofmt -w examples/<name>/main.go`
+- Run example: `go run examples/<name>/main.go`
+
+## Code style & conventions
+- Examples should be self-contained and runnable
+- Use clear variable names that explain the concept
+- Include comments explaining non-obvious patterns
+- Error handling should demonstrate best practices
+- Keep examples focused on a single concept
+
+## Security & safety
+- Never include real credentials in examples
+- Use placeholder values like "ldap.example.com"
+- Document required permissions clearly
+- Examples should fail gracefully without real LDAP server
+
+## PR/commit checklist
+- Examples must compile without errors
+- Include README.md explaining the example's purpose
+- Test example with both real and mock LDAP servers if possible
+- Ensure examples follow library best practices
+
+## Good vs. bad examples
+- Good: `authentication/main.go` (clear flow, error handling)
+- Good: `context-usage/main.go` (proper context propagation)
+- Pattern to follow: Simple, focused, well-commented demonstrations
+
+## When stuck
+- Check the main library documentation in ../docs/
+- Review similar examples in sibling directories
+- Ensure you have the latest library version

package/skills/repo-bootstrap/references/examples/simple-ldap-go/go.mod

@@ -0,0 +1,3 @@
+module example.com/simple-ldap-go
+
+go 1.25

package/skills/repo-bootstrap/references/examples/t3x-rte-ckeditor-image/AGENTS.md

@@ -0,0 +1,70 @@
+<!-- FOR AI AGENTS - Human readability is a side effect, not a goal -->
+<!-- Managed by agent: keep sections and order; edit content, not structure -->
+<!-- Last updated: 2026-02-05 | Last verified: never -->
+
+# AGENTS.md
+
+**Precedence:** the **closest `AGENTS.md`** to the files you're changing wins. Root holds global defaults only.
+
+## Commands (unverified)
+> Source: composer.json — CI-sourced commands are most reliable
+
+<!-- AGENTS-GENERATED:START commands -->
+| Task | Command | ~Time |
+|------|---------|-------|
+| Lint | vendor/bin/php-cs-fixer fix --dry-run | ~10s |
+| Format | vendor/bin/php-cs-fixer fix | ~5s |
+| Test (single) | vendor/bin/phpunit | ~2s |
+| Test (all) | vendor/bin/phpunit | ~30s |
+<!-- AGENTS-GENERATED:END commands -->
+
+> If commands fail, verify against Makefile/package.json/composer.json or ask user to update.
+
+## Workflow
+1. **Before coding**: Read nearest `AGENTS.md` + check Golden Samples for the area you're touching
+2. **After each change**: Run the smallest relevant check (lint → typecheck → single test)
+3. **Before committing**: Run full test suite if changes affect >2 files or touch shared code
+
+## Heuristics (quick decisions)
+<!-- AGENTS-GENERATED:START heuristics -->
+| When | Do |
+|------|-----|
+| Adding class | Follow PSR-4 in `Classes/` or `src/` |
+| Committing | Use Conventional Commits (feat:, fix:, docs:, etc.) |
+| Merging PRs | Squash and merge |
+| Adding dependency | Ask first - we minimize deps |
+| Unsure about pattern | Check Golden Samples above |
+<!-- AGENTS-GENERATED:END heuristics -->
+
+## Repository Settings
+<!-- AGENTS-GENERATED:START repo-settings -->
+- **Default branch:** `main`
+- **Merge strategy:** squash, merge, rebase
+<!-- AGENTS-GENERATED:END repo-settings -->
+
+## Boundaries
+
+### Always Do
+- Run pre-commit checks before committing
+- Add tests for new code paths
+- Use conventional commit format: `type(scope): subject`
+- Follow PSR-12 coding standards and PHP ^8.1 features
+
+### Ask First
+- Adding new dependencies
+- Modifying CI/CD configuration
+- Changing public API signatures
+- Running full e2e test suites
+- Repo-wide refactoring or rewrites
+
+### Never Do
+- Commit secrets, credentials, or sensitive data
+- Modify vendor/, node_modules/, or generated files
+- Push directly to main/master branch
+- Delete migration files or schema changes
+- Commit composer.lock without composer.json changes
+- Modify core framework files
+
+## When instructions conflict
+The nearest `AGENTS.md` wins. Explicit user prompts override files.
+- For PHP-specific patterns, follow PSR standards