jmagly/feedback

AIWG Feedback

Submit a bug report, feature request, doc gap, or general feedback to the AIWG GitHub repository. System context (version, OS, provider, installed frameworks) is collected and prefilled automatically.

Triggers

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

• "report a bug" → bug report
• "something isn't working" → bug report
• "aiwg is broken" → bug report with doctor output
• "request a feature" → feature request
• "this feature is missing" → feature request
• "docs are wrong" / "doc gap" → documentation issue
• "file an issue" → issue submission (type selection prompt)
• "give feedback about aiwg" → general feedback

Trigger Patterns Reference

| Pattern | Example | Action | |---------|---------|--------| | Bug report | "report a bug with aiwg serve" | aiwg feedback --type bug | | Feature request | "request a feature for aiwg" | aiwg feedback --type feature | | Doc gap | "the docs for mcp inject are wrong" | aiwg feedback --type doc | | General | "I have feedback" | aiwg feedback | | With context | "file this as a bug: X" | Extract title/body, run aiwg feedback --type bug --title "..." --body "..." |

Behavior

When triggered:

1. Extract from conversation (if the user described the issue):

   • Type: bug | feature | doc | other
   • Title: short phrase summarizing the issue (max 80 chars)
   • Body: structured description of what happened, what was expected

2. Run the appropriate command:

   # Interactive (when type/title/body not clear from context)
   aiwg feedback
   
   # With extracted type
   aiwg feedback --type bug
   
   # Fully extracted from conversation
   aiwg feedback --type bug --title "doctor crashes when .aiwg missing" --body "Running aiwg doctor in a new project with no .aiwg directory causes an unhandled exception..."
   
   # Feature request
   aiwg feedback --type feature --title "add --watch flag to aiwg index build" --body "..."
   
   # Doc gap
   aiwg feedback --type doc --title "mcp inject workflow not documented" --body "..."
   

3. Report the result — confirm the issue was filed or provide the GitHub URL.

Examples

Example 1: Bug from conversation

User: "aiwg doctor crashes when I run it in a new project — there's an unhandled error about missing .aiwg"

Extraction:

• Type: bug
• Title: doctor crashes when .aiwg directory is missing
• Body: description from user message

Action:

aiwg feedback --type bug \
  --title "doctor crashes when .aiwg directory is missing" \
  --body "Running aiwg doctor in a project with no .aiwg directory causes an unhandled exception. Steps: 1) Create a new empty directory 2) Run aiwg doctor 3) Error occurs."

Example 2: Feature request from conversation

User: "I wish aiwg session could pass extra flags directly to the provider binary"

Extraction:

• Type: feature
• Title: aiwg session: pass-through flags to provider binary
• Body: description from user message

Action:

aiwg feedback --type feature \
  --title "aiwg session: pass-through flags to provider binary" \
  --body "Would be useful to be able to pass provider-specific flags through aiwg session, e.g. aiwg session -- --verbose"

Example 3: Ambiguous — ask

User: "I have some feedback"

Clarification prompt: "What's the feedback about? (Bug you found, feature you'd like, or something else?)"

Then run interactively:

aiwg feedback

Clarification Prompts

If the user's intent is ambiguous:

• "Is this a bug you found, a feature you'd like, or something else?"
• "Can you describe what you expected vs what happened?"
• "Which aiwg command or feature is this about?"

References

• @$AIWG_ROOT/src/cli/handlers/feedback.ts — Feedback command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference (feedback section)
• GitHub Issues: https://github.com/jmagly/aiwg/issues