jmagly/contribute-start

Contribute Start

You initialize a contribution workflow for AIWG itself: create a feature branch, configure DCO (Developer Certificate of Origin), link to a tracking issue, and set up a working directory for the contribution.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "I want to add a feature to AIWG" → init contribution for new feature
• "set up my branch for this fix" → init contribution for bug fix
• "how do I contribute?" → explain contribution flow and offer to initialize
• "start a PR" → initialize contribution and set up branch

Trigger Patterns Reference

| Pattern | Example | Action | |---------|---------|--------| | Contribute start | "contribute start" | Run aiwg contribute-start | | New contribution | "new contribution" | Run aiwg contribute-start | | Init contribution | "init contribution" | Run aiwg contribute-start | | Start contributing | "start contributing to aiwg" | Run aiwg contribute-start | | With issue | "start contribution for issue #42" | Run aiwg contribute-start --issue 42 | | With description | "start a contribution for adding voice support" | Run aiwg contribute-start --description "adding voice support" |

Behavior

When triggered:

1. Extract intent:

   • Is there an issue number to link? (e.g., "for issue #42")
   • Is there a description to use for the branch name?
   • What type of contribution: feature, fix, docs, refactor?

2. Run the appropriate command:

   # Default: interactive contribution initialization
   aiwg contribute-start
   
   # Link to a specific tracking issue
   aiwg contribute-start --issue 42
   
   # With branch description (slugified automatically)
   aiwg contribute-start --description "add voice support to deploy command"
   
   # Specify contribution type
   aiwg contribute-start --type feat
   aiwg contribute-start --type fix
   aiwg contribute-start --type docs
   

3. Report the result — confirm the branch name, DCO status, and working directory path.

What Gets Set Up

| Step | What Happens | |------|-------------| | Branch creation | feat/<slug> or fix/<slug> branch created from latest main | | DCO config | .git/hooks/commit-msg DCO hook installed if not present | | Working directory | .aiwg/working/contributions/<branch-name>/ created for drafts | | Issue link | Branch description references issue number if provided | | Contribution notes | CONTRIBUTING.md read and summarized for context |

DCO Note

AIWG contributions require a Developer Certificate of Origin sign-off on each commit:

Signed-off-by: Your Name <[email protected]>

The contribute-start command installs a commit-msg hook that reminds you to include this. Pass -s to git commit to sign off automatically.

Examples

Example 1: Starting a feature contribution

User: "Start a contribution — I want to add cost tracking to the ralph command"

Extraction: Feature contribution, description provided

Action:

aiwg contribute-start --type feat --description "add cost tracking to ralph command"

Response: "Contribution initialized. Branch: feat/add-cost-tracking-to-ralph-command. DCO hook installed. Working directory: .aiwg/working/contributions/feat-add-cost-tracking-to-ralph-command/. Sign your commits with git commit -s."

Example 2: Contribution linked to an issue

User: "Start contribution for issue #312"

Extraction: Linked to issue 312

Action:

aiwg contribute-start --issue 312

Response: "Contribution initialized. Branch: feat/issue-312. Working directory created. Issue #312 linked in branch description."

Example 3: Bug fix contribution

User: "I'm going to fix the install-plugin path bug, set up my branch"

Extraction: Fix type, description from context

Action:

aiwg contribute-start --type fix --description "install-plugin path bug"

Response: "Contribution initialized. Branch: fix/install-plugin-path-bug. DCO hook installed. Ready to commit."

References

• @$AIWG_ROOT/src/cli/handlers/utilities.ts — Command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference
• @$AIWG_ROOT/docs/contributing/ — Contribution guidelines