customize-contribute-back

namespace	aiwg
name	customize-contribute-back
platforms	["all"]
description	Contribute a user's AIWG customization back upstream as a PR — reviews for general applicability, creates branch, opens PR

Customize Contribute Back

You help users contribute a customization from their fork back to the upstream AIWG repo. You first assess whether the customization is generally useful (not just personal), then create a feature branch, commit, and open a PR.

Triggers

• "PR this back to AIWG"
• "contribute this upstream"
• "submit this agent to the main repo"
• "open a PR to AIWG"
• "share this with the AIWG project"
• "could this be useful for everyone?"

Trigger Patterns Reference

Pattern	Example	Action
Explicit PR	"PR this back to AIWG"	Assess → branch → PR
Contribution question	"could this be useful for everyone?"	Assess only, ask to proceed
Submit	"submit this skill upstream"	Assess → branch → PR

Behavior

When triggered:

1. Identify what to contribute — ask if not clear:

   "Which customization would you like to contribute? (e.g., the domain-specialist agent, the my-conventions rule)"

2. Assess for general applicability:

   • Review the file(s) in question
   • Ask: is this useful to anyone installing AIWG, or is it specific to this user's context?
   • Personal signals (do NOT contribute): references to the user's name, team, specific internal tools, personal preferences ("always call me X"), org-specific vocabulary
   • General signals (good candidate): adds new capability, improves an existing agent/skill for a common use case, fixes a gap in the framework

   If personal: decline gracefully:

   "This looks specific to you — it references [X]. That's perfect as a private customization but wouldn't be a fit for the main repo. Keep it in your fork."

   If general: confirm with user before proceeding:

   "This looks generally useful. Want me to open a PR to jmagly/aiwg?"

3. Create feature branch:

   git -C <edgePath> checkout -b feat/contribute-<name>
   git -C <edgePath> add <file(s)>
   git -C <edgePath> commit -m "<conventional-commit-message>"
   git -C <edgePath> push origin feat/contribute-<name>
   

   Conventional commit format: feat(<scope>): <description> — scope is the addon/framework area (e.g., aiwg-utils, sdlc, skills).

4. Open PR via gh:

   gh pr create \
     --repo jmagly/aiwg \
     --head <user>:feat/contribute-<name> \
     --title "<conventional commit title>" \
     --body "<description>"
   

   PR body template:

   ## Summary
   [What this adds/changes and why it's useful for AIWG users generally]
   
   ## Changes
   - [File: what it does]
   
   ## Testing
   - Deployed locally via `aiwg use all`
   - [Any specific testing done]
   

5. Report:

   PR opened: https://github.com/jmagly/aiwg/pull/NNN
   Title: feat(aiwg-utils): [title]
   Branch: feat/contribute-<name>
   
   The PR is ready for review. You can continue customizing on main — this branch is separate.
   

Examples

Example 1: Generally useful agent

User: "I built a terraform-specialist agent — could this be useful for others?"

Assessment: Not user-specific, generally useful for infra teams → confirm

Action: Create branch → commit feat(aiwg-utils): add terraform-specialist agent → push → gh pr create

Response: "PR opened at jmagly/aiwg. The Terraform specialist agent looks like a solid contribution."

Example 2: Personal rule

User: "PR my my-conventions rule back to AIWG"

Assessment: File contains "always know I'm Joe from Acme Corp" — personal

Response: "This rule references you by name and mentions Acme Corp — it's a perfect personal customization but not a fit for the main repo where it wouldn't apply to other users. It stays in your fork."

Example 3: Generally useful skill improvement

User: "I improved the aiwg-sync skill to handle more edge cases — contribute it?"

Assessment: Improvement to existing skill, generally applicable → confirm

Action: Create branch → commit → PR

Clarification Prompts

• "Which file(s) should I include in the PR?"
• "This looks generally useful — want me to open a PR to jmagly/aiwg?"
• "The assessment: [reason]. Should I proceed with the PR anyway?"

References

• @$AIWG_ROOT/CONTRIBUTING.md — Contribution guidelines
• @$AIWG_ROOT/docs/customization/fork-workflow.md — Fork workflow docs