https://shuu11-dev.pages.dev In-depth technical articles on Claude Code, MCP, agent development, Rust, and embedded systems. https://shuu11-dev.pages.dev/articles/agent-task-boundary-notes-before-implementation/ How to reduce AI coding agent rework by writing clear goal, scope, do-not-change, and verification boundaries before implementation starts. en Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/agent-task-boundary-notes-before-implementation/ https://shuu11-dev.pages.dev/ja/articles/agent-task-boundary-notes-before-implementation/ AIエージェントに実装を任せる前に、変更範囲、触らない領域、検証条件を短く書くことで、手戻りと不要な改修を減らす方法を解説します。 ja Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/agent-task-boundary-notes-before-implementation/ https://shuu11-dev.pages.dev/articles/environment-dependent-bugs-dont-start-with-code-fix/ How to diagnose Windows, OneDrive, Node.js, and Next.js environment-dependent failures before changing application code. en Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/environment-dependent-bugs-dont-start-with-code-fix/ https://shuu11-dev.pages.dev/ja/articles/environment-dependent-bugs-dont-start-with-code-fix/ Windows、OneDrive、Node.js、Next.jsで起きる環境依存バグを、コードの問題と決めつけずに切り分ける手順を解説します。 ja Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/environment-dependent-bugs-dont-start-with-code-fix/ https://shuu11-dev.pages.dev/articles/mcp-tool-description-ai-interface-design/ How to write MCP tool descriptions, argument schemas, return notes, and errors so AI agents choose and call tools correctly. en Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/mcp-tool-description-ai-interface-design/ https://shuu11-dev.pages.dev/ja/articles/mcp-tool-description-ai-interface-design/ MCPツールのdescriptionや引数説明を、AIが正しく選びやすいUIとして設計する考え方を、悪い例と改善例で解説します。 ja Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/mcp-tool-description-ai-interface-design/ https://shuu11-dev.pages.dev/articles/nextjs-rss-xml-escaping-static-site/ Why custom RSS feeds in static Next.js sites break when titles or descriptions are not XML-escaped, and how to verify feed output. en Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/nextjs-rss-xml-escaping-static-site/ https://shuu11-dev.pages.dev/ja/articles/nextjs-rss-xml-escaping-static-site/ Next.jsの静的サイトでRSSフィードを自前生成する時に、タイトルやdescriptionのXMLエスケープ漏れで壊れる理由と確認方法を解説します。 ja Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/nextjs-rss-xml-escaping-static-site/ https://shuu11-dev.pages.dev/articles/npm-install-devdependencies-skipped-node-env-production/ Why npm install or --save-dev can appear to succeed while devDependencies are missing, and how to recover with NODE_ENV checks and --include=dev. en Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/npm-install-devdependencies-skipped-node-env-production/ https://shuu11-dev.pages.dev/ja/articles/npm-install-devdependencies-skipped-node-env-production/ npm installや--save-devが成功表示なのにdevDependenciesが入らない時に、NODE_ENV=productionを確認して--include=devで復旧する手順です。 ja Wed, 01 Jul 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/npm-install-devdependencies-skipped-node-env-production/ https://shuu11-dev.pages.dev/articles/powershell-bash-variable-expansion-where-object/ Why PowerShell commands with Where-Object and $_ break when launched through Bash, and how to avoid cross-shell variable expansion bugs. en Tue, 30 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/powershell-bash-variable-expansion-where-object/ https://shuu11-dev.pages.dev/ja/articles/powershell-bash-variable-expansion-where-object/ BashやGit BashからPowerShellのWhere-Objectを呼ぶ時に、$_や$変数が先に展開されて壊れる原因と回避策を解説します。 ja Tue, 30 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/powershell-bash-variable-expansion-where-object/ https://shuu11-dev.pages.dev/articles/typescript-vscode-cannot-find-settimeout-tsc-passes/ Why VS Code TypeScript can report missing Node globals while tsc passes, and how explicit types: node fixes the language server. en Mon, 29 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/typescript-vscode-cannot-find-settimeout-tsc-passes/ https://shuu11-dev.pages.dev/ja/articles/typescript-vscode-cannot-find-settimeout-tsc-passes/ TypeScriptでtscは通るのにVS CodeだけNode.jsのグローバル型を見失う時に、types: [node]で直す理由を解説します。 ja Mon, 29 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/typescript-vscode-cannot-find-settimeout-tsc-passes/ https://shuu11-dev.pages.dev/articles/windows-path-containment-validation-nodejs/ How to validate that a user path stays inside a root directory on Windows without being fooled by drive-relative, UNC, case, or traversal paths. en Sun, 28 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/windows-path-containment-validation-nodejs/ https://shuu11-dev.pages.dev/ja/articles/windows-path-containment-validation-nodejs/ Windowsでユーザー指定パスがroot配下にあるかを、drive-relative、UNC、大小文字、.. traversalに騙されず検証する方法です。 ja Sun, 28 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/windows-path-containment-validation-nodejs/ https://shuu11-dev.pages.dev/articles/nextjs-localstorage-hydration-guard-usehooks-ts/ How to avoid Next.js localStorage hydration bugs with usehooks-ts, typed defaults, dependency arrays, and a guard for effects derived from stored values. en Sat, 27 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/nextjs-localstorage-hydration-guard-usehooks-ts/ https://shuu11-dev.pages.dev/ja/articles/nextjs-localstorage-hydration-guard-usehooks-ts/ Next.jsでusehooks-tsのuseLocalStorageを使う時に、hydration前のdefault値でeffectが走る問題とguardの入れ方を解説します。 ja Sat, 27 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/nextjs-localstorage-hydration-guard-usehooks-ts/ https://shuu11-dev.pages.dev/articles/git-bash-json-backslash-escaping-windows/ Why Windows backslashes can turn into tabs when writing JSON through Git Bash inline commands, and why file-based scripts are safer. en Fri, 26 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/git-bash-json-backslash-escaping-windows/ https://shuu11-dev.pages.dev/ja/articles/git-bash-json-backslash-escaping-windows/ Git BashでWindowsパス入りJSONを書く時に、バックスラッシュがタブ化する問題と、script fileに逃がす安全策を解説します。 ja Fri, 26 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/git-bash-json-backslash-escaping-windows/ https://shuu11-dev.pages.dev/articles/nextjs-routes-manifest-missing-parallel-build/ A practical guide to diagnosing missing .next/routes-manifest.json errors caused by concurrent next build processes writing to the same .next directory. en Thu, 25 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/nextjs-routes-manifest-missing-parallel-build/ https://shuu11-dev.pages.dev/ja/articles/nextjs-routes-manifest-missing-parallel-build/ Next.jsの.next/routes-manifest.json欠落エラーが、設定ミスではなく同じ.nextへ並列next buildした競合で起きるケースを解説します。 ja Thu, 25 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/nextjs-routes-manifest-missing-parallel-build/ https://shuu11-dev.pages.dev/articles/windows-onedrive-node-modules-junction/ How to keep a Node.js project inside OneDrive while moving node_modules to an external folder with a Windows junction. en Thu, 25 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/windows-onedrive-node-modules-junction/ https://shuu11-dev.pages.dev/ja/articles/windows-onedrive-node-modules-junction/ WindowsのOneDrive配下でNode.js開発が壊れる時に、node_modulesを外部フォルダへ移してjunctionで戻す手順を解説します。 ja Thu, 25 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/windows-onedrive-node-modules-junction/ https://shuu11-dev.pages.dev/articles/mcp-stdio-server-logging-stderr/ Why MCP stdio servers should avoid console.log, keep stdout clean for JSON-RPC, and send diagnostic logs to stderr instead. en Wed, 24 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/mcp-stdio-server-logging-stderr/ https://shuu11-dev.pages.dev/ja/articles/mcp-stdio-server-logging-stderr/ MCP stdioサーバーでconsole.logを避け、ログをstderrへ出すべき理由を、stdoutがJSON-RPC通信路になる仕組みから解説します。 ja Wed, 24 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/mcp-stdio-server-logging-stderr/ https://shuu11-dev.pages.dev/articles/powershell-node-modules-junction-new-item/ Why PowerShell New-Item -ItemType Junction is safer than mklink for node_modules junctions, especially in Unicode Windows paths. en Wed, 24 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/powershell-node-modules-junction-new-item/ https://shuu11-dev.pages.dev/ja/articles/powershell-node-modules-junction-new-item/ Windowsでnode_modules junctionを作る時に、mklinkではなくPowerShellのNew-Item -ItemType Junctionを使う理由を解説します。 ja Wed, 24 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/powershell-node-modules-junction-new-item/ https://shuu11-dev.pages.dev/articles/mcp-markdown-knowledge-server-design/ How to design an MCP server for a Markdown knowledge base, why raw Markdown is better than HTML, and how to share one source across clients. en Tue, 23 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/mcp-markdown-knowledge-server-design/ https://shuu11-dev.pages.dev/ja/articles/mcp-markdown-knowledge-server-design/ MCPサーバーでMarkdown知識ベースを扱うとき、HTMLへ変換せずraw Markdownを返す設計がなぜ保守しやすいかを解説します。 ja Tue, 23 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/mcp-markdown-knowledge-server-design/ https://shuu11-dev.pages.dev/articles/vite-node-build-post-emit-crash-check/ How to distinguish a real Vite build failure from a Windows post-emit crash by cleaning dist and checking fresh generated files. en Tue, 23 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/vite-node-build-post-emit-crash-check/ https://shuu11-dev.pages.dev/ja/articles/vite-node-build-post-emit-crash-check/ WindowsでVite buildがemit後にクラッシュする時に、古いdistを成功扱いしないための鮮度チェック手順を解説します。 ja Tue, 23 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/vite-node-build-post-emit-crash-check/ https://shuu11-dev.pages.dev/articles/cloudflare-pages-git-vs-direct-upload/ How to choose between Cloudflare Pages Git integration and Wrangler Direct Upload before project creation, and why the choice affects deployment workflow. en Mon, 22 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/cloudflare-pages-git-vs-direct-upload/ https://shuu11-dev.pages.dev/ja/articles/cloudflare-pages-git-vs-direct-upload/ Cloudflare PagesのGit連携とWrangler Direct Uploadの違い、production/previewの扱い、選び方を解説します。 ja Mon, 22 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/cloudflare-pages-git-vs-direct-upload/ https://shuu11-dev.pages.dev/articles/next-dev-css-parse-error-node-env-production/ Why next build passes but next dev fails with a CSS parse error in Next.js, how to detect NODE_ENV pollution, and how to fix it for good. en Mon, 22 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/next-dev-css-parse-error-node-env-production/ https://shuu11-dev.pages.dev/ja/articles/next-dev-css-parse-error-node-env-production/ Next.jsでnext buildは通るのにnext devだけCSSパースエラーになる原因と、NODE_ENV汚染の調べ方・直し方を解説します。 ja Mon, 22 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/next-dev-css-parse-error-node-env-production/ https://shuu11-dev.pages.dev/articles/claude-code-mcp-config-not-loading/ A focused checklist for Claude Code MCP servers that do not appear or do not respond after editing configuration. en Sun, 21 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/claude-code-mcp-config-not-loading/ https://shuu11-dev.pages.dev/ja/articles/claude-code-mcp-config-not-loading/ Claude CodeでMCPサーバーを設定したのに出ない時に、設定場所、絶対パス、再起動、mcp__ツール名を確認する手順です。 ja Sun, 21 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/claude-code-mcp-config-not-loading/ https://shuu11-dev.pages.dev/articles/nextjs-static-export-pitfalls/ Five common gotchas when exporting a Next.js 15 app with output: export — force-static metadata routes, no next/og, trailingSlash, and next/image — with fixes. en Sun, 21 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/nextjs-static-export-pitfalls/ https://shuu11-dev.pages.dev/ja/articles/nextjs-static-export-pitfalls/ Next.js 15をoutput: exportで静的書き出しする際にハマるforce-static必須・next/og非対応・trailingSlash・next/imageなど5つの罠と回避策を実例で解説します。 ja Sun, 21 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/ja/articles/nextjs-static-export-pitfalls/ https://shuu11-dev.pages.dev/articles/tauri-v2-ipc-type-bridging/ How to prevent silent Tauri v2 IPC bugs by making Rust serde names, TypeScript interfaces, optional values, and verification steps explicit. en Sat, 20 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/tauri-v2-ipc-type-bridging/ https://shuu11-dev.pages.dev/articles/tauri-optimistic-ui-race-prevention/ A practical pattern for Tauri React apps: set UI state before async IPC, split cleanup from action errors, and show recoverable failures clearly. en Fri, 19 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/tauri-optimistic-ui-race-prevention/ https://shuu11-dev.pages.dev/articles/tauri-plugin-sql-rust-sqlx-pattern/ How to choose between tauri-plugin-sql's JavaScript API and sqlx in Rust commands when building Tauri v2 apps with SQLite. en Thu, 18 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/tauri-plugin-sql-rust-sqlx-pattern/ https://shuu11-dev.pages.dev/articles/vite-env-cache-patterns/ How to debug Vite env variables that appear stale, why .env changes require restart, and when to clear Vite's module cache. en Wed, 17 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/vite-env-cache-patterns/ https://shuu11-dev.pages.dev/articles/react-ime-composition-guard/ How to stop Enter, arrow keys, and dropdown shortcuts from firing too early while Japanese IME composition is still active in React. en Tue, 16 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/react-ime-composition-guard/ https://shuu11-dev.pages.dev/articles/css-layout-measurement-gotchas/ How to debug browser layout bugs caused by CSS zoom, transform, getBoundingClientRect, min-width:auto, and inline style overrides. en Mon, 15 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/css-layout-measurement-gotchas/ https://shuu11-dev.pages.dev/articles/webgl-canvas-foreignobject-taint/ Why SVG foreignObject rasterization can taint a canvas in Chromium, how to detect it, and why Canvas 2D rendering is safer for WebGL textures. en Sun, 14 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/webgl-canvas-foreignobject-taint/ https://shuu11-dev.pages.dev/articles/rust-lossy-utf8-byte-offset/ Why Rust stream readers should find byte offsets on raw bytes before using from_utf8_lossy, especially for log tailing and partial UTF-8 chunks. en Sat, 13 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/rust-lossy-utf8-byte-offset/ https://shuu11-dev.pages.dev/articles/notify-windows-callback-thread/ How to keep Rust notify watchers responsive on Windows by doing bounded work in callbacks and moving heavy parsing out of the event path. en Fri, 12 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/notify-windows-callback-thread/ https://shuu11-dev.pages.dev/articles/webview2-v8-memory-diagnosis/ How to avoid false memory-leak diagnoses in WebView2 apps by comparing Task Manager RSS, V8 heap snapshots, and high-frequency state updates. en Thu, 11 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/webview2-v8-memory-diagnosis/ https://shuu11-dev.pages.dev/articles/vitest-tauri-zustand-store-testing/ How to test Tauri-backed Zustand stores in Vitest with jsdom, __TAURI_INTERNALS__ mocks, module reset, fake timers, and parity tests. en Wed, 10 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/vitest-tauri-zustand-store-testing/ https://shuu11-dev.pages.dev/articles/web-crypto-randomuuid-secure-context/ Why crypto.randomUUID works on localhost but can fail on LAN HTTP, and how to generate browser UUIDs with a secure getRandomValues fallback. en Tue, 09 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/web-crypto-randomuuid-secure-context/ https://shuu11-dev.pages.dev/articles/frozen-api-transport-layer-fallback/ A testing pattern for runtimes that freeze high-level APIs: confirm descriptors, find the underlying transport, and intercept fetch or messages instead. en Mon, 08 Jun 2026 00:00:00 GMT https://shuu11-dev.pages.dev/articles/frozen-api-transport-layer-fallback/