| name | code-with-task |
| description | Implements a task from spec/tasks in a git worktree following TDD. Use when working on a specific task by keyword. |
Task Implementation: $ARGUMENTS
CLAUDE.md, spec/_index.mdを起点として必要事項を確認後、spec/tasks内の [prefix]-*$ARGUMENTS*.md に一致するタスクファイルの実装に取り組みます（ファイルは該当のブランチ内, worktree内にしか無いことがあります）。
Prerequisites
まず以下を確認:
- CLAUDE.md
- spec/_index.md（存在すれば）
Worktree Setup
作業はgit worktree内で行います:
PARENT_DIR="$(cd "$(git rev-parse --show-toplevel)/.." && pwd)"
PROJECT_NAME="$(basename "$(git rev-parse --show-toplevel)")"
git worktree add "${PARENT_DIR}/${PROJECT_NAME}--worktrees/<branch-name>" -b <branch-name>
cd "${PARENT_DIR}/${PROJECT_NAME}--worktrees/<branch-name>"
npm install
パス規則: worktreeは必ずリポジトリの親ディレクトリ直下の vscode-markdown-academic-preview--worktrees/ 内に作成
IPC Status Reporting
worktreeルートの .worker-status.json にステータスを書き込む:
WORKTREE_ROOT="$(git rev-parse --show-toplevel)"
cat > "$WORKTREE_ROOT/.worker-status.json" <<IPCEOF
{
"branch": "$(git branch --show-current)",
"task_file": "<task file path>",
"status": "<status>",
"current_step": "<step description>",
"pr_number": null,
"error": null,
"updated_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
}
IPCEOF
ステータス値: starting → in_progress → testing → creating_pr → completed / failed
Implementation Flow
TDD Cycle
- Red: 失敗するテストを書く
- Green: テストを通す最小限の実装
- Refactor: リファクタリング
- 各ステップ完了後にcommit
Progress Tracking
- ステップ完了毎にタスクファイルを更新し、commit
- 次の作業前にcontext残量を確認
- compactが必要になりそうなら作業を中断して報告
Completion Checks
npm test
npm run build
PR Creation
全テスト通過後:
gh pr create --title "feat: ..." --body "..."
Work Boundaries
並列作業時のconflict回避のため:
- worktree内での作業: 実装 → テスト → PR作成まで
- マージ後にmainブランチで: ROADMAP.md更新とタスクファイルのcompleted/への移動
