Investigation Framework
Phase 1 — Define the Inquiry
Before touching any source, characterize what you need to find:
- Definitive fact: A single correct answer exists (e.g., "Does the API support batch requests?")
- Contextual picture: Multiple viewpoints must be assembled (e.g., "What has this account's experience been over the last quarter?")
- Open exploration: The boundaries of the question are still forming (e.g., "Why are enterprise customers struggling with onboarding?")
- Audience awareness: Determine who will consume the answer — the customer directly, an internal team member, or executive leadership — as this shapes tone, depth, and what to include.
Phase 2 — Map Sources to the Question Type
| Question Category |
Primary Sources |
| Product capabilities |
Official docs, API references, knowledge base, product specs |
| Account history and context |
CRM records, email threads, meeting notes, chat logs |
| Internal process or policy |
Wikis, runbooks, policy documents |
| Technical troubleshooting |
Documentation, engineering resources, past support tickets |
| Market or competitive landscape |
Web search, analyst reports, competitive intelligence |
Phase 3 — Gather Evidence Across Tiers
Work through sources from most to least authoritative. Never rely on a single hit — corroborate across channels.
Tier 1: Canonical Internal Records (Reliability: Strong)
Official documentation, published knowledge base articles, API references, policy and SLA documents, internal product roadmaps. Trust these unless they carry stale dates.
Tier 2: Organizational Memory (Reliability: Moderate-Strong)
CRM account notes and activity logs, resolved support tickets and known-issue databases, shared documents and specifications, recorded decisions from meeting notes.
Tier 3: Informal Team Channels (Reliability: Moderate)
Slack or chat discussions, email correspondence, calendar and agenda notes. These often hold the freshest information but may lack full context or reflect speculation.
Tier 4: Public and External Sources (Reliability: Variable)
Company and competitor websites, community forums and user discussions, partner documentation, industry news and analyst commentary.
Tier 5: Reasoning by Analogy (Reliability: Weak)
Precedent from similar past situations, patterns from comparable accounts, general industry conventions. Always label these as inference.
Phase 4 — Assemble the Answer
Pull together findings, flag any contradictions between sources, and assign an overall confidence rating.
Phase 5 — Attribute Everything
Every claim in your response must trace back to a named source. No unsourced assertions.
Confidence Rating System
Attach one of these ratings to every answer you deliver:
Strong Confidence
- Backed by canonical documentation or an authoritative internal record
- Corroborated by at least two independent sources
- Verified as current
- Phrasing: "This is well-supported by [source]."
Moderate Confidence
- Found in informal channels (chat, email) without official documentation backing
- Rests on a single uncorroborated source
- Possibly dated but likely still accurate
- Phrasing: "According to [source], this seems correct. I would suggest confirming with [team/person]."
Weak Confidence
- Derived from indirect or analogical reasoning
- Sources are old or of uncertain reliability
- Multiple sources conflict with one another
- Phrasing: "No definitive source was found. Based on [context], my working assessment is [answer]. Verification is recommended before communicating to the customer."
Insufficient Information
- No relevant material located anywhere
- The question demands expertise beyond what available sources cover
- Phrasing: "I was unable to locate relevant information. I recommend consulting [suggested expert or team]."
Resolving Source Conflicts
When different sources tell different stories:
- Surface the discrepancy explicitly — never silently pick one version
- Evaluate recency and authority of each conflicting source
- Lay out both positions with context for the reader
- Propose a path to resolution (e.g., check with the product team)
- For customer-facing answers, default to the most conservative position until the conflict is settled
Structured Response Format
**Answer:** [Lead with the bottom line]
**Confidence:** [Strong / Moderate / Weak]
**Evidence:**
- [Source A]: [What it states]
- [Source B]: [Corroborating or contrasting detail]
**Limitations:**
- [Conditions or edge cases that could change the answer]
- [Context-specific factors to be aware of]
**Next Steps:**
- [Whether this is safe to relay to the customer as-is]
- [Any recommended verification actions]
Deciding When to Escalate
Safe to Answer Directly
- Official docs address the question unambiguously
- Multiple trustworthy sources agree
- The topic is factual and non-sensitive
- No commitments about timelines, pricing, or legal terms are involved
Route to a Specialist
- Roadmap commitments or delivery timelines are in play
- The question touches pricing, contracts, or legal terms
- Security, compliance, or data-handling topics
- The response could set a binding precedent or create expectations
- Conflicting information was found and remains unresolved
- A customer-specific configuration is involved
- The account is at risk and an incorrect answer could worsen the situation
Escalation Directory
- Domain experts — technical or specialized knowledge gaps
- Product team — capability, roadmap, or feature questions
- Legal / compliance — regulatory, privacy, or contractual matters
- Finance / billing — pricing, invoicing, payment issues
- Engineering — bugs, custom setups, root-cause analysis
- Leadership — strategic decisions, policy exceptions, high-stakes situations
Capturing Research for Reuse
Worth Documenting When:
- The same question has surfaced before or is likely to recur
- The investigation required substantial effort
- The answer corrects a widespread misconception
- Nuance exists that is easy to get wrong
Reusable Entry Format
## [Topic or Question]
**Verified On:** [date]
**Confidence:** [rating]
### Finding
[Concise, direct answer]
### Context and Nuance
[Background, conditions, and subtleties]
### Source Trail
[Where this information originated]
### Adjacent Topics
[Related questions this entry may also answer]
### Freshness Notes
[When to re-check, what developments could invalidate this]
Maintaining the Knowledge Store
- Timestamp every entry
- Mark entries tied to specific product versions or feature states
- Schedule periodic reviews to retire stale content
- Tag entries by domain, product area, and customer segment for discoverability
Operating Principles
- Pin down exactly what you are looking for before searching
- Work through source tiers methodically — do not skip levels on assumption
- Corroborate across multiple channels whenever possible
- Never present uncertain findings as established fact — always surface your confidence level
- When unsure whether an answer is safe to share externally, verify first
- Record your findings so the next person does not repeat the work
- If your research uncovers a knowledge gap, flag it for documentation
1---2name: customer-intel3description: Research customer context across docs, tickets, CRM, email, and web sources with cited confidence.4---5
6## Investigation Framework
7
8### Phase 1 — Define the Inquiry
9
10Before touching any source, characterize what you need to find:
11
12- **Definitive fact**: A single correct answer exists (e.g., "Does the API support batch requests?")
13- **Contextual picture**: Multiple viewpoints must be assembled (e.g., "What has this account's experience been over the last quarter?")
14- **Open exploration**: The boundaries of the question are still forming (e.g., "Why are enterprise customers struggling with onboarding?")
15- **Audience awareness**: Determine who will consume the answer — the customer directly, an internal team member, or executive leadership — as this shapes tone, depth, and what to include.
16
17### Phase 2 — Map Sources to the Question Type
18
19| Question Category | Primary Sources |
20|---|---|
21| Product capabilities | Official docs, API references, knowledge base, product specs |
22| Account history and context | CRM records, email threads, meeting notes, chat logs |
23| Internal process or policy | Wikis, runbooks, policy documents |
24| Technical troubleshooting | Documentation, engineering resources, past support tickets |
25| Market or competitive landscape | Web search, analyst reports, competitive intelligence |
26
27### Phase 3 — Gather Evidence Across Tiers
28
29Work through sources from most to least authoritative. Never rely on a single hit — corroborate across channels.
30
31**Tier 1: Canonical Internal Records** (Reliability: Strong)
32Official documentation, published knowledge base articles, API references, policy and SLA documents, internal product roadmaps. Trust these unless they carry stale dates.
33
34**Tier 2: Organizational Memory** (Reliability: Moderate-Strong)
35CRM account notes and activity logs, resolved support tickets and known-issue databases, shared documents and specifications, recorded decisions from meeting notes.
36
37**Tier 3: Informal Team Channels** (Reliability: Moderate)
38Slack or chat discussions, email correspondence, calendar and agenda notes. These often hold the freshest information but may lack full context or reflect speculation.
39
40**Tier 4: Public and External Sources** (Reliability: Variable)
41Company and competitor websites, community forums and user discussions, partner documentation, industry news and analyst commentary.
42
43**Tier 5: Reasoning by Analogy** (Reliability: Weak)
44Precedent from similar past situations, patterns from comparable accounts, general industry conventions. Always label these as inference.
45
46### Phase 4 — Assemble the Answer
47
48Pull together findings, flag any contradictions between sources, and assign an overall confidence rating.
49
50### Phase 5 — Attribute Everything
51
52Every claim in your response must trace back to a named source. No unsourced assertions.
53
54## Confidence Rating System
55
56Attach one of these ratings to every answer you deliver:
57
58### Strong Confidence
59- Backed by canonical documentation or an authoritative internal record
60- Corroborated by at least two independent sources
61- Verified as current
62- Phrasing: "This is well-supported by [source]."
63
64### Moderate Confidence
65- Found in informal channels (chat, email) without official documentation backing
66- Rests on a single uncorroborated source
67- Possibly dated but likely still accurate
68- Phrasing: "According to [source], this seems correct. I would suggest confirming with [team/person]."
69
70### Weak Confidence
71- Derived from indirect or analogical reasoning
72- Sources are old or of uncertain reliability
73- Multiple sources conflict with one another
74- Phrasing: "No definitive source was found. Based on [context], my working assessment is [answer]. Verification is recommended before communicating to the customer."
75
76### Insufficient Information
77- No relevant material located anywhere
78- The question demands expertise beyond what available sources cover
79- Phrasing: "I was unable to locate relevant information. I recommend consulting [suggested expert or team]."
80
81## Resolving Source Conflicts
82
83When different sources tell different stories:
84
851. Surface the discrepancy explicitly — never silently pick one version
862. Evaluate recency and authority of each conflicting source
873. Lay out both positions with context for the reader
884. Propose a path to resolution (e.g., check with the product team)
895. For customer-facing answers, default to the most conservative position until the conflict is settled
90
91## Structured Response Format
92
93```
94**Answer:** [Lead with the bottom line]
95
96**Confidence:** [Strong / Moderate / Weak]
97
98**Evidence:**
99- [Source A]: [What it states]
100- [Source B]: [Corroborating or contrasting detail]
101
102**Limitations:**
103- [Conditions or edge cases that could change the answer]
104- [Context-specific factors to be aware of]
105
106**Next Steps:**
107- [Whether this is safe to relay to the customer as-is]
108- [Any recommended verification actions]
109```
110
111## Deciding When to Escalate
112
113### Safe to Answer Directly
114- Official docs address the question unambiguously
115- Multiple trustworthy sources agree
116- The topic is factual and non-sensitive
117- No commitments about timelines, pricing, or legal terms are involved
118
119### Route to a Specialist
120- Roadmap commitments or delivery timelines are in play
121- The question touches pricing, contracts, or legal terms
122- Security, compliance, or data-handling topics
123- The response could set a binding precedent or create expectations
124- Conflicting information was found and remains unresolved
125- A customer-specific configuration is involved
126- The account is at risk and an incorrect answer could worsen the situation
127
128### Escalation Directory
1291. **Domain experts** — technical or specialized knowledge gaps
1302. **Product team** — capability, roadmap, or feature questions
1313. **Legal / compliance** — regulatory, privacy, or contractual matters
1324. **Finance / billing** — pricing, invoicing, payment issues
1335. **Engineering** — bugs, custom setups, root-cause analysis
1346. **Leadership** — strategic decisions, policy exceptions, high-stakes situations
135
136## Capturing Research for Reuse
137
138### Worth Documenting When:
139- The same question has surfaced before or is likely to recur
140- The investigation required substantial effort
141- The answer corrects a widespread misconception
142- Nuance exists that is easy to get wrong
143
144### Reusable Entry Format
145```
146
147## [Topic or Question]
148
149**Verified On:** [date]
150**Confidence:** [rating]
151
152### Finding
153[Concise, direct answer]
154
155### Context and Nuance
156[Background, conditions, and subtleties]
157
158### Source Trail
159[Where this information originated]
160
161### Adjacent Topics
162[Related questions this entry may also answer]
163
164### Freshness Notes
165[When to re-check, what developments could invalidate this]
166```
167
168### Maintaining the Knowledge Store
169- Timestamp every entry
170- Mark entries tied to specific product versions or feature states
171- Schedule periodic reviews to retire stale content
172- Tag entries by domain, product area, and customer segment for discoverability
173
174## Operating Principles
175
1761. Pin down exactly what you are looking for before searching
1772. Work through source tiers methodically — do not skip levels on assumption
1783. Corroborate across multiple channels whenever possible
1794. Never present uncertain findings as established fact — always surface your confidence level
1805. When unsure whether an answer is safe to share externally, verify first
1816. Record your findings so the next person does not repeat the work
1827. If your research uncovers a knowledge gap, flag it for documentation