finalize

Synchronize design docs and context files before creating pull requests.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/spencerbeggs/design-docs-plugin --skill finalize-spencerbeggs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finalize
Source: https://github.com/spencerbeggs/design-docs-plugin/tree/main/plugin/skills/finalize
Command: npx skills add https://github.com/spencerbeggs/design-docs-plugin --skill finalize-spencerbeggs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual overhead of synchronizing design documentation, context files, and user-facing docs at the end of a development cycle, ensuring your repository remains perfectly documented and ready for merge.

Core Features & Use Cases

  • Automated Documentation Sync: Automatically dispatches specialized agents to update design docs, CLAUDE.md context, and user-facing documentation based on branch changes.
  • Workflow Orchestration: Handles the entire end-of-branch lifecycle, including changeset creation, commit squashing, pushing to remote, and opening pull requests.
  • Use Case: After finishing a complex feature, run this skill to ensure your architecture docs, project context, and README are updated, your commits are squashed into a clean history, and a PR is opened for review without you leaving the terminal.

Quick Start

Run the finalize skill to wrap up this branch and open a pull request with all documentation updated.

Frequently Asked Questions about finalize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate git branch cleanup and documentation before a pull request?

Automating git branch cleanup and documentation before a pull request requires orchestrating end-of-branch workflows to synchronize design docs, context files, and user-facing docs. This Skill dispatches agents to update documentation based on branch changes before handling commit squashing and PR creation.

What is the best way to keep design docs and project context updated when finishing a feature branch?

Keeping design docs and project context updated when finishing a feature branch is done by running an automated end-of-branch workflow. The process dispatches specialized agents to perform diff analysis and update architecture docs, CLAUDE.md context, and user-facing documentation automatically.

Can I automatically squash commits and open pull requests from the terminal?

Yes, you can automatically squash commits and open pull requests from the terminal using GitHub CLI integration. The workflow orchestrates the entire pull request lifecycle by creating changesets, squashing commit history, pushing to remote, and opening the PR for review.

Do I need GitHub CLI to automate pull request creation and documentation sync?

Yes, GitHub CLI is required to automate pull request creation and documentation sync for this workflow. The orchestration relies on GitHub CLI integration alongside internal documentation agents to perform diff analysis, commit squashing, and PR creation.

When should I use an automated workflow for documentation synchronization?

Automated workflow for documentation synchronization should be used when maintaining complex design-doc-driven repositories with strict documentation standards. It eliminates manual overhead by ensuring architecture docs, project context, and user-facing docs remain perfectly updated before merging.

Does finalize work with design-doc-driven repositories to update CLAUDE.md context?

Yes, finalize works with design-doc-driven repositories to update CLAUDE.md context. It automatically synchronizes context files and user-facing documentation by dispatching specialized agents to analyze branch changes and update repository documentation accordingly.