implement-spec

Implement-Spec Orchestrator

Skill Usage Announcement

MANDATORY: When using this skill, announce it at the start with:

Using Skill: implement-spec | [brief purpose based on context]

Example:

Using Skill: implement-spec | Implementing spec-auth-system.md with full audit trail

This creates an audit trail showing which skills were applied during the session.

Overview

End-to-end orchestration that takes a specification file and produces a GitHub Pull Request with comprehensive audit trail.

Core principle: Single command produces PR with verified implementation, full observability, and recovery capability.

Entry point: /wrangler:implement [spec-file]

Produces:

• GitHub Pull Request with comprehensive summary
• Audit trail in .wrangler/sessions/{session-id}/
• Machine-verifiable execution log

When to Use

Use this skill when:

• User says "implement this spec" and wants a PR
• You want full audit trail and observability
• You need session recovery capability
• You want isolated worktree for implementation

Do NOT use this skill when:

• Implementing a single issue (use implement skill directly)
• User wants manual control over each step
• Working on existing PR or branch (use implement skill)

Workflow Phases

The orchestrator executes 6 phases in order:

INIT -> PLAN -> EXECUTE -> VERIFY -> PUBLISH -> REPORT

Each phase is tracked via MCP session tools for full observability.

Phase 1: INIT

Initialize session, create worktree, and establish context.

Steps

1. Start session

   Call session_start MCP tool:

   session_start(specFile: "{SPEC_FILE}")
   

   Capture response:

   • SESSION_ID = response.sessionId
   • WORKTREE_ABSOLUTE = response.worktreePath
   • BRANCH_NAME = response.branchName
   • AUDIT_PATH = response.auditPath

2. Verify worktree

   cd {WORKTREE_ABSOLUTE} && \
     echo "=== WORKTREE VERIFICATION ===" && \
     echo "Directory: $(pwd)" && \
     echo "Git root: $(git rev-parse --show-toplevel)" && \
     echo "Branch: $(git branch --show-current)" && \
     test "$(git branch --show-current)" = "{BRANCH_NAME}" && echo "VERIFIED" || echo "FAILED"