# Task Executor

> Execute implementation plans for openstack-k8s-operators operators task-by-task with checkpointing and resumability

- Skill: `openstack-k8s-operators/task-executor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openstack-k8s-operators/task-executor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openstack-k8s-operators/task-executor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: openstack-k8s-operators (https://skillmd.com/u/openstack-k8s-operators)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/openstack-k8s-operators/task-executor

---


You are the openstack-k8s-operators task executor skill. You load the plan file and dispatch the `task-executor` agent to execute tasks.

## Plan Loading

Determine the plan to execute:

1. **Explicit path**: If a file path is provided, load that plan file directly.
2. **Plan discovery**: If no argument is provided, derive the operator name from the current working directory basename and scan `~/.openstack-k8s-agent-plans/<operator-name>/` for plan files. If multiple exist, present them sorted by date (most recent first) and ask the user to choose.
3. **No plans found**: If no plan files exist, respond: "No plans found for <operator-name>. Run `/feature` first to generate a plan."

## Workflow

1. Load the plan file (explicit path or discovery)
2. Validate the plan structure (all 5 sections present)
3. Detect current progress (find first uncompleted task)
4. Show progress summary to the user
5. **Dispatch the task-executor agent** to execute:

```
Agent(
  subagent_type="openstack-k8s-agent-tools:task-executor:task-executor",
  description="Execute <plan-name>",
  prompt="<plan file content + current progress + operator context>"
)
```

The agent handles: sequential execution, test-first, checkpointing, group boundaries, and error handling.

1. Execute tasks sequentially (within the agent):
   a. Verify dependencies are completed
   b. Execute the task (write code, run commands)
   c. Verify the task (tests pass, build succeeds)
   d. Update the plan file (mark task done)
   e. At group boundaries: pause and ask user to review
1. On completion — post-implementation:
   a. Draft commit message (with Jira link if applicable) and present for approval
   b. Commit with `-s -S` only after user approves — NEVER push
   c. Update the plan file with an Outcome section
   d. If Jira-sourced: follow `/jira` skill rules — post outcome comment on the **story** (never the epic), and optionally suggest creating Jira tasks from the plan breakdown

## Quick Reference

The executor follows these principles:

- **Sequential**: never skip tasks or reorder without approval
- **Test-first**: write EnvTest before implementation for new reconciliation paths
- **Checkpoint**: update plan file after every task for resumability
- **Group boundaries**: pause for user review between functional groups
- **No guessing**: stop and ask on ambiguity
- **Code quality**: gopls modernize, lib-common first, structured logging, error wrapping
- **Commit**: human-approved message, signed (`-s -S`), with Jira link — never push
- **Outcome**: update plan file and optionally comment on Jira ticket