dev-impl

A test-first implementation skill for carrying out a planned task or a small direct code change. TDD means writing a test before the code that makes it pass.

In plain words
What is it for?
Use it to implement one planned task or make a quick fix, with tests, refactoring, and TypeScript checks included.
Why use it?
It provides a repeatable path from a failing test to a working implementation and then checks the result for quality issues.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/classmethod/tsumiki/dev-impl
Any agent
npx skills add classmethod/tsumiki --skill dev-impl
Clone the repo
git clone --depth 1 https://github.com/classmethod/tsumiki

Made for: Claude Code, Codex.

Per session 108 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,919 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00108 $0.02919
Opus 5 $0.00054 $0.01460
Sonnet 5 $0.00022 $0.00584
Haiku 4.5 $0.00011 $0.00292

Measured 2d ago against content hash 6dcec6b687f4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

dev-impl scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/dev-impl/SKILL.md · 243 lines

How it starts

The opening of the file, as written. The whole thing — 243 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Dev Impl

TDDをガードレールとして、テストを先に書いてから実装するコアワークフロー。タスクファイルに基づく通常モードと、Plan不要の軽量クイックモードの2つの実行モードを持つ。

前提知識

dev-*スキルフロー内の位置

dev-context → dev-plan → [dev-impl] → dev-verify
                                  ↘ dev-debug (失敗時)

実行モード

モード 引数 用途
通常モード <plan-name> <task-id> Planのタスクを1つ実装
クイックモード "修正指示" 軽量な修正・調整(Plan不要)

品質優先のプライオリティ

品質 > 速度 > トークン消費 の順で判断する。

ワークフロー: 通常モード

/dev-impl <plan-name> <task-id> で実行。

Step 1: コンテキスト構築(最小限)

インターフェースファーストで必要最小限のファイルだけ読み込む:

優先順位:
1. docs/dev/context.md(プロジェクト全体像)
2. タスクファイル(インターフェース定義・テスト方針)
3. 関連する型定義ファイル ← 必要時のみ
4. 関連する既存テストファイル(パターン参考)← 必要時のみ
5. 実装ファイル(関連関数のみ)← 必要時のみ

TodoWrite でタスク進捗のトラッキングを開始する。

Step 2: テストケース生成(Red)

タスクファイルの Test Strategy に基づきテストコードを生成する:

  1. 既存テストファイルのパターン(context.mdの規約)に合わせる
  2. タスクのインターフェース定義に基づくテストケースを記述する
  3. テスト実行コマンド(context.md から取得)でテストを実行する
  4. 失敗を確認する(Red状態)

テストが先に通ってしまう場合は、要件やテストの妥当性を再確認する。

Step 3: 実装(Green)

テストを通す最小限の実装を生成する:

  1. インターフェース定義に準拠したコードを書く
  2. Intent コメントを付与する(後述の「Intent コメントルール」に従う)
  3. テスト実行 → 成功を確認する(Green状態)
  4. 失敗した場合はエラーを分析し修正する(最大3サイクル)
  5. 3サイクルで解決しない場合は /dev-debug の使用を案内する

Step 4: リファクタリング + 品質チェック

テストがGreenの状態で以下を実行する:

4a. 500行ルール(厳密適用)

関連するすべてのファイルの行数を Bash で確認する(絶対パスを使用):

wc -l "$(git rev-parse --show-toplevel)/<ファイルの相対パス>"

500行を超えるファイルがある場合:

  • 責務の境界で分割する(Single Responsibility Principle)
  • テストファイルも対応して分割する
  • インポート/エクスポートの整合性を維持する
  • 分割後にテストを再実行する
4b. セキュリティチェック

実装コードを確認し、以下の問題がないか検証する:

  • インジェクション(SQL, コマンド, XSS)
  • 認証・認可チェックの漏れ
  • 機密情報のログ出力・エラーメッセージでの露出
  • ユーザー入力のバリデーション不足
4c. パフォーマンスチェック
  • N+1問題(ループ内のDB/APIクエリ)
  • メモリリーク(イベントリスナー未解除、クロージャ参照保持)
  • 非効率なアルゴリズム(O(n^2)以上で改善可能な箇所)
4d. コード品質
  • 重複コードの排除
  • 命名の改善
  • 不要なコメントの削除
4e. カバレッジチェック
  1. docs/dev/context.md の Test Framework セクションから Coverage Threshold を取得する
  2. タスクファイルの Files セクションから対象パッケージを特定する
  3. パッケージごとにカバレッジを計測する(Coverage Command をパッケージ単位で実行)
  4. [no test files] は 0% として扱う
  5. 閾値未達時: テストを追加し再計測する(最大3サイクル)
  6. 3サイクル後も未達: 🟡 として報告し続行する(ブロッキングにしない)

Read the full file on GitHub · 243 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 243 lines · 108 tokens per session scan A 6dcec6b687f4

Subscribe to this mod's changes

dev-impl is a skill published in the GitHub repository classmethod/tsumiki (974 stars, last pushed 25d ago), licensed MIT. It adds 108 tokens to every session and 2,919 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

babysit-pr

Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…

openai/codex · 114 tokens

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output…

openai/codex · 113 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

next-cache-components-optimizer

Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…

vercel/next.js · 170 tokens