Language: Always interact with the user in 日本語.
impl-wt-en
Worktree-isolated version of impl. Implements without affecting the main working tree.
Prerequisites
- Claude Code environment
git, gh CLI
Arguments
- Issue number (e.g.,
/impl-wt-en #123): Fetch requirements from GitHub Issue
- Issue URL (e.g.,
/impl-wt-en https://github.com/owner/repo/issues/123): Same as above
- Text (e.g.,
/impl-wt-en Add user authentication): Use text as requirements
- No arguments: Interview the user for requirements
Forbidden Actions (Critical)
If any of the following occurs, redo that phase. Skipping for "context savings" or "small change" is not accepted.
- Skipping any sub-step (2-1 to 2-6) with "later", "leave as TODO", or "separate PR"
- Silently skipping a phase or sub-step without declaring it to the user
- Committing with unimplemented tests or dummy assertions (e.g.,
expect(true).toBe(true))
- Self-reviewing instead of calling the
review agent
- Skipping lint/format without attempting to run (skipping is allowed only after running and confirming no settings exist)
If scope reduction is needed, redo Phase 1 scope splitting and confirm with the user instead of skipping phases.
Phase 1: Requirements Analysis and Scope Splitting
- Retrieve requirements from arguments
- Issue: Read body and comments via
gh issue view
- Text: Use as-is
- No arguments: Interview the user
- Check for spec documents
- If CLAUDE.md specifies the spec location, follow it
- Otherwise, search broadly with Glob (
**/SPEC.md, **/spec/**, docs/**, etc.)
- Read any documents linked in the Issue body
- Cross-reference spec contents with requirements and use as implementation input
- If no spec found, proceed as-is
- Record the current branch as the base branch (PR merge target)
- Run
git branch --show-current and display to user: "Base branch: "
- Retain this name until PR creation in Phase 3
- Determine the working branch name (see
references/branch-naming.md)
- Create git worktree (see
references/worktree-setup.md)
- Split requirements into independently implementable and testable units
- Sort by dependencies and determine implementation order
- Create tasks with TaskCreate
- Explore and understand the codebase to grasp requirements accurately
- Confirm unclear specs with the user
- Confirm backward compatibility with the user if breaking changes exist
Phase 2: Implementation Cycle (repeat per scope)
IMPORTANT: Specify the worktree path as working directory in all subagent calls during Phase 2.
Set the current scope task to in_progress via TaskUpdate at the start of each scope.
2-1: Plan
- Create an implementation plan with the
Plan agent
- Clarify change locations, impact scope, and test requirements
- Include worktree path in prompt
2-2: Develop
- Implement (including tests) with the
develop agent
- Satisfy requirements with minimal changes
- Include worktree path in prompt
- Write production-ready code. The following do NOT count as complete implementation:
- Tests containing only mocks/stubs with no real code
- Functions filled with
TODO, NotImplementedError, pass, or throw new Error("not implemented")
- Interface/type definitions only with no actual implementation
2-3: Review
- Code review with the
review agent
- Evaluate requirement conformance, code quality, and test sufficiency
- Include worktree path in prompt
- Incomplete implementation check: Verify no mock/stub-only code, TODO/NotImplementedError placeholders, or empty function bodies
2-4: Improvement Cycle
- If review issues found -> fix with
develop -> re-review -> repeat until no issues
2-5: Format & Lint
- Run format/lint on changed files per project settings
- Run format/lint commands inside the worktree directory
- Skip if no settings found
2-6: Commit (mandatory)
- Commit at each scope completion. Never skip.
- Run
git add / git commit inside the worktree directory
- Follow commit message conventions in CLAUDE.md
- After committing, set the task to
completed via TaskUpdate
Phase 3: Final Verification and PR Creation
- Confirm all scopes are implemented
- Run full test suite inside the worktree directory
- Run
git push -u origin <working-branch> inside the worktree directory
- Create PR with
gh pr create --base <base-branch>
- Use the base branch recorded in Phase 1. Never fall back to
main or master.
- If unclear, check fork point with
git log --oneline --graph HEAD...main
- With Issue: Include Issue number in title, then link via
gh pr edit <PR#> --add-issue <Issue URL> after creation (do not use Closes keyword)
- PR body: Change summary + manual checklist (see
templates/pr-checklist.md)
- Report implementation summary and worktree path to user
Report example:
## Done
- PR: <URL>
- Worktree: <path> (run `git worktree remove <path>` after verification)
Rules
- Each scope must be independently implementable and testable
- Commit at each scope completion. Never proceed without committing
- Fix review issues at all severity levels
- Track progress with TaskCreate/TaskUpdate
- Phase declaration: At the start of each sub-step (2-1 to 2-6) display
▶ 2-X start: <name>, and on completion display ✓ 2-X done. This prevents silent skipping.
- Self-check: Before completing each phase, re-read the corresponding section of this SKILL.md and verify no steps were skipped before moving to the next phase.
- On compaction (context compression), check current progress with
TaskList before resuming work
- All git/file operations must be inside the worktree directory. Never modify the main working tree.
1---2name: impl-wt-en3description: Implementation cycle in an isolated git worktree environment with PR creation.4---56**Language: Always interact with the user in 日本語.**78# impl-wt-en910Worktree-isolated version of `impl`. Implements without affecting the main working tree.1112## Prerequisites1314- Claude Code environment15- `git`, `gh` CLI1617## Arguments1819- **Issue number** (e.g., `/impl-wt-en #123`): Fetch requirements from GitHub Issue20- **Issue URL** (e.g., `/impl-wt-en https://github.com/owner/repo/issues/123`): Same as above21- **Text** (e.g., `/impl-wt-en Add user authentication`): Use text as requirements22- **No arguments**: Interview the user for requirements2324## Forbidden Actions (Critical)2526If any of the following occurs, redo that phase. Skipping for "context savings" or "small change" is not accepted.2728- Skipping any sub-step (2-1 to 2-6) with "later", "leave as TODO", or "separate PR"29- Silently skipping a phase or sub-step without declaring it to the user30- Committing with unimplemented tests or dummy assertions (e.g., `expect(true).toBe(true)`)31- Self-reviewing instead of calling the `review` agent32- Skipping lint/format without attempting to run (skipping is allowed only after running and confirming no settings exist)3334If scope reduction is needed, redo Phase 1 scope splitting and confirm with the user instead of skipping phases.3536## Phase 1: Requirements Analysis and Scope Splitting37381. Retrieve requirements from arguments39 - Issue: Read body and comments via `gh issue view`40 - Text: Use as-is41 - No arguments: Interview the user422. Check for spec documents43 - If CLAUDE.md specifies the spec location, follow it44 - Otherwise, search broadly with Glob (`**/SPEC.md`, `**/spec/**`, `docs/**`, etc.)45 - Read any documents linked in the Issue body46 - Cross-reference spec contents with requirements and use as implementation input47 - If no spec found, proceed as-is483. Record the current branch as the base branch (PR merge target)49 - Run `git branch --show-current` and display to user: "Base branch: <branch-name>"50 - Retain this name until PR creation in Phase 3514. Determine the working branch name (see `references/branch-naming.md`)525. **Create git worktree** (see `references/worktree-setup.md`)536. Split requirements into independently implementable and testable units547. Sort by dependencies and determine implementation order558. Create tasks with TaskCreate5657- Explore and understand the codebase to grasp requirements accurately58- Confirm unclear specs with the user59- Confirm backward compatibility with the user if breaking changes exist6061## Phase 2: Implementation Cycle (repeat per scope)6263**IMPORTANT: Specify the worktree path as working directory in all subagent calls during Phase 2.**6465**Set the current scope task to `in_progress` via `TaskUpdate` at the start of each scope.**6667#### 2-1: Plan68- Create an implementation plan with the `Plan` agent69- Clarify change locations, impact scope, and test requirements70- Include worktree path in prompt7172#### 2-2: Develop73- Implement (including tests) with the `develop` agent74- Satisfy requirements with minimal changes75- Include worktree path in prompt76- **Write production-ready code. The following do NOT count as complete implementation:**77 - Tests containing only mocks/stubs with no real code78 - Functions filled with `TODO`, `NotImplementedError`, `pass`, or `throw new Error("not implemented")`79 - Interface/type definitions only with no actual implementation8081#### 2-3: Review82- Code review with the `review` agent83- Evaluate requirement conformance, code quality, and test sufficiency84- Include worktree path in prompt85- **Incomplete implementation check**: Verify no mock/stub-only code, TODO/NotImplementedError placeholders, or empty function bodies8687#### 2-4: Improvement Cycle88- If review issues found -> fix with `develop` -> re-review -> repeat until no issues8990#### 2-5: Format & Lint91- Run format/lint on changed files per project settings92- **Run format/lint commands inside the worktree directory**93- Skip if no settings found9495#### 2-6: Commit (mandatory)96- **Commit at each scope completion. Never skip.**97- **Run `git add` / `git commit` inside the worktree directory**98- Follow commit message conventions in CLAUDE.md99- **After committing, set the task to `completed` via `TaskUpdate`**100101## Phase 3: Final Verification and PR Creation1021031. Confirm all scopes are implemented1042. **Run full test suite inside the worktree directory**1053. **Run `git push -u origin <working-branch>` inside the worktree directory**1064. Create PR with `gh pr create --base <base-branch>`107 - **Use the base branch recorded in Phase 1. Never fall back to `main` or `master`.**108 - If unclear, check fork point with `git log --oneline --graph HEAD...main`109 - With Issue: Include Issue number in title, then link via `gh pr edit <PR#> --add-issue <Issue URL>` after creation (do not use Closes keyword)110 - PR body: Change summary + manual checklist (see `templates/pr-checklist.md`)1115. Report implementation summary and **worktree path** to user112113Report example:114```115## Done116- PR: <URL>117- Worktree: <path> (run `git worktree remove <path>` after verification)118```119120## Rules121122- Each scope must be independently implementable and testable123- **Commit at each scope completion.** Never proceed without committing124- Fix review issues at all severity levels125- Track progress with TaskCreate/TaskUpdate126- **Phase declaration**: At the start of each sub-step (2-1 to 2-6) display `▶ 2-X start: <name>`, and on completion display `✓ 2-X done`. This prevents silent skipping.127- **Self-check**: Before completing each phase, re-read the corresponding section of this SKILL.md and verify no steps were skipped before moving to the next phase.128- On compaction (context compression), check current progress with `TaskList` before resuming work129- **All git/file operations must be inside the worktree directory. Never modify the main working tree.**