---

name: release description: FABER Phase 5 - Creates pull request, deploys changes, updates documentation, and closes work item model: claude-opus-4-5

Release Skill

You receive full workflow context from all previous phases and respect autonomy gates.

<CRITICAL_RULES>

1. Respect Autonomy - ALWAYS check autonomy level before merging
2. Link Work Items - ALWAYS link PR to original work item
3. Include Context - ALWAYS reference spec and key decisions in PR
4. Close Work Items - ALWAYS close/update work item on completion
5. Safety Gates - NEVER bypass approval requirements </CRITICAL_RULES>

Context Provided:

Copy{
  "work_id": "abc12345",
  "auto_merge": false,
  "frame": {"work_item_title": "...", "branch_name": "...", "source_id": "123"},
  "architect": {"spec_file": "...", "key_decisions": [...]},
  "build": {"commits": [...], "files_changed": [...]},
  "evaluate": {"decision": "go", "test_results": {...}}
}

See workflow/basic.md for detailed steps.

See: plugins/faber/docs/RESPONSE-FORMAT.md for complete specification.

Success Response:

Copy{
  "status": "success",
  "message": "Release phase completed - PR created and work item closed",
  "details": {
    "phase": "release",
    "pr_url": "https://github.com/org/repo/pull/456",
    "pr_number": 456,
    "merge_status": "open",
    "work_item_closed": true
  }
}

Warning Response (PR created but work item not closed):

Copy{
  "status": "warning",
  "message": "Release phase completed with warnings - PR created but work item not closed",
  "details": {
    "phase": "release",
    "pr_url": "https://github.com/org/repo/pull/456",
    "pr_number": 456,
    "merge_status": "open",
    "work_item_closed": false
  },
  "warnings": [
    "Could not close work item #123 - permission denied",
    "Work item may need manual closure"
  ],
  "warning_analysis": "The pull request was created successfully but the work item could not be automatically closed",
  "suggested_fixes": [
    "Manually close issue #123 after PR is merged",
    "Check GitHub token has 'issues:write' permission"
  ]
}

Failure Response:

Copy{
  "status": "failure",
  "message": "Release phase failed - could not create pull request",
  "details": {
    "phase": "release"
  },
  "errors": [
    "No commits to create PR from",
    "Branch 'feat/123-export' does not exist on remote"
  ],
  "error_analysis": "The pull request could not be created because the branch has not been pushed to the remote repository",
  "suggested_fixes": [
    "Push local commits: git push -u origin feat/123-export",
    "Verify branch exists locally with: git branch -a"
  ]
}

This Release skill creates pull requests and completes FABER workflows.