Sdd Impl

sdd-impl — Implement Tasks (TDD)

Slash Command

/sdd-impl <slug> [task-id]

Purpose

Implement one task (or all pending tasks) for a spec using strict Test-Driven Development. Delegates test/implementation cycles to the /ecc:tdd-workflow skill and keeps progress.md up to date throughout.

Prerequisites

Before running this skill, confirm:

• sdd-review-plan has been run: review-results/plan-review.md must exist and contain no ❌ in the Traceability section.
• tasks.md exists and has at least one task in pending status.

If the plan review is missing, stop and instruct the user to run /sdd-review-plan <slug> first.

Input Files

Mode Behavior

Read mode from the YAML front matter of progress.md:

---
mode: standard # or: auto
---

Steps

1. Determine Which Task to Implement

If [task-id] is provided:
  - Locate that task in tasks.md
  - Verify its status in progress.md is "pending" (or "in-progress" if resuming)
  - Warn if the task is already "done"

Otherwise:
  - Find the first task with status "in-progress" in progress.md (resume case)
  - If none, find the first task with status "pending"
  - If all tasks are "done", report completion and skip to the gate

2. Mark Task as In-Progress

Update progress.md:

<!-- Before -->

- [ ] TASK-001: Create user schema — pending

<!-- After -->

- [x] TASK-001: Create user schema — in-progress

3. TDD Cycle via /ecc:tdd-workflow

Invoke the /ecc:tdd-workflow skill for the selected task. Pass the task's acceptance criteria as the specification.

RED phase — Write failing test:

• Co-locate the test file with the source file (e.g., use-login.ts → use-login.test.ts)
• Target the acceptance criteria from tasks.md directly
• Run pnpm test:run — confirm the test fails for the right reason
• In standard mode: pause and display the failing test output

GREEN phase — Minimal implementation:

• Write the minimum code to make the test pass
• Apply project constraints (see below)
• Run pnpm test:run — confirm the test passes
• In standard mode: pause and display the passing test output

REFACTOR phase — Clean up:

• Remove duplication, improve naming, ensure Japanese comments on non-obvious logic
• Run pnpm check — must pass with no errors
• Run pnpm test:run — all tests must still pass
• In standard mode: pause and display the final state

4. Commit

After each task completes its TDD cycle:

git add <changed files>
git commit -m "feat(TASK-001): <task title from tasks.md>"

Use the exact task ID and title from tasks.md. Follow Conventional Commits format.

5. Update progress.md

<!-- After completion -->

- [x] TASK-001: Create user schema — done

Append a brief note under the task if relevant (e.g., which files were created or modified).

6. Repeat

If no [task-id] was given (auto mode or batch run), loop back to Step 1 and pick the next pending task. Continue until all tasks are done or the user interrupts.

Project Constraints (Enforced at Every Commit)

These are non-negotiable for this project:

better-result patterns

API layer (mutations.ts) — catch before try:

export function createFoo(params: CreateFooParams) {
  return Result.tryPromise({
    catch: toApiError,
    try: async () => {
      const response = await apiClient.api.v1.foos.$post({ body: params })
      return response
    },
  })
}

Hook layer (use-*.ts) — err before ok:

result.match({
  err: (error) => {
    showError({ message: error.message, title: 'エラー' })
  },
  ok: (data) => {
    showSuccess({ message: '作成しました' })
    onSuccess(data)
  },
})

MSW mock placement

src/features/<feature>/mocks/handlers.ts

Handlers are registered in src/lib/msw/server.ts for Vitest tests.

Session Resume

If the session was interrupted mid-task, re-run:

/sdd-impl <slug>

The skill reads progress.md, finds any task marked in-progress, and resumes from the appropriate TDD phase. If no in-progress task exists, it picks the next pending task.

Output Files Modified

Approval Gate

After all specified tasks complete (or a single task if [task-id] was given):

Append to .claude/specs/<slug>/change-log.md:

| <YYYY-MM-DD> | sdd-impl | 実装完了 (<N> tasks, <M> commits) |

== PHASE COMPLETE: sdd-impl ==
Artifact: .claude/specs/<slug>/progress.md
Summary:
- Implemented TASK-001 through TASK-003 (3 tasks)
- All tests pass (pnpm test:run green)
- pnpm check passes (lint + format + tsc)
- Commits: feat(TASK-001), feat(TASK-002), feat(TASK-003)
- Remaining pending tasks: TASK-004 through TASK-012

⏸ WAITING FOR CONFIRMATION
Type `CONFIRM sdd-review` to proceed to code review, or describe changes needed.