fix(docs): align superpowers guide with brainstorm-to-branch conventions

[cbini]

Summary

• Reorder Phases 1–2: brainstorm conversation → GitHub issue → worktree/branch choice → branch creation → spec file (on the branch) — matching CLAUDE.md's brainstorm-to-branch discipline
• Add worktree vs branch switch: document both options with brief explanations, matching the required user choice
• Add branch naming convention: <gh-username>/<commit-type>/claude-<brief-description>
• Add git resuming tip: Claude merges main before resuming work on an existing branch
• Update Big Picture diagram and Quick Reference to reflect corrected ordering
• Resolve merge conflicts with main (dbt Development and SFTP Integration added to guides index and mkdocs nav)

Why

The original draft had the spec file written before the GitHub issue and branch were created. CLAUDE.md requires: (1) issue before design doc, (2) ask user worktree or branch switch, (3) no files written until on the feature branch.

🤖 Generated with Claude Code

[github-actions]

Code Review in Progress

• Gather PR context and git SHAs
• Dispatch code-reviewer subagent (Python, Dagster, dbt, security)
• Post review findings

View job run

[GabyRangelB]

@cbini - This makes sense to me. One question: did we find a resolution for using worktrees in that we ended up with duplicate projects? Could we add something as to when it is better to use a worktree vs a branch? I am not very clear on that.

[cbini]

i forget exactly what the problem was with worktrees, but it's fixed. also it was a dbt power user issue.

there is an explanation about the difference -- does it need more context?

[GabyRangelB]

i forget exactly what the problem was with worktrees, but it's fixed. also it was a dbt power user issue.

there is an explanation about the difference -- does it need more context?

@cbini - So, it sounds like Worktree is like Fork. Sorry to beat a dead horse here, but maybe we should add specific examples of when Branch vs Worktree makes more sense? I just don't know when I would ever need Worktree. Maybe that's more for, like, data mart work?

[cbini]

yeah it's not a fork. i'll clarify it some more

[cbini]

@GabyRangelB updated