atomic-tasks

Atomic Tasks — GSD パターン（Get Shit Done）

gsd-build/get-shit-done に着想を得たパターンです（Lex Christopherson による。Amazon／Google／Shopify／Webflow が採用）。

目的： 作業を新鮮なコンテキストを持つサブエージェントで実行するアトミックタスクに分割し、コンテキストの劣化（コンテキスト使用率が約50%を超えると品質が低下する現象）を防ぎます。

GSD パターンの5つのステップ

1. 作業を分割する — 分割

機能をアトミックなタスクに分割します。

• それぞれを1〜3文で表現できる
• それぞれを30分未満で完了できる
• それぞれを個別にテストできる
• それぞれをアトミックなコミット1つとしてコミットできる

❌ MAUVAIS : "Ajouter le système d'authentification"
✅ BON :
  1. "Créer la table users avec migration"
  2. "Implémenter POST /auth/register avec validation email"
  3. "Implémenter POST /auth/login retournant JWT"
  4. "Ajouter middleware JWT verification"
  5. "Tests d'intégration du flow login"

2. 小さな計画 — タスクごとの短い計画

各アトミックタスクについて、短い計画を立てます。

• 目標は1つ
• 手順は最大3〜5段階
• 成功基準を明確にする（テストが通る、エンドポイントが応答する、ファイルが存在するなど）

3. サブエージェントのコンテキストを新しくする — タスクごとに新しいコンテキストを使う

基本ルール： 各アトミックタスクは、新鮮なコンテキストを持つサブエージェントで実行します（Task tool を使うか、タスク間で /clear を実行します）。

理由	影響
開始時のコンテキスト使用率が30%未満	回答の品質が最大になる
前のタスクの残留情報がない	タスク間の混乱がゼロになる
トークンコストを最適化	蓄積したコンテキストを無駄に読み直さない
並列化が可能	複数のサブエージェントを同時に実行できる

実装：

• subagent_type=general-purpose または専門のサブエージェントを指定して Agent tool を使う
• 必要なコンテキストのみを渡す（プロジェクト全体は渡さない）
• 最後に簡潔な報告を求める（200語未満）

4. アトミックな Git コミット — アトミックなコミット

各タスクにつきコミットは1つです。2つのタスクを混ぜたコミットは絶対に作成しません。

✅ BON :
  commit 1 : "feat(auth): add users table migration"
  commit 2 : "feat(auth): implement register endpoint"
  commit 3 : "feat(auth): implement login endpoint"

❌ MAUVAIS :
  commit 1 : "feat: auth system + bug fixes + refactor"

メリット： git bisect が効果的になり、対象を絞ったリバートが可能になり、レビューが簡単になります。

5. 目標を検証する — 各目標を確認する

次のタスクに進む前に、目標が達成されたことを明示的に検証します。

• 作成したテストが通る
• エンドポイントが正しい HTTP コードで応答する
• ビルドが成功する
• リンターが通る
• ユーザーの操作に対する挙動を確認できる

ルール： 「動くと思う」では不十分です。証拠がなければ未完了です。

このパターンを適用すべき兆候

• コンテキスト使用率が50%を超えている
• 中間成果物がないまま、タスクが1時間以上続いている
• Claude の回答の精度が低下している
• すでに伝えたことを再説明する必要がある
• 1つの依頼に複数の責務が含まれている

避けるべきアンチパターン

アンチパターン	問題点
何でも詰め込むセッション	1つのセッションで全部行うと、コンテキストの劣化が避けられない
テストできないタスク	検証できず、決して「完了」にならない
複数タスクを混ぜたコミット	レビューができず、リバートも危険
タスク間でクリアしない	タスク間のコンテキストが混入する
過剰な計画	1行を変更するために10段階の手順を立てるのはオーバーヘッド

Claude Craft との統合

• /workflow:analyze — BMAD の分析フェーズでアトミックタスクを作成する
• /common:ralph-run — Ralph はループごとに1つずつ、アトミックタスクを反復処理する
• Agent tool — 複雑なタスクはそれぞれ、新しいコンテキストを持つサブエージェントに委任する
• Rule 12 (context-management) — 関連のないタスク間では /clear を必須とする
• Rule 23 (karpathy-principles) — タスクごとのコードを最小限にする

リソース

• gsd-build/get-shit-done
• Rule .claude/rules/01-workflow-analysis.md
• Rule .claude/rules/12-context-management.md
• Command /common:sub-agents-patterns

---

最終更新日： 2026-04-15 バージョン： 1.0.0