feedback-capture

Capture, document, and analyze product feedback with complete metadata and structured analysis.

V2V Phase

Phase 6: Learning & Adaptation - Feedback capture is the input to the learning loop.

Prerequisites: Feedback encountered (customer, sales, support, etc.) Outputs used by: All phases (informs decisions, validates assumptions)

Auto-Initialization

Before capturing feedback, ensure the context folder structure exists. If missing:

1. •Check if context/feedback/ folder exists
2. •If not, create:
   • •context/feedback/index.md (empty registry template)
   • •context/feedback/themes.md (empty themes template)
3. •When saving to context/feedback/[YYYY]/, create the year folder if needed

If the entire context structure is missing, inform the user to run /setup first.

Purpose

Every piece of feedback is valuable organizational intelligence. This skill ensures feedback is captured systematically with its source, context, and analysis - enabling pattern recognition and informed decision-making.

CRITICAL: When to Use

Agents MUST invoke /feedback-capture whenever they encounter feedback from:

• •Customer conversations or quotes
• •Sales call notes or deal feedback
• •Support tickets or escalations
• •User research findings
• •Survey responses
• •Product reviews or social mentions
• •Internal stakeholder feedback
• •Competitive win/loss information
• •Partner or channel feedback

Do not let feedback pass through a conversation without capturing it.

Process

1. Extract Metadata

Gather all available context about the feedback:

2. Record Raw Feedback

Capture the feedback verbatim or as close to original as possible:

• •Direct quotes are preferred
• •If paraphrasing, note it
• •Include relevant context around the quote
• •Preserve the customer's language and terminology

3. Analyze the Feedback

Summary

Write a 1-2 sentence summary of the core feedback.

Key Insights

Extract 2-4 specific insights from the feedback:

• •What is the underlying need or problem?
• •What would success look like for this person?
• •What's blocking them currently?

Sentiment Assessment

• •Positive: Praise, satisfaction, advocacy
• •Negative: Complaint, frustration, churn risk
• •Neutral: Informational, neither positive nor negative
• •Mixed: Contains both positive and negative elements

Impact Assessment

Categorization

• •Type: Bug / Feature Request / Usability / Pricing / Support / General
• •Topics: Assign 2-5 topic tags for searchability
• •Segment: Customer segment if identifiable

4. Make Connections

Check the context registry for related items:

Related Feedback

• •Run /feedback-recall [topic] to find similar past feedback
• •Link to related entries if this reinforces a pattern

Linked Decisions

• •Does this feedback validate or challenge a past decision?
• •Reference relevant DR-IDs

Linked Bets

• •Does this relate to an active strategic bet?
• •Reference relevant SB-IDs

Linked Assumptions

• •Does this validate or invalidate a tracked assumption?
• •Reference relevant A-IDs
• •If an assumption is invalidated, flag for re-decision

5. Recommend Actions

Based on the analysis:

• •What should be done with this feedback?
• •Who should be informed?
• •Should this trigger a follow-up?

6. Save to Registry

1. •Generate feedback ID: FB-[YYYY]-[NNN] (check index for next number)
2. •Create full entry file: context/feedback/[YYYY]/FB-[YYYY]-[NNN].md
3. •Update context/feedback/index.md with summary row
4. •Check if this creates/strengthens a theme in context/feedback/themes.md

7. Report Capture

Confirm what was saved:

Feedback captured: FB-2026-015
- Source: [Customer Name] ([Segment])
- Topic: [Main topic]
- Sentiment: [Sentiment]
- Linked to: [Any connections]
- Theme contribution: [If applicable]

Output Template

# Feedback: FB-[YYYY]-[NNN]

## Metadata
| Field | Value |
|-------|-------|
| **ID** | FB-[YYYY]-[NNN] |
| **Captured Date** | [Today] |
| **Feedback Date** | [When given] |
| **Source Type** | [Type] |
| **Source Name** | [Name] |
| **Source Role** | [Role] |
| **Product** | [Product name - for multi-product orgs] |
| **Feature** | [Feature/area] |
| **Product Version** | [Version] |
| **Channel** | [Channel] |
| **Captured By** | @[agent] |

## Raw Feedback

> "[Exact quote or close paraphrase]"

[Additional context if needed]

## Analysis

### Summary
[1-2 sentence summary]

### Key Insights
1. [Insight 1]
2. [Insight 2]
3. [Insight 3]

### Sentiment
**[Positive/Negative/Neutral/Mixed]** — [Brief explanation]

### Impact Assessment
| Dimension | Rating | Notes |
|-----------|--------|-------|
| Urgency | [H/M/L] | [Why] |
| Frequency | [First/Recurring] | [Notes] |
| Revenue Impact | [H/M/L] | [Notes] |
| Strategic Relevance | [H/M/L] | [Which bet] |

### Categorization
- **Type**: [Type]
- **Topics**: [tag1], [tag2], [tag3]
- **Segment**: [Segment]

## Connections

### Related Feedback
- [FB-IDs of similar feedback]

### Linked Decisions
- [DR-IDs] — [How it relates]

### Linked Bets
- [SB-IDs] — [How it relates]

### Linked Assumptions
- [A-IDs] — [Validates/Invalidates]

## Recommended Actions
- [ ] [Action 1]
- [ ] [Action 2]

Instructions

1. •When encountering ANY feedback, immediately invoke this skill
2. •Ask clarifying questions if metadata is missing
3. •Always capture raw feedback verbatim when possible
4. •Always perform analysis - don't just store raw data
5. •Always check for connections to existing context
6. •Always save to the registry
7. •Flag if feedback invalidates assumptions or triggers re-decisions
8. •Note if feedback contributes to an emerging or established theme

Theme Detection

After saving, check if this feedback:

• •Matches an existing theme → Update theme with new data point
• •Shares topics with 2+ other entries → Suggest new emerging theme
• •Represents a significant new pattern → Flag for theme consideration