oh-my-opencode 4.9.2 → 4.11.0

package/packages/shared-skills/skills/frontend/references/ui-ux-db/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/packages/shared-skills/skills/frontend/scripts/perfection/lighthouse-audit.py

@@ -0,0 +1,201 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#     "playwright",
+#     "typer",
+#     "rich",
+# ]
+# ///
+
+# ─── How to run ───
+# 1. Install uv (if not installed):
+#      curl -LsSf https://astral.sh/uv/install.sh | sh
+# 2. Install Playwright browsers (one-time):
+#      uv run --with playwright python -m playwright install chromium
+# 3. Run:
+#      uv run lighthouse-audit.py https://example.com
+#      uv run lighthouse-audit.py https://example.com --desktop-only
+#      uv run lighthouse-audit.py https://example.com --threshold 95
+# ──────────────────
+
+"""Lighthouse audit via real Playwright Chrome.
+
+Follows the frontend skill perfection ruleset:
+  - NEVER use `lighthouse` CLI (uses headless-shell, not real Chrome)
+  - Use Playwright with channel="chrome" (real Chrome stable)
+  - Run lighthouse Node API via the Playwright CDP endpoint
+  - Mobile preset (primary) + Desktop preset (secondary)
+  - 100 in every category is the floor
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+import typer
+from rich import print as rprint
+from rich.table import Table
+
+
+# Lighthouse config as Node.js script — run via subprocess
+LIGHTHOUSE_RUNNER_JS = """\
+const lighthouse = require('lighthouse');
+const chromeLauncher = require('chrome-launcher');
+
+const url = process.argv[2];
+const port = parseInt(process.argv[3]);
+const preset = process.argv[4]; // 'mobile' or 'desktop'
+
+const config = {
+  extends: 'lighthouse:default',
+  settings: {
+    formFactor: preset === 'desktop' ? 'desktop' : 'mobile',
+    throttling: preset === 'desktop'
+      ? { rttMs: 40, throughputKbps: 10240, cpuSlowdownMultiplier: 1 }
+      : undefined,
+    screenEmulation: preset === 'desktop'
+      ? { mobile: false, width: 1350, height: 940, deviceScaleFactor: 1 }
+      : undefined,
+    onlyCategories: ['performance', 'accessibility', 'best-practices', 'seo'],
+  },
+};
+
+(async () => {
+  const result = await lighthouse(url, { port, logLevel: 'error' }, config);
+  const categories = result.lhr.categories;
+  const output = {};
+  for (const [key, cat] of Object.entries(categories)) {
+    output[key] = Math.round(cat.score * 100);
+  }
+  console.log(JSON.stringify(output));
+})();
+"""
+
+
+def _check_node_deps() -> bool:
+    """Check if lighthouse and chrome-launcher are available."""
+    result = subprocess.run(
+        ["node", "-e", "require('lighthouse'); require('chrome-launcher')"],
+        capture_output=True,
+        text=True,
+    )
+    return result.returncode == 0
+
+
+def _install_node_deps() -> None:
+    """Install lighthouse + chrome-launcher globally."""
+    rprint("[yellow]Installing lighthouse + chrome-launcher...[/yellow]")
+    subprocess.run(
+        ["npm", "install", "-g", "lighthouse", "chrome-launcher"],
+        capture_output=True,
+        check=True,
+    )
+
+
+def _run_lighthouse_via_cdp(url: str, cdp_port: int, preset: str) -> dict[str, int]:
+    """Run lighthouse against a CDP endpoint."""
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".js", delete=False) as f:
+        f.write(LIGHTHOUSE_RUNNER_JS)
+        js_path = f.name
+
+    try:
+        result = subprocess.run(
+            ["node", js_path, url, str(cdp_port), preset],
+            capture_output=True,
+            text=True,
+            timeout=120,
+        )
+        if result.returncode != 0:
+            rprint(f"[red]Lighthouse failed:[/red] {result.stderr}")
+            raise SystemExit(1)
+
+        return json.loads(result.stdout.strip())
+    finally:
+        Path(js_path).unlink(missing_ok=True)
+
+
+def _run_with_playwright(url: str, preset: str) -> dict[str, int]:
+    """Launch real Chrome via Playwright, run Lighthouse against CDP."""
+    from playwright.sync_api import sync_playwright
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch(
+            channel="chrome",
+            headless=True,
+            args=["--remote-debugging-port=0"],
+        )
+
+        # Get the actual CDP port from browser
+        cdp_url = browser.contexts[0].pages[0].url if browser.contexts else ""
+        # Use the browser's websocket endpoint to extract port
+        ws_endpoint = browser._impl_obj._connection._transport._ws_url  # noqa: SLF001
+        # Extract port from ws://127.0.0.1:PORT/...
+        port_str = ws_endpoint.split("://")[1].split(":")[1].split("/")[0]
+        cdp_port = int(port_str)
+
+        try:
+            scores = _run_lighthouse_via_cdp(url, cdp_port, preset)
+        finally:
+            browser.close()
+
+    return scores
+
+
+def _print_scores(scores: dict[str, int], preset: str, threshold: int) -> bool:
+    """Print scores as a rich table. Returns True if all pass."""
+    table = Table(title=f"Lighthouse — {preset}")
+    table.add_column("Category")
+    table.add_column("Score", justify="right")
+    table.add_column("Status")
+
+    all_pass = True
+    for category, score in scores.items():
+        status = "[green]✓ PASS[/green]" if score >= threshold else "[red]✗ FAIL[/red]"
+        if score < threshold:
+            all_pass = False
+        color = "green" if score >= threshold else "red"
+        table.add_row(category, f"[{color}]{score}[/{color}]", status)
+
+    rprint(table)
+    return all_pass
+
+
+def main(
+    url: str = typer.Argument(help="URL to audit"),
+    threshold: int = typer.Option(100, "--threshold", "-t", help="Minimum passing score"),
+    desktop_only: bool = typer.Option(False, "--desktop-only", help="Skip mobile audit"),
+    mobile_only: bool = typer.Option(False, "--mobile-only", help="Skip desktop audit"),
+) -> None:
+    """Run Lighthouse audit via real Playwright Chrome."""
+    # Check node deps
+    if not _check_node_deps():
+        _install_node_deps()
+
+    all_pass = True
+
+    if not desktop_only:
+        rprint(f"\n[bold]Auditing (mobile):[/bold] {url}")
+        mobile_scores = _run_with_playwright(url, "mobile")
+        if not _print_scores(mobile_scores, "Mobile", threshold):
+            all_pass = False
+
+    if not mobile_only:
+        rprint(f"\n[bold]Auditing (desktop):[/bold] {url}")
+        desktop_scores = _run_with_playwright(url, "desktop")
+        if not _print_scores(desktop_scores, "Desktop", threshold):
+            all_pass = False
+
+    if all_pass:
+        rprint("\n[green bold]✓ All categories passed![/green bold]")
+    else:
+        rprint(f"\n[red bold]✗ Some categories below {threshold}. Not done yet.[/red bold]")
+        raise SystemExit(1)
+
+
+if __name__ == "__main__":
+    typer.run(main)

package/packages/shared-skills/skills/init-deep/SKILL.md

@@ -133,7 +133,7 @@ LspWorkspaceSymbols(filePath=".", query="function")
 LspFindReferences(filePath="...", line=X, character=Y)
 ```
 
-**LSP Fallback**: If unavailable, rely on explore agents + AST-grep.
+**LSP Fallback**: If unavailable, use `codegraph_explore` first when codegraph_* tools exist; otherwise rely on explore agents + the ast-grep skill (`sg` CLI).
 
 ### Collect Background Results
 

package/packages/shared-skills/skills/lcx-contribute-bug-fix/SKILL.md

@@ -1,22 +1,22 @@
 ---
 name: lcx-contribute-bug-fix
-description: "Contribute a verified bug-fix PR for LazyCodex, lazycodex-ai, omo-codex, bundled Codex skills, or upstream Codex CLI bugs. Use when the user asks to fix a bug, contribute a bug fix, contribute to fix bug, open a PR for a bug, or debug and PR a LazyCodex/Codex defect."
+description: "Contribute a verified bug fix for LazyCodex, lazycodex-ai, omo-codex, bundled Codex skills, or upstream Codex CLI bugs. Opens a fork PR only for upstream openai/codex; LazyCodex-owned defects become a verified-fix issue on code-yeongyu/lazycodex (never a PR — that repo is a generated distribution mirror). Use when the user asks to fix a bug, contribute a bug fix, contribute to fix bug, open a PR for a bug, or debug and PR a LazyCodex/Codex defect."
 metadata:
-  short-description: Contribute verified LazyCodex or Codex bug-fix PRs
+  short-description: Contribute verified LazyCodex or Codex bug fixes
 ---
 
 # lcx-contribute-bug-fix
 
-Use this skill to debug a concrete LazyCodex or Codex defect, implement the smallest correct fix in a fresh temporary workspace, and open a GitHub PR. Work in English, keep the PR body short, and support every claim with runtime or source evidence.
+Use this skill to debug a concrete LazyCodex or Codex defect, implement the smallest correct fix in a fresh temporary workspace, and deliver it. Work in English, keep the body short, and support every claim with runtime or source evidence.
 
-Route ownership the same way as `$lcx-report-bug`:
+Route ownership the same way as `$lcx-report-bug`, but the deliverable differs by target:
 
-- `code-yeongyu/lazycodex` for LazyCodex, lazycodex-ai, omo-codex, bundled skills, hooks, MCP wiring, installer behavior, marketplace sync, docs, or packaging.
-- `openai/codex` for upstream Codex CLI bugs that reproduce without LazyCodex or come from Codex core behavior.
+- `code-yeongyu/lazycodex` for LazyCodex, lazycodex-ai, omo-codex, bundled skills, hooks, MCP wiring, installer behavior, marketplace sync, docs, or packaging. Deliverable: a verified-fix issue with the patch embedded. NEVER open a PR or push a branch against this repo — its contents are regenerated from the source tree on every release, so PRs there cannot be merged and will be closed.
+- `openai/codex` for upstream Codex CLI bugs that reproduce without LazyCodex or come from Codex core behavior. Deliverable: a PR from a fork.
 
 ## Required Outcome
 
-Create a PR that includes:
+For `openai/codex`, create a fork PR that includes:
 
 - a focused branch from a fresh `/tmp` clone/worktree
 - reproduction logs from before the fix
@@ -26,6 +26,15 @@ Create a PR that includes:
 - the required LazyCodex footer tag `Tag: lazycodex-generated`
 - cleanup of temporary worktrees and clones
 
+For `code-yeongyu/lazycodex`, create an issue (never a PR) that includes:
+
+- reproduction logs from before the fix
+- the root cause with source evidence
+- the verified patch as a unified diff, produced and tested in a fresh `/tmp` clone/worktree
+- verification logs from after the fix
+- the `lazycodex-generated` label and the footer tag `Tag: lazycodex-generated`
+- cleanup of temporary worktrees and clones
+
 ## Required Workflow
 
 1. Read the user's bug report and identify the affected surface.
@@ -66,7 +75,7 @@ If `gh` cannot clone, use `git clone --depth=1 "https://github.com/$TARGET_REPO"
 6. Write or update a failing regression test before production changes. Confirm it fails for the bug, not for a missing fixture or typo.
 7. Implement the smallest correct fix. Avoid refactors unless the fix cannot be made safely without one.
 8. Run the regression test, adjacent tests, and the smallest real-surface QA command that proves the user-visible behavior changed.
-9. Commit the verified fix before pushing. Inspect the status first so the PR cannot be empty or stale:
+9. Commit the verified fix in the worktree. Inspect the status first so the delivered diff cannot be empty or stale:
 
 ```bash
 git status --short
@@ -75,7 +84,15 @@ git commit -m "fix: <short bug-fix summary>"
 git log --oneline "origin/$BASE_BRANCH..HEAD"
 ```
 
-10. Generate the PR body with `scripts/create-pr-body.mjs`.
+10. Build the delivery body for the target:
+   - `openai/codex`: generate the PR body with `scripts/create-pr-body.mjs`.
+   - `code-yeongyu/lazycodex`: export the verified patch and write the issue body from the Verified-Fix Issue Template below:
+
+```bash
+PATCH_FILE="/tmp/lazycodex-fix-<short-slug>.patch"
+git diff "origin/$BASE_BRANCH"..HEAD > "$PATCH_FILE"
+```
+
 11. Ensure the generated label exists when the target repo allows label management. Keep the footer tag even when label creation is unavailable:
 
 ```bash
@@ -87,20 +104,21 @@ else
 fi
 ```
 
-12. Push to a writable remote, then create the PR. For upstream `openai/codex`, fork first and use the fork as the head repository:
+12. Deliver the fix.
+   - `code-yeongyu/lazycodex`: create the verified-fix issue. Never push a branch to this repo and never run `gh pr create` against it:
 
 ```bash
-PUSH_REMOTE="origin"
-PR_HEAD="$BRANCH_NAME"
-if [ "$TARGET_REPO" = "openai/codex" ]; then
-  gh repo fork "$TARGET_REPO" --remote --remote-name fork
-  PUSH_REMOTE="fork"
-  GH_USER="$(gh api user --jq .login)"
-  PR_HEAD="$GH_USER:$BRANCH_NAME"
-fi
+ISSUE_BODY="/tmp/lazycodex-fix-<short-slug>-issue.md"
+gh issue create --repo code-yeongyu/lazycodex --title "<short fix title>" "${LABEL_ARGS[@]}" --body-file "$ISSUE_BODY"
+```
 
-git push -u "$PUSH_REMOTE" "$BRANCH_NAME"
-gh pr create --repo "$TARGET_REPO" --base "$BASE_BRANCH" --head "$PR_HEAD" --title "<short fix title>" "${LABEL_ARGS[@]}" --body-file "$PR_BODY"
+   - `openai/codex`: fork, push the branch to the fork, and create the PR:
+
+```bash
+gh repo fork openai/codex --remote --remote-name fork
+GH_USER="$(gh api user --jq .login)"
+git push -u fork "$BRANCH_NAME"
+gh pr create --repo openai/codex --base "$BASE_BRANCH" --head "$GH_USER:$BRANCH_NAME" --title "<short fix title>" "${LABEL_ARGS[@]}" --body-file "$PR_BODY"
 ```
 
 13. Clean up:
@@ -112,16 +130,47 @@ find "$WORK_ROOT" -mindepth 1 -maxdepth 1 -exec rm -r -- {} +
 rmdir "$WORK_ROOT"
 ```
 
-Return the PR URL, the reproduction command, the verification command, and the cleanup receipt.
+Return the PR or issue URL, the reproduction command, the verification command, and the cleanup receipt.
+
+## Verified-Fix Issue Template (code-yeongyu/lazycodex)
+
+Write the issue body in English. Embed the patch verbatim so a maintainer can apply it to the source tree:
+
+````markdown
+## Problem Situation
+[What failed for the user.]
+
+## Reproduction Logs
+[Exact failing command and relevant log excerpt.]
+
+## Root Cause
+[Confirmed cause with runtime and source evidence.]
+
+## Verified Fix
+[What changed and why this is the smallest correct fix.]
+
+```diff
+[Contents of $PATCH_FILE.]
+```
+
+## Verification
+- [RED test output or repro before the fix]
+- [GREEN test output after the fix]
+- [Manual QA command and result]
+
+---
+This fix was debugged, implemented, and verified with [LazyCodex](https://github.com/code-yeongyu/lazycodex).
+Tag: lazycodex-generated
+````
 
-## PR Body Generator
+## PR Body Generator (openai/codex)
 
 Use the bundled script to generate the PR body. Create a JSON file with this shape:
 
 ```json
 {
   "title": "Fix short user-visible failure",
-  "targetRepository": "code-yeongyu/lazycodex",
+  "targetRepository": "openai/codex",
   "problem": "What is broken for the user.",
   "reproductionLogs": "Exact failing command, log excerpt, or trace.",
   "approach": "What changed and why this is the smallest correct fix.",
@@ -140,7 +189,7 @@ PR_BODY="/tmp/lazycodex-fix-<short-slug>-pr.md"
 node "<skill-root>/scripts/create-pr-body.mjs" "$PR_INPUT" "$PR_BODY"
 ```
 
-## PR Body Template
+## PR Body Template (openai/codex)
 
 The generated body must follow this structure:
 
@@ -179,13 +228,15 @@ Stop and ask one narrow question only when:
 
 - the bug cannot be reproduced from available information
 - target repository ownership remains ambiguous after comparing LazyCodex and upstream Codex evidence
-- authentication is missing for pushing or creating the PR
+- authentication is missing for creating the issue or pushing and creating the PR
 - the fix requires a product decision rather than a technical correction
 
 Do not open:
 
-- a PR without a failing-before and passing-after test
-- a PR without a real-surface QA command
-- a PR without the `Tag: lazycodex-generated` footer
+- a PR or pushed branch targeting `code-yeongyu/lazycodex` — deliver the verified-fix issue instead, always
+- a PR or verified-fix issue without a failing-before and passing-after test
+- a PR or verified-fix issue without a real-surface QA command
+- a PR or issue without the `Tag: lazycodex-generated` footer
+- a verified-fix issue without the patch embedded in a `diff` block
 - a vague fix that does not identify the root cause
 - a broad refactor disguised as a bug fix

package/packages/shared-skills/skills/lcx-contribute-bug-fix/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "lcx-contribute-bug-fix (omo)"
-  short_description: "Contribute verified LazyCodex or Codex bug-fix PRs"
+  short_description: "Contribute verified LazyCodex or Codex bug fixes"
   search_terms:
     - "lcx-contribute-bug-fix"
     - "contribute a bug fix"
@@ -9,4 +9,4 @@ interface:
     - "lazycodex fix"
     - "omo-codex bug fix"
     - "codex bug fix pr"
-  default_prompt: "Use $lcx-contribute-bug-fix to debug this LazyCodex or Codex bug, work from a fresh /tmp clone and worktree, implement the smallest verified fix, generate the PR body, apply the lazycodex-generated label, open the PR, and clean up."
+  default_prompt: "Use $lcx-contribute-bug-fix to debug this LazyCodex or Codex bug, work from a fresh /tmp clone and worktree, implement the smallest verified fix, apply the lazycodex-generated label, deliver it (verified-fix issue on code-yeongyu/lazycodex — never a PR there; fork PR only for openai/codex), and clean up."

package/packages/shared-skills/skills/lcx-report-bug/SKILL.md

@@ -9,8 +9,8 @@ metadata:
 
 You are a LazyCodex bug router and reporter. Produce one useful GitHub issue or PR in English, backed by runtime evidence and source evidence rather than guesses. Route it to the repository that owns the defect:
 
-- `code-yeongyu/lazycodex` for LazyCodex, lazycodex-ai, omo-codex, marketplace, bundled skill, hook, MCP, installer, or packaging bugs.
-- `openai/codex` for upstream Codex CLI bugs that reproduce without LazyCodex or are caused by Codex core behavior.
+- `code-yeongyu/lazycodex` for LazyCodex, lazycodex-ai, omo-codex, marketplace, bundled skill, hook, MCP, installer, or packaging bugs. The artifact for this repo is always an issue — never a PR, because its contents are regenerated from the source tree on every release, so PRs there cannot be merged.
+- `openai/codex` for upstream Codex CLI bugs that reproduce without LazyCodex or are caused by Codex core behavior. This is the only repo where this skill may create a PR.
 
 Use GPT-5.5 style: outcome first, concise, evidence-bound. Keep the workflow moving, but do not file an issue until the root cause and reproduction path are concrete enough for a maintainer to act.
 
@@ -80,7 +80,7 @@ fi
 
 If the selected repo is `openai/codex` and label management is not available, still include the footer tag in the body and continue without claiming label creation succeeded.
 10. If no matching issue exists, create the issue with `gh` and apply the `lazycodex-generated` label.
-11. Create a PR only when the user asked for a PR, the fix is already implemented on a branch, or the smallest correct fix can be safely made in the selected repo. Apply the `lazycodex-generated` label to every PR created by this skill. Otherwise create an issue with fix guidance.
+11. Create a PR only when the target repo is `openai/codex` AND the user asked for a PR, the fix is already implemented on a branch, or the smallest correct fix can be safely made there. Never create a PR or push a branch against `code-yeongyu/lazycodex` — always file an issue there, embedding the verified patch in the Proposed Fix section when one exists. Apply the `lazycodex-generated` label to every PR created by this skill. Otherwise create an issue with fix guidance.
 
 ## Required Label And Footer
 
@@ -145,7 +145,7 @@ Tag: lazycodex-generated
 
 ## PR Body Template
 
-Use this when a PR is the right artifact:
+Use this only when a PR is the right artifact, which is only ever for `openai/codex`:
 
 ```markdown
 ## Summary
@@ -195,11 +195,11 @@ if [ "${#LABEL_ARGS[@]}" -gt 0 ]; then
 fi
 ```
 
-For a PR from a branch pushed to the selected repo or fork:
+For a PR from a branch pushed to a fork — `openai/codex` only, never `code-yeongyu/lazycodex`:
 
 ```bash
 PR_BODY="/tmp/lcx-report-bug-pr-$(date +%Y%m%d-%H%M%S).md"
-gh pr create --repo "$TARGET_REPO" --title "<clear title>" "${LABEL_ARGS[@]}" --body-file "$PR_BODY"
+gh pr create --repo openai/codex --title "<clear title>" "${LABEL_ARGS[@]}" --body-file "$PR_BODY"
 ```
 
 After creating or commenting, return the issue or PR URL and a short summary of the evidence used.
@@ -228,6 +228,7 @@ Stop and ask one narrow question only when the missing fact changes the issue ma
 
 Do not file:
 
+- a PR or pushed branch targeting `code-yeongyu/lazycodex` — file the issue instead, always
 - a vague issue without reproduction steps
 - an issue that claims a root cause not supported by runtime evidence
 - a duplicate when commenting on an existing issue is enough

package/packages/shared-skills/skills/lcx-report-bug/agents/openai.yaml

@@ -8,4 +8,4 @@ interface:
     - "omo-codex bug"
     - "openai codex bug"
     - "codex upstream issue"
-  default_prompt: "Use $lcx-report-bug to investigate this LazyCodex or Codex bug, compare LazyCodex evidence with /tmp openai/codex source, choose the correct GitHub repo, and file an issue or PR with reproduction, root cause, fix guidance, and the lazycodex-generated label and footer."
+  default_prompt: "Use $lcx-report-bug to investigate this LazyCodex or Codex bug, compare LazyCodex evidence with /tmp openai/codex source, choose the correct GitHub repo, and file an issue (or, for openai/codex only, a PR — never a PR on code-yeongyu/lazycodex) with reproduction, root cause, fix guidance, and the lazycodex-generated label and footer."

package/packages/shared-skills/skills/refactor/SKILL.md

@@ -167,23 +167,14 @@ LspWorkspaceSymbols(filePath, query="[target_symbol]")  // Search by name
 lsp_diagnostics(filePath)  // Errors, warnings before we start
 \`\`\`
 
-### AST-Grep for Pattern Analysis:
+### AST-Grep Skill for Pattern Analysis:
 
-\`\`\`typescript
+\`\`\`bash
 // Find structural patterns
-ast_grep_search(
-  pattern="function $NAME($$$) { $$$ }",  // or relevant pattern
-  lang="typescript",  // or relevant language
-  paths=["src/"]
-)
+python3 scripts/ast_grep_helper.py search 'function $NAME($$$) { $$$ }' --lang ts src/
 
-// Preview refactoring (DRY RUN)
-ast_grep_replace(
-  pattern="[old_pattern]",
-  rewrite="[new_pattern]",
-  lang="[language]",
-  dryRun=true  // ALWAYS preview first
-)
+# Preview refactoring first
+sg --pattern '[old_pattern]' --rewrite '[new_pattern]' --lang ts src/
 \`\`\`
 
 ### Grep for Text Patterns:
@@ -429,12 +420,12 @@ lsp_rename(filePath, line, character, newName)  // Execute rename
 \`\`\`
 
 **For Pattern Transformations:**
-\`\`\`typescript
+\`\`\`bash
 // Preview first
-ast_grep_replace(pattern, rewrite, lang, dryRun=true)
+sg --pattern '[pattern]' --rewrite '[rewrite]' --lang ts path/to/file.ts
 
 // If preview looks good, execute
-ast_grep_replace(pattern, rewrite, lang, dryRun=false)
+python3 scripts/ast_grep_helper.py replace '[pattern]' '[rewrite]' --lang ts path/to/file.ts --apply
 \`\`\`
 
 **For Structural Changes:**
@@ -570,7 +561,7 @@ All existing tests pass. No new errors introduced.
 
 ## ALWAYS DO
 - Understand before changing
-- Preview before applying (ast_grep dryRun=true)
+- Preview before applying (`sg --pattern ... --rewrite ... --lang ...`)
 - Verify after every change
 - Follow existing codebase patterns
 - Keep todos updated in real-time
@@ -599,8 +590,8 @@ Leverage LSP tools for precision analysis. Key patterns:
 - **Continuous verification**: \`lsp_diagnostics\` after every change
 
 ## AST-Grep
-Use \`ast_grep_search\` and \`ast_grep_replace\` for structural transformations.
-**Critical**: Always \`dryRun=true\` first, review, then execute.
+Use \`ast-grep\` skill helper or \`sg\` CLI for structural transformations.
+**Critical**: Always preview first, review, then execute.
 
 ## Agents
 - \`explore\`: Parallel codebase pattern discovery
@@ -684,7 +675,7 @@ Record the chosen path in the TodoWrite list.
     {
       "kind": "category",
       "category": "unspecified-low",
-      "prompt": "You handle logic-preserving refactors that need reasoning (extract function, restructure conditional, pattern transformation, cross-file API change). Read the task description's plan step carefully. Use ast_grep_replace with dryRun=true first, review the preview, then execute. If the step is ambiguous or would require out-of-scope changes, STOP and send team_send_message(teamRunId=<id>, to=\"lead\", summary=\"UNCLEAR\", body=<reason>) + team_task_update(status=pending). Same reporting contract as peer quick workers. Never run tests."
+      "prompt": "You handle logic-preserving refactors that need reasoning (extract function, restructure conditional, pattern transformation, cross-file API change). Read the task description's plan step carefully. Use the ast-grep skill helper or sg CLI to preview structural rewrites first, review the preview, then execute. If the step is ambiguous or would require out-of-scope changes, STOP and send team_send_message(teamRunId=<id>, to=\"lead\", summary=\"UNCLEAR\", body=<reason>) + team_task_update(status=pending). Same reporting contract as peer quick workers. Never run tests."
     },
     { "kind": "category", "category": "unspecified-low", "prompt": "Same contract as peer unspecified-low worker." }
   ]