Back to list
desplega-ai

implementing

by desplega-ai

AI toolbox, intended to be developed and used by agents!

3🍴 0📅 Jan 24, 2026

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:

  1. 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.

  2. Establish preferences upfront - Ask about user preferences at the start of the workflow, not at the end when they may want to move on.

  3. 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:

QuestionOptions
"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-plan command
  • 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:

ModeBehavior
AutopilotExecute all phases, pause only for manual verification or blockers
Critical (Default)Pause between phases for approval, ask when mismatches found
VerboseCheck 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:

QuestionOptions
"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:

QuestionOptions
"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:

QuestionOptions
"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:

  1. Read the plan completely
  2. Check for existing checkmarks (- [x])
  3. Read files fully - never use limit/offset parameters
  4. Think deeply about how the pieces fit together
  5. Create a todo list to track progress
  6. 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:
QuestionOptions
"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:

  1. Run the success criteria checks (usually make format or folder-specific Makefiles)
  2. Fix any issues before proceeding
  3. Update progress in both the plan and your todos
  4. 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:

  1. Make sure you've read and understood all relevant code
  2. Consider if the codebase has evolved since the plan was written
  3. Present the mismatch clearly and ask for guidance (unless Autopilot)
  4. 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

55/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon