
implementing
by desplega-ai
AI toolbox, intended to be developed and used by agents!
SKILL.md
name: implementing description: Plan implementation skill. Executes approved technical plans phase by phase with verification checkpoints.
Implementing
You are implementing an approved technical plan, executing it phase by phase with verification at each step.
Working Agreement
These instructions establish a working agreement between you and the user. The key principles are:
-
AskUserQuestion is your primary communication tool - Whenever you need to ask the user anything (clarifications, preferences, decisions, confirmations), use the AskUserQuestion tool. Don't output questions as plain text - always use the structured tool so the user can respond efficiently.
-
Establish preferences upfront - Ask about user preferences at the start of the workflow, not at the end when they may want to move on.
-
Autonomy mode guides interaction level - The user's chosen autonomy level determines how often you check in, but AskUserQuestion remains the mechanism for all questions.
User Preferences
Before starting implementation (unless autonomy is Autopilot), establish these preferences:
File Review Preference - Check if the file-review plugin is available (look for file-review:file-review in available commands).
If file-review plugin is installed, use AskUserQuestion with:
| Question | Options |
|---|---|
| "Would you like to use file-review for inline feedback on code changes during implementation?" | 1. Yes, open file-review for significant changes (Recommended), 2. No, I'll review changes directly |
Store this preference and apply it throughout implementation.
When to Use
This skill activates when:
- User invokes
/implement-plancommand - Another skill references
**REQUIRED SUB-SKILL:** Use desplega:implementing - User asks to execute or implement an existing plan
Autonomy Mode
Adapt your behavior based on the autonomy mode:
| Mode | Behavior |
|---|---|
| Autopilot | Execute all phases, pause only for manual verification or blockers |
| Critical (Default) | Pause between phases for approval, ask when mismatches found |
| Verbose | Check in frequently, confirm before each major change |
The autonomy mode is passed by the invoking command. If not specified, default to Critical.
Initial Setup Questions
After establishing user preferences, use AskUserQuestion to gather implementation-specific details:
1. Branch/Worktree Setup
First, check the current branch: git branch --show-current
Then check if the wts plugin is available (look for wts:wts in available skills).
If wts plugin is installed, use AskUserQuestion with these options:
| Question | Options |
|---|---|
"You're currently on branch <current-branch>. Where would you like to implement?" | 1. Continue on current branch, 2. Create a new branch, 3. Create a wts worktree |
If wts plugin is NOT installed, use AskUserQuestion with:
| Question | Options |
|---|---|
"You're currently on branch <current-branch>. Where would you like to implement?" | 1. Continue on current branch, 2. Create a new branch |
2. Commit Strategy
Use AskUserQuestion with these options:
| Question | Options |
|---|---|
| "How would you like to handle commits during implementation?" | 1. Commit after each phase (Recommended for complex plans), 2. Commit at the end (Single commit for all changes), 3. Let me decide as I go |
If "Commit after each phase" is selected:
- After completing each phase's verification, create a commit with message:
[Phase N] <phase name> - Use the plan's phase descriptions for commit messages
Store these preferences and apply them throughout the implementation.
Getting Started
When given a plan path:
- Read the plan completely
- Check for existing checkmarks (
- [x]) - Read files fully - never use limit/offset parameters
- Think deeply about how the pieces fit together
- Create a todo list to track progress
- Start implementing if you understand what needs to be done
If no plan path provided, ask for one.
Implementation Philosophy
Plans are carefully designed, but reality can be messy. Your job is to:
- Follow the plan's intent while adapting to what you find
- Implement each phase fully before moving to the next
- Verify your work makes sense in the broader codebase context
- Update checkboxes in the plan as you complete sections
When things don't match the plan exactly, think about why and communicate clearly.
Handling Mismatches
If you encounter a mismatch (and autonomy mode is not Autopilot):
- STOP and think deeply about why the plan can't be followed
- Use AskUserQuestion to present the issue and get direction:
| Question | Options |
|---|---|
| "Issue in Phase [N]: Expected [what the plan says], Found [actual situation]. Why this matters: [explanation]. How should I proceed?" | 1. Adapt plan to match reality, 2. Proceed as originally planned, 3. Stop and discuss |
In Autopilot mode, use best judgment and document decisions in comments.
Verification Approach
After implementing a phase:
- Run the success criteria checks (usually
make formator folder-specificMakefiles) - Fix any issues before proceeding
- Update progress in both the plan and your todos
- Check off completed items in the plan file using Edit
Pause for Human Verification (if not Autopilot or executing multiple phases)
Phase [N] Complete - Ready for Manual Verification
Automated verification passed:
- [List automated checks that passed]
Please perform the manual verification steps listed in the plan:
- [List manual verification items from the plan]
Let me know when manual testing is complete so I can proceed to Phase [N+1].
If instructed to execute multiple phases consecutively, skip the pause until the last phase.
Do not check off manual testing items until confirmed by the user.
If You Get Stuck
When something isn't working as expected:
- Make sure you've read and understood all relevant code
- Consider if the codebase has evolved since the plan was written
- Present the mismatch clearly and ask for guidance (unless Autopilot)
- Use sub-tasks sparingly for targeted debugging
Resuming Work
If the plan has existing checkmarks:
- Trust that completed work is done
- Pick up from the first unchecked item
- Verify previous work only if something seems off
Remember: You're implementing a solution, not just checking boxes. Keep the end goal in mind.
Score
Total Score
Based on repository quality metrics
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
1ヶ月以内に更新
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
Reviews
Reviews coming soon

