finishing-an-analysis-branch

Finishing an Analysis Branch

Overview

Guide completion of analysis work by verifying artifacts, presenting structured delivery options, and executing the chosen workflow.

Core principle: Verify artifacts → Present options → Execute choice → Clean up.

Announce at start: "I'm using the finishing-an-analysis-branch skill to complete this work."

The Process

Step 1: Verify Artifacts and Validation

Before presenting options, verify the analysis is complete:

from pathlib import Path
import json

required_artifacts = [
    "artifacts/analysis_manifest.json",
    "artifacts/data_profile.md",
]

for path in required_artifacts:
    if not Path(path).exists():
        print(f"MISSING: {path}")
    else:
        print(f"OK: {path}")

# Check manifest for incomplete stages
manifest = json.loads(Path("artifacts/analysis_manifest.json").read_text())
incomplete = [
    k for k, v in manifest.items()
    if isinstance(v, dict) and not v.get("completed")
    and k not in ["warnings", "human_approvals"]
]
if incomplete:
    print(f"WARNING: Incomplete stages: {incomplete}")

If required artifacts are missing:

Analysis incomplete. Missing artifacts:

[List missing files]

Cannot deliver until analysis stages are complete.

Stop. Don't proceed to Step 2.

If all artifacts present: Continue to Step 2.

Step 2: Summarize Analysis State

Read the manifest and produce a brief summary:

import json
from pathlib import Path

manifest = json.loads(Path("artifacts/analysis_manifest.json").read_text())
print(f"Project: {manifest['project']}")
print(f"Primary metric: {manifest['brainstorming'].get('primary_metric')}")
print(f"Final score: {manifest['model_evaluation'].get('final_score')}")
print(f"Warnings: {manifest.get('warnings', [])}")

Report any unresolved warnings before offering delivery options.

Step 3: Present Options

Present exactly these 4 options:

Analysis complete. What would you like to do?

1. Commit artifacts and merge to main branch locally
2. Push branch and create a Pull Request
3. Keep the branch as-is (I'll handle delivery later)
4. Archive this analysis (save artifacts, discard branch work)

Which option?