Katsuhiro Yamakawa

Katsuhiro Yamakawa

yktsnet

About

実装から来た人間ではない。
事業を回す側にいて、開発もやるようになった。
I didn't start out as an engineer.
I was running the business, and ended up building the systems myself.

学習塾を12年、合同会社を設立から清算まで経営してきた。いまは受託開発の企業に勤めながら、個人でも開発とコンサルを受け、マンション管理会社の外部CTOも務めている。必要になった仕組みや自分の開発基盤は、小さくOSSとして公開している。Twelve years running a tutoring school, and an LLC from founding to liquidation. Today I work at a contract development firm, take on development and consulting on my own, and serve as external CTO for a property management company, releasing the tools and development setup I build along the way as small open-source projects.

PRINCIPLES

  1. DECIDE経営からFrom management数字から直すものを決めるDecide what to fix from the numbers

    塾と会社の経営では税理士を立てず、決算まで自分でやってきた。だから事業の金がどこを通っているかを自分で読める。依頼を待たず、数字を見て直すものを決めるところから入る。Running the school and the company, I closed the books myself without an accountant, so I can read where the money moves in a business. I start from the numbers rather than from a brief.

  2. BUILD現場からFrom the floor現場のやり方を変えずに作るBuild without changing how people work

    塾でも会社でも、仕組みを作るのも毎日使うのも自分だった。手順を一つ増やせばそのまま自分の手間になるので、増やさずに回る形を先に考える。導入時に歓迎された機能が半年後には使われなくなるのも見てきたので、新しい操作を覚えさせず、自動化は既存の運用の裏側に差し込む。In both businesses, I built the systems and used them every day. Every extra step landed back on me, so I look first for a way to run things without adding steps. Having watched features welcomed at launch go unused six months later, I don't make people learn new operations; automation goes in behind the existing work.

  3. HAND OVER教育からFrom teaching回り出すまで付き合って渡すStay until it runs, then hand it over

    教えるときは、言って聞かせるより、生徒が自分で進められるよう場と段取りを整えるほうが続いた。仕組みも納めて終わりにせず、使われ方を見て合わないところを直し、現場で回り出すまで付き合う。In teaching, setting up the room and the sequence so students could move on their own lasted longer than telling them what to do. Systems are the same: delivery is not the end. I watch how they are used, fix what does not fit, and stay until they run on their own.

@Management

2013学習塾 開業Founded Tutoring School
2019合同会社 設立Established LLC
2024合同会社 清算Liquidated LLC
2025学習塾 閉業Closed Tutoring School

@Engineering

2025個人開発 / 外部CTOSolo Dev / External CTO
2026〜受託開発企業 / 個人受託・OSSContract Dev Firm / Freelance & OSS

CASE

人件費6割の根拠を、確かめる手段がなかったLabor was 60% of costs, with no way to check the hours behind it

マンション管理会社で会計を見ると、人件費が6割で、その根拠の勤務時間は自己申告だった。勤務の流れは変えずに、出退勤をカードをかざすだけにして、申告を記録に替えた。At a property management company, the accounts showed labor at 60% of costs, and the hours behind it were self-reported. Without changing the daily routine, clocking in became a single card tap, turning reports into records.

−5−5時間/月h/mo
管理者が勤怠の集計にかけていた時間Admin time spent tallying attendance
−3〜4−30–40k万円/月JPY/mo
打刻の偽装と記入漏れで出ていた給与の差異Payroll gap from faked or missed clock-ins
初日Day oneから
説明なしでスタッフ全員が使い始めたAll staff started using it with no instructions
その後の発展What followed
契約書の作成や法人化の相談も受けているNow also asked to help with contract paperwork and incorporation
Business会計・原価から手を付ける順番を決めるSetting priorities from accounting and cost structure

1人で設計・実装・運用Solo Design, Dev & Ops

Frontend
ReactVueTypeScript
Backend
C# (.NET)PythonGo
Data / AI
PostgreSQLLangGraphRAGText-to-SQL
Infra / SRE
NixOSTerraformCloudflareAWS
IoT
Raspberry PiEspressif

Services

開発を良くすることと、事務や採用を良くすること。
分かれていた2つを、同じエンジニアリングで変える。
Making development better, and making office work and hiring better.
Two things once kept apart, changed by the same engineering.

01OPERATIONS

事務作業の自動化Office Work Automation

現場のExcelや紙は変えずに、転記と集計だけを裏側で自動にする。どこを自動にすれば経費が減り、売上につながるかを、会計の数字を見ながら話すところから始める。The Excel and paper on the floor stay as they are; only the copying and tallying behind them are automated. It starts with looking at the accounts together to see where automation would cut costs or help sales.

  • 勤怠システムAttendance System
  • Excel帳票の書類管理Excel Document Management

マンション管理会社で稼働中。勤怠の集計 −5時間/月、説明なしで初日から定着Running at a property management company: −5 h/mo of attendance tallying, adopted on day one with no instructions

これまで導入後Excel・紙現場の入力Excel・ICカード現場の入力同じ流れ手で転記・集計月末と繁忙期に集中裏側で自動PDF・検索・給与集計

02AI DEVELOPMENT

AI開発の標準化と、採用・育成・評価Standardized AI Development, and Hiring, Growth & Evaluation

AIを使う開発の手順をそろえて配り(標準化)、そろった成果物と利用状況から一人ひとりの現在地を出す(可視化)。その同じ基準で、採用・育成・評価を決められる。I align and distribute the AI development process (standardization), then read where each person stands from the aligned output and usage (visibility). Hiring, growth and evaluation can then be decided on those same criteria.

  • AI駆動開発の標準化Standardizing AI-Driven Development
  • エンジニア評価制度づくりEngineer Evaluation System
  • 客先常駐の社員向けAI勉強会AI Study Group for Client-Site Staff

勤務先の開発会社で運用中。14のSkillで手順をそろえ、16の指標を毎日集計In use at the development company I work for: 14 skills align the process, 16 metrics tallied daily

開発マネジメント同じ基準で読む開発キット標準化そろった成果物と利用状況評価可視化育成次に伸ばす軸採用候補者も同じ基準

Workflow

AIと開発するときは、
顧客理解と実装を分けて行き来している。
When building with AI,
I separate and connect customer understanding and implementation.

AI で実装が速くなると、詰まるのは「何を作るか決めること」と「出力の検証」になる。答えを待たずに仮置きで試作して暗黙知を引き出し、作った者とは別の文脈で検証する。When AI makes coding fast, the bottlenecks shift to deciding what to build and verifying the output. I prototype on explicit assumptions without waiting for answers, and verify in a fresh context.

BIG PICTURE顧客理解と実装を分けてつなぐConnect customer understanding and implementation

利用者の慣れや書かれていない例外は、現場にしかない。顧客理解の担当を実装から切り離して現場と試作から何を作るかを決め、実装とは動く試作と問いでつなぐ。User habits and unwritten exceptions exist only on site. Customer Understanding stays apart from implementation and decides what to build from the site and prototypes, connected to implementation through working prototypes and questions.

UPSTREAM答えを待たずに「仮置き」で試作Prototype on explicit assumptions

先方の回答を待てば手が止まり、待たずに進めれば AI が黙って推測で埋める。未確定の点は仮置き一覧に分けて先に動く画面を見せ、並行して問いを照会・回収する。Waiting for client answers stalls the work; moving on without them lets AI fill gaps with silent guesses. Unknowns go into an assumption list so working screens can be shown first, while questions are sent and collected in parallel.

DOWNSTREAM約束を先に承認し、別文脈で判定Approve promises first, verify separately

自分で書いたテストで自分の実装を確かめると解釈が甘くなる。入口で完了条件(AC)と壊さない保証を承認し、出口では別文脈の確認者が証拠付きで判定する。Checking your own code with your own tests leads to lenient grading. Approve ACs and guarantees upfront, and verify in a separate session with test evidence.

Works

作ったものの一覧Everything I've Built

Services で紹介したもの以外の公開リポ。自分で使う道具、確かめるために作ったもの、移行のサンプルを分けずに並べている。Public repositories beyond those in Services: tools I use myself, things built to find something out, and migration samples, listed together.

01ccreel

全端末の Claude Code の会話を1か所に集め、1つの一覧から探して再開できる CLI。同梱の skill で、Claude Code 自身も過去の会話を引ける。Gathers Claude Code conversations from every machine into one list to find and resume. A bundled skill lets Claude Code look up past sessions too.

devtools2026.10

02codeview

手元の git リポジトリと Issue を、自分だけが読めるコードブラウザにする。スマホで読んだ箇所をエージェントへ渡せる。Turns local git repos and issues into a private code browser served on Cloudflare. What you read on your phone can go straight to an agent.

devtools2026.10

03tg-dev-digest

はてブ・Zenn・GitHub Trending から Claude Haiku が記事を選び、毎日 Telegram へ届ける。サーバーは置かない。Claude Haiku picks articles from Hatena, Zenn, and GitHub Trending and sends them to Telegram daily, with no server to run.

ai2026.09

04etax-prep

会社員の副業のための帳簿。金額と勘定科目を入れるだけで、複式簿記・家事按分・給与との合算を導き、確定申告に転記できる集計まで出す。Books for a salaried worker's side business. Enter an amount and an account; double-entry, apportionment, and the salary merge are derived, down to tax return totals.

finance2026.08

05folio-agent

このサイトの受付チャットを動かす npm パッケージ。ページや記事から知識をビルド時に作るので、手で更新しなくてよい。The npm package behind this site's chat. Knowledge is built from the pages, Zenn articles, and GitHub READMEs at build time, so nothing is updated by hand.

ai2026.07

06drip-sim-public

複数の売買戦略を8段のバックテストで横断して検証し、ドローダウンと Recovery Factor で順位を付けて、落ち込みにくい候補を選び続ける。Backtests many trading strategies across 8 stages and ranks them by drawdown and Recovery Factor, to keep picking candidates that hold up.

trading2026.07

このサイトと、制作の経緯を書いたZenn(技術記事の投稿サイト)の記事、サイトで紹介しているGitHubのリポジトリの説明をもとにAIが答えますAI answers from this site, my articles on Zenn (a tech blogging platform) about how each project was built, and the READMEs of the GitHub repos featured here