Specimin Wrap

• .specimin/plans/{CURRENT_BRANCH}/spec.md
• .specimin/plans/{CURRENT_BRANCH}/plan.md
• .specimin/plans/{CURRENT_BRANCH}/implementation.md

Context Extraction Goals (from spec/plan):

• Feature objective (1-2 sentence summary)
• High-level changes by phase/component
• Acceptance criteria
• Testing approach

Error Handling:

• Uncommitted changes: Warning: Uncommitted changes detected. Commit or stash before wrapping up. → Exit
• On main branch: Error: Cannot wrap up main branch. Switch to feature branch first. → Exit
• Not initialized: Error: Specimin not initialized. Run /init first. → Exit
• No commits ahead: Error: No commits to squash. Branch up to date with {MAIN_BRANCH}. → Exit
• gh not installed: Error: GitHub CLI not installed. Install: https://cli.github.com/ → Exit
• Not authenticated: Error: Not authenticated with GitHub CLI. Run: gh auth login → Exit

Checkpoint: Verify environment valid (no uncommitted changes, on feature branch, has commits to squash) before proceeding.

Stage 2: Run Tests

Actions:

1. Detect test framework and run appropriate test command:

   • Python: python3 -m pytest or pytest
   • JavaScript/TypeScript: npm test or yarn test
   • Ruby: bundle exec rspec or rake test
   • Go: go test ./...
   • Rust: cargo test
   • Java: mvn test or gradle test
   • Other: Check for Makefile with test target, or ask user

2. Run tests and capture output

3. Error Handling:

   • Tests fail: Display failure summary and exit with message:

     ✗ Tests failed. Fix failing tests before wrapping up.
     
     {test failure summary}
     
     Run tests again after fixes and retry wrap.
     

   • Tests pass: Proceed to next stage
   • No tests found: Warn user but continue:

     ⚠ No tests detected. Consider adding tests before creating PR.
     Proceed anyway? (yes/no)
     

Checkpoint: Verify all tests pass before proceeding to review changes.

Stage 3: Review Changes

Show user what will be squashed:

1. Commit history:

   git log {MAIN_BRANCH}..HEAD --oneline
   

2. Change summary:

   git diff {MAIN_BRANCH}...HEAD --stat
   

3. Files changed:

   git diff {MAIN_BRANCH}...HEAD --name-only
   

Present:

I'll squash these commits into one:

[commit history]

Files changed:
[file list]

Proceed with squash and PR creation? (yes/no)

Wait for confirmation. If "no", exit gracefully.

Stage 4: Squash Commits

Once confirmed:

1. Generate commit message:

   • Use feature objective from spec.md
   • Summarize WHAT changed (not HOW)
   • 1-2 sentences max
   • Follow conventional commits: feat:, fix:, refactor:, docs:

2. Perform squash:

   git reset --soft {MAIN_BRANCH}
   git commit -m "{COMMIT_MESSAGE}"
   

   CRITICAL: No --author, no Co-Authored-By:, no co-authoring metadata. User authorship only.

3. Verify squash:

   git log --oneline -1
   

   Confirm only one commit since main branch.

Checkpoint: Verify squash succeeded (single commit, correct message) before creating PR.

Stage 5: Create Pull Request

1. Generate PR title:

   • Use commit message or feature name from spec
   • Under 72 characters
   • Clear and descriptive

2. Generate PR description (use template below with extracted context):

## Summary

{1-2 sentence feature objective from spec.md}

## Changes

{Bulleted list of high-level changes from plan.md phases or implementation.md completed tasks}

## Testing

{Testing approach from plan.md, or manual test scenarios}

## Acceptance Criteria

{Criteria from spec.md}

3. Create PR:

   gh pr create --title "{PR_TITLE}" --body "$(cat <<'EOF'
   {PR_DESCRIPTION}
   EOF
   )"
   

4. Display result:

   ✓ Squashed {N} commits into 1 commit
   ✓ Created pull request: {PR_URL}
   
   Your feature is ready for review!
   

No upstream remote: gh pr create will prompt to push if needed.

Complete Examples

Example 1: Simple CRUD Feature

Spec objective: "Add user profile management allowing users to update their name and email"

Commit message: