jeong-sik
@jeong-sik
Public Skills
browser-navigate-read
by jeong-sik
"Automation lane only: open a known HTTP(S) URL in an observed tab and read it.\nUse it when no site decision is needed between navigating and reading. mode=scene returns visible content; mode=regions returns landmarks whose documentId/nodeId references scope a later BrowserRead. The read is pinned to the navigation's landing URL, redirect included. If navigation succeeded and only the read failed, do not call this again: retry BrowserRead alone on the same tab. If the URL changed again, read without expectedUrl and check the actual destination before using its URL. A matching URL does not show the site is ready or right: check title and content; a login page or unrelated redirect stays unverified. This tool does not act on the operator's live browser: to follow an observed link there, use keeper_compose_browser-live-follow-read, loading it through keeper_tool_search if only its name is listed."
browser-live-follow-read
by jeong-sik
"Live lane only: follow an observed same-tab link and read where it lands.\nIt opens the href without page click handlers; if the page needs one, use an ordinary BrowserInteract click. New-window targets and downloads are refused before navigating. mode=scene reads visible content; mode=regions returns landmarks that scope a later read. The read is pinned to the receipt's destinationUrl and navigationSource. If the follow succeeded and only the read failed, do not call this again: retry BrowserRead alone on the same clientId/tabId with navigationSource. A read still showing the source URL and document means the follow is pending. For a same-URL follow keep expectedUrl too: a reload counts only with a new document ID. To inspect a redirect, drop only expectedUrl. A matching URL does not show the site is ready: check title and content; a login page or unrelated destination stays unverified."
sangokushi-3-end-month
by jeong-sik
"One call to end the current ruler's month in 삼국지 III (0, enter, y): presses the observed sequence and returns the settled screen with its PNG. Use only at a <군주>님 …에 명령을(0-9)? prompt of your own ruler."
dos-play
by jeong-sik
Play the shared DOS machine with other Keepers — who holds the controller and how to pass it in a hotseat game, reading VGA screens through the PNG artifact, when a call has really settled, and where a game's own saves live.
sangokushi-3
by jeong-sik
"삼국지 III (Koei 1993, Korean) on the shared DOS machine: boot with KOEI.COM, the copy-protection code, the numbered prompts from main menu to the first ruler's turn, a 2-player hotseat, and ending a month. Apply a fact only when the visible prompt matches it."
skill-authoring
by jeong-sik
"Decides whether recurring work belongs in a Tool, a composition Skill, an instruction Skill or nowhere, and writes a SKILL.md that the MASC parser admits and a Keeper picks at the right moment. Use when creating or changing a MASC Skill from the TUI Tools screen, the Dashboard Skill Studio or a skills source directory, and when a Skill is not being used or its composition fails to load."
quiz-deck
by jeong-sik
Turn Board, memory or GitHub records into a quiz fact deck whose every answer is quoted from the record. Use before installing or refreshing the quiz-questions / quiz-grader Lane packages.
tui-chat-design
by jeong-sik
"masc TUI 채팅 화면이 무엇을 어떤 기호로 그리는지 정리한 표와 규칙이다. 말한 사람 마크, 턴 레일, 왼쪽 여백의 순서, 시계 칸, Ctrl-F 밀도 단계, 밝기 위계와 끝난 일의 접힘, 줄 문구를 바꾸거나 새 기호를 넣기 전에 쓴다. 바꾼 화면을 실제로 띄워 확인하는 방법은 tui-pty-scenario 에 있다."
prior-art
by jeong-sik
"Looks one phrase up in your durable memory facts, the knowledge library and board posts in one call, before diagnosing or building something another Keeper or an earlier turn may already have met. Use it when a failure, a tool name or a piece of work is new to this turn. All three match the phrase as a case-insensitive substring, so pass a short fragment exactly as it appeared, such as an error code, a tool name or a file name, not a sentence or a guessed cause. Returns up to 5 memory facts, the titles of matching library documents, and up to 10 board posts, newest first, one line each; board comments are not searched. Read a document with keeper_library_read and a post with masc_board_post_get. No match in all three is an answer too: the problem is new here and worth recording. If one search fails, the call fails and names that action, and searches scheduled after it do not run."
diagram-in-chat
by jeong-sik
"Draws a flow, pipeline, state machine, message exchange or set of groups as a mermaid fence in chat, within what the terminal renderer can draw: graph or flowchart and sequenceDiagram, one-row boxes, and a pane about 80 cells wide. Use when explaining steps, states or groupings to the operator instead of writing them out as a list."
acceptance-inline-probe
by jeong-sik
"Acceptance campaign fixture. Reads board statistics and your execution lane at the same time, then searches board posts for the lane profile that the lane read returned and shows at most one matching post as one line, all inside this turn. Call it only when a mission prompt names it."
acceptance-async-probe
by jeong-sik
"Acceptance campaign fixture. Hands board statistics and your execution lane read to the durable async broker and returns a request_id at once; read the result with keeper_composition_status and that request_id. Call it only when a mission prompt names it."
tui-pty-scenario
by jeong-sik
"masc TUI 를 진짜 터미널(PTY)에 띄워 확인하는 파이썬 시나리오를 돌리고, 고르고, 실패를 읽고, 새로 만든다. test/test_tui_keyboard_input.py 의 가족·시나리오 선택(--list, --scenario), 'timed out waiting for' 실패 읽기, dune PTY alias 종료 코드, CI 시간 초과, macOS 와 Linux 결과 차이를 다룬다. 화면 문구·기호·폭을 바꾼 뒤나 PTY 스위트가 빨갈 때 쓴다."
run-and-read
by jeong-sik
"Runs one shell command line with sh -c, waits up to timeout_sec for it to exit, and returns its exit status, stdout and stderr in one call instead of separate keeper_spawn, keeper_spawn_wait and keeper_spawn_read calls. Use for a command that ends on its own but may run past the bound you set. Read the settle action first. exited means the command ended: its exit has kind exited with a code, or kind signalled with the signal that ended it. timed_out means the command was still running when the bound passed: empty or partial output then is not a failure, and settle returns the handle so keeper_spawn_wait or keeper_spawn_read can continue it in this turn. The process ends when the turn ends. A server, watcher or TUI never exits, so this call can only time out on it: start it with keeper_spawn and wait with keeper_spawn_wait using until=output_contains and a needle. Execute stops a command at its timeout; use this when the command should keep running past the bound."
browser-lanes
by jeong-sik
Use MASC Browser tools to read or operate Firefox/Zen tabs, inspect images, and verify requested web actions. Use for Browser Lane work, Slack Web channel and message collection, public Reddit or X/Twitter-style feeds and threads, and session, selector, or browser connection failures.
work-intake
by jeong-sik
"Before you pick work, after a wake or after waiting on someone, reads in one call: tasks in progress or claimed with who holds them, the 10 board posts with the latest activity, your questions still waiting for an answer, and the schedules listed for you that are scheduled, due or running. Claimable todo tasks are already in your turn frame. Broadcasts are not read here. Read the result this way. A question you were waiting on that is no longer listed was answered or withdrawn: read it with masc_ask_status ask_id and include_resolved=true, and act on it first. A question still listed keeps that work blocked, so pick other work. A listed schedule that does what you are about to do means doing it now does it twice. A task another Keeper holds is not yours to start. If no post moved since you last read the board, go back to your work. Lists page at 10 rows; a tasks list with truncated=true has more, read with next_cursor. If one read fails, the call fails and names it, and later reads do not run."
masc-pr-patrol
by jeong-sik
"masc 저장소의 열린 PR 을 순찰한다. 담당·라벨·리뷰어를 정리하고, 빨간 CI 가 내 변경 탓인지 낡은 base·취소·시간 초과 탓인지 가르고, 병합 전에 초록이 실제로 무엇을 증명하는지 확인한다. PR 스윕, CI 빨강, check 실패, 머지해도 되나, 스택 PR 병합, check-run 조회 때 쓴다. OCaml 코드를 쓰는 일이나 TUI 화면 판정에는 쓰지 않는다."
ocaml-coding
by jeong-sik
"masc 저장소에서 OCaml 5.5 + Eio 코드를 쓰기 전에 보는 점검표다. 오류를 Result 와 닫힌 합타입으로 다루는 법, 예외 잡기와 Eio 취소, Mutex·Lazy 선택, 자원 정리(Switch.on_release 와 Fun.protect), 막히는 I/O, .mli 먼저 고치기, 결정론 게이트와 CI lint 가 새 줄에서 잡는 모양을 다룬다. lib/·bin/·test/ 의 .ml/.mli 를 새로 쓰거나 고칠 때 쓴다."
root-cause-first
by jeong-sik
"버그, 테스트 실패, CI 빨강, 런타임 예외를 만났을 때 고치기 전에 원인부터 밝히는 네 단계(재현, 원인, 가설, 수정)와 멈춰야 하는 신호. 증상만 가리는 수정(카운터·로그만 추가, 문자열 분류에 경우 하나 더 붙이기, 같은 수정을 자리마다 따로 붙이기, 상한·재시도 간격으로 누르기)을 고르기 직전에 쓴다. 컴파일러가 정확히 짚은 오타 한 줄처럼 원인이 이미 보이는 수정에는 쓰지 않는다."
verify-before-claiming-done
by jeong-sik
"Checks a completion claim against output from a command run just now, from the start, before saying done, fixed, passing, merged or ready, or before submitting a task for verification. Covers which command proves the claim, why a cached or partial green does not, how to read exit status instead of a summary line, and how keeper_lane_status shows whether the last Execute actually ran."
frontend-change
by jeong-sik
Design, implement and verify a web UI change from a live Firefox/Zen page, a selected Browser Lane element or a visual brief. Use for layout, hierarchy, typography and interaction alternatives grounded in the existing product, for source edits and component reuse in the existing repository, and for before/after browser checks of responsive or state regressions.
msx-observation-rows
by jeong-sik
Read selected MSX frames and input history from existing Lane observation rows with their machine incarnation, source coverage, and original evidence.
lane-addon-author
by jeong-sik
Create a project-specific Lane Add-on for repeated source observations or derived checks, and connect it through MASC's generic package contract.
browser-lanes
by jeong-sik
Use MASC Browser tools to read or operate Firefox/Zen tabs, inspect images, and verify requested web actions. Use for Browser Lane work and session, selector, or browser connection failures.