mcpField
I
implement_plan_micro

implement_plan_micro

github.com/parcadei開発3.9k479 回インストール39 週間前に更新
リポジトリ

implement_plan_micro について

ソフトウェア実装計画を段階的に進め、タスクを連携させるための形式仕様です。5種類のモーダル論理を組み合わせ、読み込み、検証、引き継ぎ、復旧の要件を定めています。

主な機能

  1. 015種類のモーダル論理の統合
  2. 02計画とファイルの完全な読み込み要件
  3. 03フェーズ順序と検証要件の定義
  4. 04直接実行とオーケストレーションの記述
  5. 05引き継ぎと追跡の形式指定
  6. 06ブロッカー対応と復旧手順

活用シーン

  1. 01段階的な実装作業の構成
  2. 02フェーズ間でのタスク状況の引き継ぎ
  3. 03自動・手動検証の手順指定
  4. 04セッション圧縮後の作業再開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill implement_plan_micro

インストール後、Claude Code で/implement_plan_microを入力して読み込まれたか確認します。

詳細

形式仕様

マルチモーダル論理の統合

橋渡し原理との融合による5つの様相論理:

  • JL:正当化論理 — 証拠に裏付けられた主張
  • IEL:推論的問答論理 — 質問の処理
  • TEL:時間的認識論理 — フェーズの順序付け
  • SDL:標準義務論理 — 義務/許可
  • DEL:動的認識論理 — 行為の様相

正当化論理(JL)

# Justification terms
[h]:context(task_n)                    # Handoff h justifies task context
[v]:verified(phase_n)                  # Verification v justifies completion
[p]:plan(tasks)                        # Plan p justifies task list

# Evidence production
[read(f)]exists e. [e]:content(f)
[verify(c)]exists v. [v]:pass(c) | [v]:fail(c)

# Handoff chain: evidence propagates
[h_n]:complete(task_n) -> [h_{n+1}]:context(task_{n+1})
proceed(task) <-> exists h. [h]:validated

推論的問答論理(IEL)

# Mode and blocker questions
?{direct, orchestration}               # Mode selection
?{continue, retry, ask_user}           # Blocker resolution
mismatch(plan, reality) -> ?{how_proceed}
no_validation -> ?{run_validation_first}

時間的認識論理(TEL)

# File reading constraints
[](mentioned(f) -> <>read_fully(f))           # Eventually read
[](mentioned(f) -> not spawn U read_fully(f)) # No spawn until read
[](partial_read(f) -> false)                  # Partial reads forbidden

# Phase sequencing
[](phase(n) -> P(phase(n-1) & verified(n-1))) # Verified before next
[](automated_pass -> <>manual_verify)         # Automated gates manual
[](manual_pass(n) -> <>phase(n+1))            # Manual gates next phase

# Handoff persistence
[](handoff_created(h) -> []exists_on_disk(h)) # Survives compaction

# Termination
<>(all_complete | abandoned)

標準義務論理(SDL)

# Reading obligations
O(read_fully(plan))
O(read_fully(f)) <- mentioned_in_plan(f)
O(check_existing_checkmarks)
F(partial_read)

# Verification obligations
O(run_automated) <- impl_complete
O(pause_for_manual) <- automated_pass
O(present_manual_checklist)
F(checkoff_manual) <- not user_confirmed

# Mode selection
O(orchestration) <- tasks >= 4
P(direct) <- tasks <= 3
O(respect_user_preference)

# Orchestration obligations
O(read_previous_handoff) <- exists_handoff(task_{n-1})
O(create_handoff) <- agent_completes
O(update_ledger) <- task_complete
F(batch_tasks)                                # One agent per task
F(proceed_on_mismatch) <- not user_guidance

動的認識論理(DEL)

# Implementation actions
[read(plan)]K(tasks) & K(phases) & K(criteria)
[read(handoff_n)]K(context_{n+1})
[spawn(agent, task)]<>result(agent)
[verify(c)](K(pass) | K(fail))

# Composed workflows
[select_direct][implement ; verify_auto ; present_manual ; wait]*
[select_orchestration][prepare ; spawn ; wait ; read_handoff ; update]*

# Recovery
[compaction ; read_ledger ; list_handoffs ; read_last]resume

# Mismatch
[detect_mismatch ; stop ; present ; wait]proceed_or_abort

橋渡し原理

# Evidence persistence (JL-TEL)
[h]:context(n) -> [][h]:context(n)

# Evidence obligations (JL-SDL)
O(exists h. [h]:validated) <- pre_implement
O(exists v. [v]:pass(auto)) <- pre_manual

# Handoff chain (full integration)
[h_n]:complete(n) -> O([spawn]<>[h_{n+1}]:context(n+1))
compaction -> (forall h. persists(h))

状態マシン

INIT --> READ_PLAN --> MODE_SELECT --+--> DIRECT: [IMPL -> AUTO -> MANUAL -> WAIT]*
                                     |
                                     +--> ORCHESTRATION: [PREP -> SPAWN -> WAIT -> HANDOFF]*
                                                                                    |
                                                                                    v
                                                                                COMPLETE

出力スキーマ

handoff_path: "thoughts/handoffs/<session>/task-[NN]-[desc].md"
schema:
  required: [status, task_desc, files_modified[], verification_results, context_for_next]
  optional: [blocker, decisions[], open_questions[]]
tracking:
  plan: "- [x] Task N: description"
  ledger: "[x] Task N"

論理では不十分な場合の説明文

モードの選択

タスクコンテキストの重要度モード
1-3いいえ直接
1-3はいオーケストレーション
4+任意オーケストレーション

ユーザーの設定が優先されます。

テンプレート

不一致:

Issue in Phase [N]:
Expected: [plan says]
Found: [actual]
How should I proceed?

手動検証の一時停止:

Phase [N] Complete - Ready for Manual Verification
Automated passed: [list]
Please verify: [manual items from plan]
Let me know when done.

エージェントの起動:

Task(subagent_type="general-purpose", model="claude-opus-4-5-20251101", prompt="""
[implement_task SKILL.md]
## Context
- Ledger: [content]
- Plan: [section]
- Task: [N]/[Total]: [desc]
- Previous Handoff: [content or "first task"]
- Handoff Dir: thoughts/handoffs/<session>/
""")

復旧(圧縮後):

  1. SessionStart によって台帳が自動的に読み込まれます
  2. ls thoughts/handoffs/<session>/
  3. 最後の引き継ぎを読みます
  4. 次のタスクから再開します

妥当性の制約

forall phase. has_auto_criteria(phase) & has_manual_criteria(phase)
forall task. one_agent_per_task(task)
forall h. on_disk(h) -> recoverable(h)
compaction -> (forall h. persists(h))
forall i < j. completed(task_i) before started(task_j)

コメント