# Project Execute

> Use when user says "execute the plan", "implement the plan", "run the plan", "implement phase", "start implementation", "build phase", or wants to begin implementation from a plan file.

- **Type:** Skill
- **Install:** `agentstack add skill-rtbenfield-agent-experience-project-execute`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [rtbenfield](https://agentstack.voostack.com/s/rtbenfield)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [rtbenfield](https://github.com/rtbenfield)
- **Source:** https://github.com/rtbenfield/agent-experience/tree/main/skills/project-execute

## Install

```sh
agentstack add skill-rtbenfield-agent-experience-project-execute
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Project Execute

Execute an implementation plan produced by `/project-plan`. Works through phases, verifies each task, commits incrementally, and tracks progress in the plan file. The plan is a living document — this skill revises it when execution reveals unexpected constraints or opportunities.

## Pre-conditions — halt if unmet

1. **No plan referenced.** Ask the operator which plan to execute. A plan is any file produced by `/project-plan` (convention: `.agents/projects/{name}.plan.md`) or equivalent content in conversation. If the operator provides only an outcome, suggest running `/project-spec` then `/project-plan` first.
2. **Review flags or open questions unresolved.** If the plan contains `⚠️ **RF***` markers or open questions (`**Q***`) without recommended answers, halt and inform the operator.
3. **Plan file not found.** If the referenced plan file does not exist, halt and ask the operator to confirm the path.

## Determine scope

Acknowledge the operator's prompt — it may specify the entire plan or a particular phase. If the prompt gives no direction, default to the first incomplete phase.

## Execution loop

For each task within the scoped phase(s):

1. **Implement.** Make the changes the plan describes. Plans express intent, not patches — adapt to the codebase as it exists. Reference files by path, not line numbers.
2. **Verify.** Run the project's build, lint, type-check, and test commands. All must pass before committing. If any fail, fix before proceeding. Verification hierarchy: type system > lint > unit tests > integration tests. Fix at the highest level that catches the issue.
3. **Check off.** Mark acceptance criteria as done in the plan file (`[x]`). The plan file is the single source of truth for progress.
4. **Commit.** One self-contained commit per task, including plan file changes. All verifications green. Follow the repository's existing commit conventions — check `git log --oneline -10` for patterns. If no convention is apparent, use: `feat: {domain message}` / `fix: {domain message}` / `refactor: {domain message}`. If a failing state is necessary, explain in the commit message. **Skip committing when execution produces only one commit total** — the operator can review and commit. Commit when working through multiple tasks, as each commit checkpoints progress.

## Plan updates

- **Update phase status** as work progresses: `► In progress` when starting a phase, `✓ Complete` when all acceptance criteria pass. Keep the plan file current.
- **Check off acceptance criteria** as each is verified (`[x]`).
- **Add revision log entries** only for material changes that alter the plan's intent, scope, or structure — phase added/removed, task scope changed, files renamed, or an execution-time decision made. Format: `YYYY-MM-DD: what changed and why`. Do not log check-offs, phase completions, or routine progress.
- **Preserve the revision log.** It is an append-only record. Never truncate or rewrite past entries.

## Decisions and surprises

- **Decide and proceed.** If a reasonable assumption can be made from context, make it and note it in the plan's revision log. Do not block on ambiguity.
- **Surface to operator.** Pause and ask if: a decision impacts modules outside the current phase's scope, execution contradicts the plan's stated requirements, or a planned task cannot be completed without expanding scope.
- **Log tangents.** Do not expand scope. Record out-of-scope improvements in the agent logs file (`.agents/logs/{name}.md`) under **Backlog**, not the plan.

## Constraints

- Never embed absolute paths in code, commit messages, or PR descriptions.
- Never persist plan artifact IDs (FR/NFR labels, ticket numbers) into code. Comments and names reference the domain, not the planning tool.
- Test through the public surface, not internals. If a test breaks when the implementation changes, it is reaching past the public API — rewrite it.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [rtbenfield](https://github.com/rtbenfield)
- **Source:** [rtbenfield/agent-experience](https://github.com/rtbenfield/agent-experience)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-rtbenfield-agent-experience-project-execute
- Seller: https://agentstack.voostack.com/s/rtbenfield
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
