- A11y Ambiguity Guard: Skip Verify MISS for Empty {} Grap

  When BuildCompactWinGrap returns {} (WPF overlays, Eye window), PrintMultiWindowTargets skips AutoRegisterBug for verif...

- A11y Eval Deprecated: AutoRegisterBug Guard on Use

  a11y eval action is REMOVED (hard-blocked). Returns false immediately with [REMOVED] banner + migration hint. MCP path...

- A11y Type: --force Bypasses Disabled Gate; hwnd: Skips Scope Guard

  When hwnd: is in the grap, CheckMissingScope is skipped. When --force is passed, ReadinessContext.Force=true bypasses I...

- AI Harness Engineering -- Korean YouTube Interview Key Points

  Key insights from Korean YouTube interview: Oh My Claude Code (Heo Ye-chan) + Oh My Open Agent (Kim Yeon-gyu) on AI har...

- AI News Briefing — lunch and dinner automated digest

  Twice-daily (11:00, 18:00) AI news digest -- see ai-news-to-suggests for the full pipeline including Gemini filter and...

- Agent command: canonical opts + per-tier translation

  wkappbot agent 'task' - tier uses Claude-standard canonical flags as universal interface. All AI types (haiku/sonnet/op...

- Agent() Dispatch Pre-flight Checklist

  5-step checklist before every Agent() call. Prevents claude-md-sync / delegation / pace / brief guard failures that was...

- Anthropic Computer Use — cross-platform AI desktop control (API + Cowork/Dispatch)

  Anthropic Computer Use lets Claude drive a real desktop via screenshot + mouse/keyboard. Two paths: (1) API beta tool c...

- AppBot Log Explorer

  Find and interpret WKAppBot logs across command-specific files, runtime history, errors.jsonl, skill invocation logs, a...

- AppBot Telemetry and Skill Promotion

  Automatically capture user prompts, tool calls, outcome scores, and durable patterns, then route reusable knowledge to...

- Ask Health Check (wkask)

  End-to-end CDP ask pipeline health check via wkask.ps1. Run after hot-swap, Chrome accumulation, or before triad sessio...

- Ask Suggest Priority Batching

  Reduce ask-gpt calls when triaging wkappbot suggest backlogs. Use when you have a page of suggestions and want one GPT...

- Ask Suggest Priority Batching T2 HowTo

  T2 domain tier. Step-by-step: batch GPT ranking, concurrent per-item queries, timeout handling, pipeline health check,...

- Ask Suggest Priority Batching T3 Reference

  T3 reference tier. Canonical rules 2026-05-20, duplicate step archive, calibration history.

- Build a Claude Agent Team — No SDK, No Coding (WKAppBot Way)

  Create a multi-agent analysis team (orchestrator + sub-agents) using only Claude chat. Anthropic official format: YAML...

- CDP Command Guide

  CDP quick-ref: port isolation rule, command table, typical flow, error codes. For step-by-step: cdp-command-guide-howto...

- CDP Command Guide T2 HowTo

  T2 domain tier. Full command reference: navigate, html, capture, eval-js, tabs, close, url, title. cdp-mon anomaly repo...

- CDP Command Guide T3 Reference

  T3 reference tier. Post-reboot recovery, IME daemon watch, tab accumulation bug, JS alert detection, verified tests.

- CDP Event Loop Dialog Handler -- handle Chrome JS dialogs via Page.javascriptDialogOpening events

  Pattern for automating Chrome pages that show alert/confirm/beforeunload dialogs. Uses Page.enable + event loop to catc...

- CDP Runtime.evaluate Focus Guard: Pre-Minimize for Risky Expressions

  Runtime.evaluate with focus-risky expressions (.focus()/.click()/dispatchEvent etc) now triggers pre-minimize dance bef...

- CLAUDE.md Pending Section Sync Workflow

  Keep CLAUDE.md Pending in sync with actual work. CLAUDE.md is canonical -- if not there it does not exist.

- CLAUDE.md 역할 안내: 전역 vs 프로젝트 + 셀프힐링

  Newbie orientation and mandatory rules guide. Explains two-layer CLAUDE.md system global vs project repo root. Lists ke...

- CP949 Save Guard

  AI-only pre-save gate that rejects text files containing characters not representable in CP949. Use before Codex, Claud...

- Claude Code AI Audit Log -- unified tool call logging

  PreToolUse hook + Codex wrapper logs all AI tool calls with timestamp and CWD slug to D:/GitHub/ai-audit.log.

- Claude Code Kill Guard Hook -- block taskkill/Stop-Process for out-of-CWD processes

  PreToolUse hook intercepts taskkill and Stop-Process. Processes outside CWD require user approval; inside CWD allowed s...

- Claude MD Harness Rules T2 HowTo

  T2 domain tier. Examples, body lines, template, scope, best practices, full harness:skill usage.

- Claude MD Harness Rules T3 Reference

  T3 ref. isEditOp history, lock-clear hygiene, global CLAUDE.md integration, Catch-22 fix.

- Claude Terminal via AppBot as Primary Workflow -- Ditch VS Code Extension for Automation

  Design rationale + migration guide for running Claude Code via terminal (AppBot-mediated) instead of VS Code extension....

- Claude Token Optimization — Exploration, Context & Search

  80-90% of tokens are spent on file exploration, not writing code. Techniques: (1) skill-search-first prevents redundant...

- Codex AGENTS.md Tool Rules

  AGENTS.md rules that guide Codex to use Claude-named cmd wrappers instead of native write_file/read_file tools. Require...

- Codex Skill Registration and Edit Guide

  How Codex should create, edit, verify, install, and re-read AppBot skills.

- Codex session tool usage statistics -- 551 sessions analyzed

  Which tools Codex actually calls, ranked by frequency. Key input for harness coverage planning.

- Codex shell_command harness gap -- analysis and fix spec

  Codex shell_command tool flows through wkharness but bypasses all guards -- gap analysis and one-line fix.

- Declarative Automation: CLAUDE.md + Harness as Scheduler

  CLAUDE.md CronCreate declarations + harness auto-detection replaces custom scheduler. Recording execution in CLAUDE.md...

- Diagnostic Commands Cheatsheet (whisper validate claude-usage eye tick)

  Operator reference for diagnostic and introspection verbs: whisper (real-time speech plus offline pipeline), validate (...

- ElevatedEyeProxy: 32 Parallel Acceptors Prevent HANDSHAKE-MISS Burst

  ListenAsync spawns 32 concurrent AcceptLoop workers each owning a NamedPipeServerStream. Burst of parallel --sudo Conne...

- Eye Context Alert Dedup: Persisted to Disk Across Hot-Swaps

  contextWarnedPcts is pre-populated from runtime/context_warned.json on Eye startup. SaveContextWarnedEntry writes each...

- Eye Evict: Skip Admin-Elevated Processes with Null Cmdline

  When eye-evict fires, processes with null GetProcessCommandLine output are admin-elevated; skip window check before evi...

- Git Commit Conventions

  Commit message rules for this repo. English only -- Korean wastes 2-3x tokens in git history.

- Haiku Sandbox Problem Solving Pattern

  T1 core. Sonnet architects, Haiku prototypes in safe sandbox, wkcodex applies to production. Never let Haiku touch orig...

- Haiku Sandbox Problem Solving T2 HowTo

  T2 domain tier. Brief templates for Haiku prototype + wkcodex apply. When to prototype vs direct apply. Anti-patterns.

- Haiku Sandbox Problem Solving T3 Reference

  T3 ref. Real session examples (successes + failures), failure mode analysis, evolution notes.

- Haiku as QA canary — fresh-eyes mechanical execution surfaces validator and CLI failure modes

  When you need to verify a new guard, skill, or CLI actually works, delegate the mechanical execution to Haiku. Haiku do...

- Haiku handoff on CLI retry -- delegate mechanical CLI retries to Haiku after 2 failures

  After two same-kind failures on a mechanical CLI call (suggest/skill add/edit/mail/git commit with arg or validation er...

- LM Wiki — Personal Knowledge Base with Markdown (Claude Code + Obsidian)

  Build a compound-interest knowledge base from any raw sources (web clips, YouTube transcripts, docs). No RAG, no embedd...

- LinkedIn Profile Manager: CDP Read, Navigate, Update

  Manage LinkedIn profile via CDP WebSocket. Profile at linkedin.com/in/***. Sections lazy-load on scroll. Use comtypes U...

- Multi-tab assistant implementation checklist

  Execution checklist for porting a multi-tab assistant interface into AppBot, focused on adapters, event schema, isolate...

- Multi-tab assistant interface MVP (Claude Codex Copilot)

  Design a VS Code extension style multi-tab assistant interface as an integration reference for AppBot, focusing on prov...

- Native tool deny is Codex-only and harness logic outranks CLAUDE-MD

  Denying native Edit/Write is a CODEX-only mechanism (codex-tool-wrappers); never inject Edit/Write into the Claude .cla...

- Nightly Schedule Guard

  PreToolUse hook: blocks Bash/PowerShell until CLAUDE.md CronCreate entries are registered in session JSONL. Global hook...

- On Load (T1 core)

  T1 core tier. Session-start decision rules: when to run mandatory loads, gg trigger, bare-keyword routing. Execution de...

- Opus files bugs and improvement ideas on sight -- aggressive wkappbot suggest filing standing order

  When Opus (or any model) encounters a wkappbot bug, UX flaw, retry-prone pattern, unhelpful error, or improvement idea,...

- QMD Local Codebase Search — Install, Index, and Query

  QMD: BM25 + vector semantic + optional LLM reranking local search engine. Pre-indexes C# source, skill JSONs, and docs....

- Quantbot user input protection: WM_SETFOCUS focus-steal guard

  auto_dismiss_hts_popups.py steals keyboard/mouse focus every 1-5s via WM_SETFOCUS (lines 454,534,677). Focusless replac...

- Resolve stale BUG-AUTO merge noise

  Complete proven recipe to RESOLVE stale BUG-AUTO ASK CDP FOCUS-STEAL timeout noise suggests (especially MERGEx2 survivo...

- Rotating Log Append Helper

  Shared append helper for runtime logs and JSONL files. If the target file was created on a previous day, rotate it into...

- SKILL-REVIEW completed: codex-cli-wkappbot-usage updated to v1.4

  Tracking suggest resolution for codex skill review

- Session Lock Cleared 2026-05-20

  Temporary skill to clear stale session lock from wkappbot-sdk 03:25 session

- Session Pattern Mining and Skill Promotion

  Scan recent session logs for repeated successful patterns, score them for durability, and promote only stable knowledge...

- Skill Sync Split-Brain Cleanup

  Resolve and suppress same-version skill sync warnings by recording chosen ids and verifying a clean follow-up sync.

- Skill Sync Warning Triage

  Inspect wkappbot skill sync split-brain warnings, extract the conflicting ids, and decide the minimal resolve list befo...

- Skill-Lock Audit and Auto-Registration for Critical Source Files

  Auto-detect .cs source changes, map to required skills, verify harness:skill registration in CLAUDE.md, alert on missin...

- Suggest Management Workflow

  Suggest = AI-logged bug/improvement record. Triage with merge, resolve with evidence script. SUBMIT RULE: use wkappbot-...

- Suggest Resolve Pre-flight Checklist

  5-step preflight to pass all resolve guards first try. Covers commit keyword, class size, evidence filename, hidden-win...

- Suggest Resolve Pre-flight Checklist T3 Reference

  T3 reference tier. KEYWORD GUARD FAIL amend pattern, RIQUA items, verified test history.

- Suggest Resolve: CDP Bug Fixes

  Resolve CDP bug suggests with evidence script validation

- Suggest Triage HowTo

  T2 HowTo: suggester confirm flow, delegation patterns, skill-news pre-check, stale-resolve recipe for suggest-triage-pl...

- Suggest Triage Playbook

  Operator playbook for reviewing wkappbot suggestions: classify duplicates, prioritize by impact, keep evidence requirem...

- Suggest Triage Reference

  T3 Reference: guard chain workarounds, known bugs, proven patterns for suggest-triage-playbook

- Suggest Workflow — HowTo (T2)

  How-to guide: merge, resolve, check, evidence script rules, guardrails. See suggest-workflow for core principles.

- Suggest Workflow — Reference (T3)

  History, verified tests, lessons learned. Core rules in suggest-workflow; how-to in suggest-workflow-howto.

- Suggest resolve evidence script conventions

  How to write evidence scripts for suggest resolve. The script must demonstrate regression check passing before 2nd-part...

- [HN] Browser control and computer use as MCP tools – works with Claude, Codex, Cursor — AI computer-use pattern reference

  Integrate browser-control MCP patterns into WKAppBot's Eye MCP architecture to extend CDP-based automation with standar...

- [HN] OculOS – Give AI agents control of your desktop via MCP — AI computer-use pattern reference

  Extend WKAppBot's MCP server to expose desktop control actions (click/type/screenshot) as MCP tools callable by externa...

- [HN] Self-healing browser harness via direct CDP — AI computer-use pattern reference

  Borrow self-healing CDP reconnect patterns for WKAppBot CdpClient to handle Chrome restarts without losing prompt-pump...

- [HN] Show HN: OculOS – Give AI agents control of your desktop via MCP — AI computer-use pattern reference

  Audit OculOS's MCP tool surface against WKAppBot's a11y command set and promote missing desktop-control primitives to t...

- [HN] Show HN: Self-healing browser harness via direct CDP — AI computer-use pattern reference

  Extract CDP session self-healing patterns into WKAppBot's CdpClient to replace current manual reconnect logic. Source:...

- [HN] UI Automata – Windows Desktop Automation for AI Agents — AI computer-use pattern reference

  Compare UIA traversal and fallback strategy against WKAppBot's 5-tier element search to identify gaps or borrowable pat...

- a11y Command Cheatsheet - Operator View for Claude and Codex

  Operational cheatsheet for wkappbot a11y in Claude and Codex workflows. Covers principles (inspect first, resolve grap...

- a11y Commands Reference

  Reference and history: deprecated commands, verified tests, USAGE-REMOVED patterns, audit notes.

- a11y Sub-Actions How-To

  How-to reference for a11y sub-actions: discovery, window-state, input, read, wait, common flags.

- ask -- AI Delegation Cheatsheet

  wkappbot ask delegates questions to GPT/Gemini/Claude. triad = all three in parallel. agent = autonomous sub-agent loop...

- ask command optimization smoke tests

  Smoke test script for ask optimization: dispatch latency, CDP port isolation, a11y eval block, cdp field in grap. Run:...

- cheap-commit-todo-gate

  ARCHIVED: moved to cheap-commit-todo-gate

- cheap-commit-todo-gate

  PreToolUse gate that blocks git commit from Haiku/Sonnet sessions unless CLAUDE.md Pending was edited in the last 30 tu...

- chrome-profile-auth-sync-architecture

  WKAppBot Chrome profile auth sync: master->project copy on launch, project->master SQLite merge on exit. Use when sessi...

- claude-kill-guard-hook

  Claude Code PreToolUse hook: block PowerShell Stop-Process targeting wkappbot processes; companion audit-log traces all...

- claude-proxy: Context Limit Auto-Handoff to Gemini Agent

  When Claude hits context limit, claude-proxy intercepts the error and hands off to wkappbot agent gemini --new-session...

- delegation policy: all commands use mandatory Haiku/Codex/Opus routing in CLAUDE.md

  Project CLAUDE.md applies mandatory agent delegation for all wkappbot commands. Haiku for read/survey, Codex for execut...

- errors.jsonl Periodic Triage — Fix Frequent Errors Fast

  Read .wkappbot/hq/logs/errors.jsonl, aggregate by command pattern, file suggest for patterns >=5 hits. Claude main duty...

- file -- Read/Write/Edit/Grep/Glob Cheatsheet

  wkappbot file tools for filesystem access. edit auto-creates .bak/ backup. glob MUST use **/ prefix. After edit, U+FFFD...

- file cheatsheet how-to

  T2 usage recipes for wkappbot file tools: read/write/edit, glob, grep, batch edits.

- file cheatsheet reference

  T3 gotchas for wkappbot file tools: grep starvation fallback, encoding safety, backup/undo.

- grap -- UI Element Address System (Window + UIA Scope + Web + ADB)

  GRAP = Grab Accessible Pattern -- JSON5-extended universal UI element address. {JSON5-window}#AbsTagPath: identifies an...

- handoff send best practice

  When ctx% exceeds 8MB, prepare handoff. Compress to essentials -- precision beats length. The next Claude must hit the...

- harness:learn -- soft-nudge loop for self-evolving skills

  Pattern for making Claude skills evolve automatically. CLAUDE.md harness:learn directives trigger on tool completions,...

- harness:skill Format — Required Single-Line Pattern

  Documents the mandatory format for harness:skill rules in CLAUDE.md. Pattern must use 3 required skills on single lines...

- harness:skill Format — Required Single-Line Pattern

  Documents the mandatory format for harness:skill rules in CLAUDE.md. Pattern must use 3 required skills on single lines...

- logcat -- Log Viewer Cheatsheet

  wkappbot logcat tails .log files with regex filtering. OR patterns via semicolon. Glob segments auto-expanded. --past N...

- md-heal how-to: scan, drift, gg, sync, commit

  T2 how-to for md-heal: the step-by-step CLAUDE.md heal procedures (scan repo MD, drift-check vs README and AGENTS, gg v...

- md-heal reference: roles, token optimization, todo sync

  T3 reference for md-heal: the file role map (CLAUDE.md vs AGENTS.md vs README.md), token-optimization rule, and the tod...

- md-heal: detect and fix stale or drifted CLAUDE.md files

  Actionable checklist to heal project CLAUDE.md: scan for stale commands, check drift against README/AGENTS, validate gg...

- prompt send -- Self-Prompting & Agent Notification

  How to deliver prompts to a running Claude Code / Codex window. Use prompt send for self-prompting, scheduled nudges, a...

- skill-list-guard

  Guard that warns on Edit/Write if skill news or skill list was not run in the last 60 minutes this session.

- slack -- Send & Reply Cheatsheet

  wkappbot slack send/reply for Slack communication. Eye = Slack daemon built-in (Socket Mode), no separate listener. Alw...

- stall-guard-wk-exemption

  Stall-guard exemption rules for wk* AI tools: all wk* commands are exempt while pace is under limit, with per-tool budg...

- web -- Fetch/Search/Open Cheatsheet (URL-as-target banned, grap required for tab-bound verbs)

  wkappbot cdp tools (formerly 'web'). Exempt URL-takers: open, fetch, search, tabs, status, close. Tab-bound verbs (navi...

- wk AI Tools

  Index for wk AI routing, budgets, and recovery. Read T1/T2/T3 as needed.

- wk AI Tools Budget

  Budget rules for cheap-first auto selection and cooldown handling.

- wk AI Tools Recovery

  Recovery notes for wrappers, cache files, and smoke tests.

- wk AI Tools Routing

  Routing map for wk AI wrappers and model aliases.

- wkappbot ask gpt zombie process -- 4-5 GB memory leak detection and fix

  ask gpt --timeout Ns can hang as a zombie consuming 4-5 GB RAM. Detection and immediate kill procedure.

- wkappbot find -- Tree Output Design & Grap Pitfalls

  Hard-won lessons from implementing find tree: grap candidate scoring, Afx MFC class detection, glob char-class pitfall...

- wkappbot windows -- focus flag and no-filter relevance mode

  Two new windows command modes: (1) --focus shows focused child hwnd + proper grap expression per window. (2) no-filter...

- wkedit -- Bulk Transaction Edit (Regex, Multi-File, Backup & Undo)

  wkappbot file edit supports regex substitution, auto .bak/ backup, undo, and encoding-safe transactions. Use this inste...

- wkedit find-pattern encoding hell: BOM + CRLF mismatch causes 'not found'

  wkappbot file edit --old-file pattern matching silently fails when old-file has BOM or CRLF/LF mismatch with target. wk...

- wkedit.sh Auto-Correction Design

  Design spec for wkedit.sh failure detection + arg correction + retry. Based on live test results 2026-05-18.

- wkharness agent bulletin (shared live steering channel for background agents)

  Design for a shared append-only bulletin file that all running background agents reference live, force-fed by a PostToo...

- wkharness-guards

  Guard cluster quick-ref for wkharness.ps1. One-liner per guard + escape hatch. Details in howto and ref skills.

- wkharness-guards How-To

  wkharness-guards per-guard unblock steps, escape hatch procedure, guard cascade recovery

- wktool QA pattern: token-efficient bug detection scripts

  How to write wkask/wkcdp-style QA scripts that find bugs cheaply. Key principle: state-check first (fast), eval-js seco...

- wktool pattern: token-efficient monitoring

  wk-tool scripts are QA-first tools: they detect bugs, validate state, and report anomalies cheaply so Claude never wast...

- wkwrap: AI-native .sh/.cmd wrapper auto-install

  Universal relay pattern for all wk*.ps1 tools. .sh for bash/Claude, .cmd for CMD/user, .ps1 for direct PS. wkwrap.sh --...

- wkzombie stall-guard delegation -- Opus works, Haiku blocked

  When stall-guard fires on repeated wkzombie runs, delegate to Opus Agent (not Haiku). Haiku subagents are blocked by wk...

- 레포 건강검진: 이슈·빈섹션·미답댓글 일괄 점검

  Periodic repo health check covering GitHub issues (close Daily reports, triage real bugs), unanswered issue comments, e...

- 막히면 삼두에 위임하라 (토큰 절약)

  구현 방법이 불확실하거나 버그 원인이 안 잡히면 삼두(GPT+Gemini+Claude)에 먼저 물어봐라. 삽질 30분보다 질문 1분이 낫다. Claude 혼자 추론하면 컨텍스트 낭비 -- 삼두에 위임하면 plann...

- 삼두 조언 -> 스킬로 저장

  삼두(ask triad)에서 얻은 유용한 인사이트는 바로 스킬로 저장. 다음 세션도 같은 고민 반복 안 하게. 오답노트+성공기록 = 집단지성 누적.

- 스킬 검색 커버리지 공식·최적화 가이드

  How wkappbot skill search ranks results: GlobCoverageScore formula, which fields count, why steps are invisible, and ho...

- 인수인계 받았을 때 체크리스트

  새 세션 시작 시 첫 5분이 전체 세션 효율을 결정한다. 순서 지켜서 빠르게 파악 후 슬랙 보고, 그 다음 바로 작업 돌입.

- 자동화 전 반드시 inspect 먼저

  타겟 요소 구조를 모르면 삽질 확정. 자동화 코드 짜기 전 wkappbot a11y inspect 로 UIA 트리 확인 필수. automation_id, class, 패턴 지원 여부 먼저 파악.

- 포커스리스 우선 원칙

  UIA Invoke/Value/Toggle/Select = 포커스 불필요. SendInput/Hotkey = EnsureFocus 필요. 포커스 탈취는 사용자 작업 방해 -- 항상 Focusless 먼저 시도.