Skip to content

Clarify default-branch behavior for daf git new #665

Closed

Description

@itdove

Summary

Users may expect daf git new to propose the repository's default branch, but this command creates an analysis-only GitHub/GitLab issue session and intentionally does not create or select a branch. Default source-branch selection is part of the development workflows (daf new and daf open).

Motivation

The command name and the fact that it starts from a repository can make the branch behavior unclear. Users should be able to tell whether they want an analysis-only issue-creation session or a development session that creates a branch from the repository default.

Proposed Solution

Make the distinction more visible in daf git new help and the relevant workflow documentation. Explain that no branch picker is shown for this analysis-only workflow, and point users to daf new / daf open for development-session branch selection. Keep the current analysis-only behavior unless branch creation is explicitly redesigned.

Acceptance Criteria

  • daf git new --help or its command documentation explicitly says that it does not create or select a branch.
  • The documentation points users to the development workflow for default-branch selection.
  • The analysis-only behavior of GitHub/GitLab issue-creation sessions remains clear and unchanged.

Related: #638 and #660 (default source-branch selection and picker behavior).

Activity

  1. changed the title [-]Clarify default-branch behavior for Enter goal/description for the issue: [/-] [+]Clarify default-branch behavior for daf git new[/+] on Nov 3, 2026
  2. self-assigned this
    on Nov 4, 2026
  3. itdove commented on Nov 4, 2026

    @itdove
    OwnerAuthor

    Implemented the clarification in daf git new --help, the GitHub/GitLab workflow docs, and bundled daf-git/daf-workflow skills. The command remains analysis-only; a supplied --branch only records session metadata. Focused unit tests (28), package-wide mypy, and the isolated integration suite (19/19) pass.

  4. itdove commented on Nov 4, 2026

    @itdove
    OwnerAuthor

    Pull request created: #666

  5. itdove commented on Nov 4, 2026

    @itdove
    OwnerAuthor

    ✅ Session Complete

    Project: devaiflow
    Goal: #665: Clarify default-branch behavior for daf git new
    Time Spent:
    0h 20m total

    • itdove: 0h 20m
    • unknown: 0h 0m
      Branch: 665

    No significant activity detected in this session.

    Session Notes:

    Session Notes: itdove-devaiflow-665

    JIRA: #665

    2026-11-03 21:23

    • Issue Clarify default-branch behavior for daf git new #665: clarified that daf git new creates an analysis-only issue session, does not create/select or check out a development branch, and does not show the development branch picker; directed development workflows to daf new/daf open. Focused tests, mypy, and integration suite pass.

    Generated by DevAIFlow

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions