idea-lineage - Single-Idea Evolution Through the Brain
Convention: see conventions/quality.md for
citation rules, quote fidelity, and source-backed claims.
Boundary: see docs/takes-vs-facts.md for
the distinction between holder-attributed takes and the brain owner's hot
facts. Do not collapse those layers when summarizing lineage.
What this solves
Users often want to understand how one idea changed across time: when it first
appeared, when it became sharp, what it displaced, what it contradicted, and
what version is alive now. That is different from building a whole concept map
and different from charting an entity's metric trajectory.
Use this skill when the user asks about one idea, topic, phrase, or concept
page and wants its evolution through the brain.
Canonical examples:
- "Run idea lineage on founder-led sales."
- "How has my thinking about compounding trust changed?"
- "What is my current version of this idea?"
- "Where did this idea come from, and what did I abandon along the way?"
What this is not
- Not
concept-synthesis: that skill deduplicates many concept stubs, tiers
them, writes concept pages, and builds a broad intellectual map.
- Not
find_trajectory: that operation charts typed facts or event rows for
an entity, such as MRR, role, location, or status over time.
- Not a contradiction-probe runner: this skill may read cached contradiction
findings when available, but it does not launch expensive probes.
- Not a writing mode by default: do not write a lineage page unless the user
explicitly asks for a saved artifact after seeing the read-only answer.
Contract
This skill guarantees:
- A single-idea scope is preserved. Broad corpus or "map my concepts" prompts
route to
skills/concept-synthesis/SKILL.md instead.
- Every lineage claim cites existing brain evidence: page slug, source id when
present, date, and short quote or snippet.
- Missing evidence is labeled as a gap, not patched with plausible narrative.
- Contradictions, reversals, and abandoned branches are separated from normal
temporal evolution.
- The default mode is read-only and does not mutate brain pages.
Phases
Phase 1: Resolve the idea target
- Restate the idea in one sentence.
- Search for exact phrase variants with
search.
- Run one semantic
query for the natural-language version.
- Check
list_pages for concept pages when the idea has an obvious concept
slug or title.
- If results point to an entity/metric/status trajectory rather than a concept,
hand off to
find_trajectory or the normal query/think trajectory path.
If multiple distinct ideas share the same phrase, ask the user to choose the
intended one before synthesizing.
Phase 2: Gather evidence
Collect enough evidence to support or reject each output bucket:
- Search chunks with dates and source slugs.
- Full pages via
get_page for the top relevant concept, note, transcript,
meeting, article, or project pages.
- Related concept pages through backlinks,
related frontmatter, or repeated
co-occurrence in search results.
- Takes via
takes_search when the idea appears as a belief, bet, hunch, or
attributed claim.
- Cached contradiction findings via
find_contradictions when the user asks
about inconsistency or the search results show obvious conflict.
find_trajectory only when the evidence is entity/attribute-shaped, such as
a role/status/metric evolution that is relevant to the idea's story.
Prefer fewer high-quality sources over a long unsorted pile. Read full pages
when snippets imply a lineage milestone.
Phase 3: Classify lineage moments
Classify evidence into these buckets:
- First mention - earliest dated evidence where the idea appears.
- Best articulation - the clearest or most complete expression, not
necessarily the newest.
- Current live version - the most recent high-authority version that still
appears active.
- Reversals - places where the user's stance changed direction.
- Contradictions - claims that cannot both be true at the same time or
under the same assumptions. Distinguish these from legitimate temporal
supersession.
- Abandoned branches - promising variants that appear and then disappear,
lose support, or are explicitly rejected.
- Related concepts - nearby ideas that shaped or inherited part of the
original idea.
When a bucket has no evidence, write "No clear evidence found" with a brief note
about what was checked.
Phase 4: Synthesize the lineage
Write the answer in the output format below. Keep the synthesis proportional to
the evidence. Do not overfit a smooth evolution if the evidence is sparse,
messy, or contradictory.
Phase 5: Suggest optional next action
If useful, offer one concrete follow-up:
- Save the lineage as a brain page.
- Run broad
concept-synthesis if the user actually wants the whole concept
map refreshed.
- Run or inspect trajectory data if the idea turned out to depend on structured
entity facts.
- Run a contradiction probe only when stale cached findings are insufficient
and the user explicitly wants that heavier pass.
Output Format
Use this shape for normal answers:
## Current Live Version
[1-3 sentences. Include confidence: high / medium / low.]
## Lineage
- First mention: [date] - [claim] ([source-id:slug], "short quote")
- Best articulation: [date] - [claim] ([source-id:slug], "short quote")
- Turning point: [date] - [what changed] ([source-id:slug])
## Reversals and Contradictions
- Reversal: [what changed, with before/after evidence]
- Contradiction: [what conflicts, or "No clear evidence found"]
## Abandoned Branches
- [branch] - [why it appears abandoned, with evidence]
## Related Concepts
- [concept slug or title] - [relationship]
## Evidence Gaps
- [bucket or claim] - [what was checked and what is missing]
For short answers, collapse sections, but keep the same distinctions. Always
cite the source for each non-gap claim.
Quality Rules
- Quote exact text when naming first mention or best articulation.
- Include dates when the source has dates. If no date is available, say
"undated" rather than guessing.
- Treat the user's direct statements as highest authority for the user's own
current view.
- Treat holder-attributed takes as beliefs by that holder, not automatically
as facts about the world or the brain owner.
- Mark confidence low when evidence comes from a single weak snippet, an
undated page, or a fuzzy semantic match.
- Preserve source ids in citations when search or page payloads include them.
Anti-Patterns
- Running
concept-synthesis for a single-idea question.
- Presenting an entity's MRR, ARR, role, or status trajectory as conceptual
lineage without explaining the distinction.
- Treating normal temporal evolution as contradiction.
- Inventing abandoned branches because the story would be more interesting.
- Saving or rewriting brain pages without explicit user instruction.
- Using real names, companies, funds, or fork-specific examples in bundled
fixtures or documentation.
Related Skills and Operations
skills/concept-synthesis/SKILL.md - broad mutating concept-map synthesis.
skills/query/SKILL.md - general brain search and cited answers.
skills/brain-ops/SKILL.md - source attribution and brain-first behavior.
find_trajectory - structured typed-fact and event timelines for entities.
find_contradictions - cached suspected contradiction findings.
Tools Used
search - keyword search for exact phrase variants and dated mentions.
query - semantic search for conceptual matches.
get_page - full context for candidate source pages.
list_pages - concept-page discovery and scoped page enumeration.
takes_search - holder-attributed beliefs, bets, hunches, and facts.
find_contradictions - cached contradiction findings when relevant.
find_trajectory - optional structured entity trajectory side-channel.
Source: garrytan/gbrain → skills/idea-lineage/SKILL.md
1---2name: idea-lineage3description: | Trace one idea's evolution through the brain: first mention, best articulation, related concepts, reversals, contradictions, abandoned branches, and the current live version. Use for single-idea conceptual lineage, not broad concept-map synthesis or structured entity metrics.4---5
6
7# idea-lineage - Single-Idea Evolution Through the Brain
8
9> **Convention:** see [conventions/quality.md](../conventions/quality.md) for
10> citation rules, quote fidelity, and source-backed claims.
11>
12> **Boundary:** see [docs/takes-vs-facts.md](../../docs/takes-vs-facts.md) for
13> the distinction between holder-attributed takes and the brain owner's hot
14> facts. Do not collapse those layers when summarizing lineage.
15
16## What this solves
17
18Users often want to understand how one idea changed across time: when it first
19appeared, when it became sharp, what it displaced, what it contradicted, and
20what version is alive now. That is different from building a whole concept map
21and different from charting an entity's metric trajectory.
22
23Use this skill when the user asks about one idea, topic, phrase, or concept
24page and wants its evolution through the brain.
25
26Canonical examples:
27
28- "Run idea lineage on founder-led sales."
29- "How has my thinking about compounding trust changed?"
30- "What is my current version of this idea?"
31- "Where did this idea come from, and what did I abandon along the way?"
32
33## What this is not
34
35- Not `concept-synthesis`: that skill deduplicates many concept stubs, tiers
36 them, writes concept pages, and builds a broad intellectual map.
37- Not `find_trajectory`: that operation charts typed facts or event rows for
38 an entity, such as MRR, role, location, or status over time.
39- Not a contradiction-probe runner: this skill may read cached contradiction
40 findings when available, but it does not launch expensive probes.
41- Not a writing mode by default: do not write a lineage page unless the user
42 explicitly asks for a saved artifact after seeing the read-only answer.
43
44## Contract
45
46This skill guarantees:
47
48- A single-idea scope is preserved. Broad corpus or "map my concepts" prompts
49 route to `skills/concept-synthesis/SKILL.md` instead.
50- Every lineage claim cites existing brain evidence: page slug, source id when
51 present, date, and short quote or snippet.
52- Missing evidence is labeled as a gap, not patched with plausible narrative.
53- Contradictions, reversals, and abandoned branches are separated from normal
54 temporal evolution.
55- The default mode is read-only and does not mutate brain pages.
56
57## Phases
58
59### Phase 1: Resolve the idea target
60
611. Restate the idea in one sentence.
622. Search for exact phrase variants with `search`.
633. Run one semantic `query` for the natural-language version.
644. Check `list_pages` for concept pages when the idea has an obvious concept
65 slug or title.
665. If results point to an entity/metric/status trajectory rather than a concept,
67 hand off to `find_trajectory` or the normal query/think trajectory path.
68
69If multiple distinct ideas share the same phrase, ask the user to choose the
70intended one before synthesizing.
71
72### Phase 2: Gather evidence
73
74Collect enough evidence to support or reject each output bucket:
75
76- Search chunks with dates and source slugs.
77- Full pages via `get_page` for the top relevant concept, note, transcript,
78 meeting, article, or project pages.
79- Related concept pages through backlinks, `related` frontmatter, or repeated
80 co-occurrence in search results.
81- Takes via `takes_search` when the idea appears as a belief, bet, hunch, or
82 attributed claim.
83- Cached contradiction findings via `find_contradictions` when the user asks
84 about inconsistency or the search results show obvious conflict.
85- `find_trajectory` only when the evidence is entity/attribute-shaped, such as
86 a role/status/metric evolution that is relevant to the idea's story.
87
88Prefer fewer high-quality sources over a long unsorted pile. Read full pages
89when snippets imply a lineage milestone.
90
91### Phase 3: Classify lineage moments
92
93Classify evidence into these buckets:
94
951. **First mention** - earliest dated evidence where the idea appears.
962. **Best articulation** - the clearest or most complete expression, not
97 necessarily the newest.
983. **Current live version** - the most recent high-authority version that still
99 appears active.
1004. **Reversals** - places where the user's stance changed direction.
1015. **Contradictions** - claims that cannot both be true at the same time or
102 under the same assumptions. Distinguish these from legitimate temporal
103 supersession.
1046. **Abandoned branches** - promising variants that appear and then disappear,
105 lose support, or are explicitly rejected.
1067. **Related concepts** - nearby ideas that shaped or inherited part of the
107 original idea.
108
109When a bucket has no evidence, write "No clear evidence found" with a brief note
110about what was checked.
111
112### Phase 4: Synthesize the lineage
113
114Write the answer in the output format below. Keep the synthesis proportional to
115the evidence. Do not overfit a smooth evolution if the evidence is sparse,
116messy, or contradictory.
117
118### Phase 5: Suggest optional next action
119
120If useful, offer one concrete follow-up:
121
122- Save the lineage as a brain page.
123- Run broad `concept-synthesis` if the user actually wants the whole concept
124 map refreshed.
125- Run or inspect trajectory data if the idea turned out to depend on structured
126 entity facts.
127- Run a contradiction probe only when stale cached findings are insufficient
128 and the user explicitly wants that heavier pass.
129
130## Output Format
131
132Use this shape for normal answers:
133
134```markdown
135## Current Live Version
136[1-3 sentences. Include confidence: high / medium / low.]
137
138## Lineage
139- First mention: [date] - [claim] ([source-id:slug], "short quote")
140- Best articulation: [date] - [claim] ([source-id:slug], "short quote")
141- Turning point: [date] - [what changed] ([source-id:slug])
142
143## Reversals and Contradictions
144- Reversal: [what changed, with before/after evidence]
145- Contradiction: [what conflicts, or "No clear evidence found"]
146
147## Abandoned Branches
148- [branch] - [why it appears abandoned, with evidence]
149
150## Related Concepts
151- [concept slug or title] - [relationship]
152
153## Evidence Gaps
154- [bucket or claim] - [what was checked and what is missing]
155```
156
157For short answers, collapse sections, but keep the same distinctions. Always
158cite the source for each non-gap claim.
159
160## Quality Rules
161
162- Quote exact text when naming first mention or best articulation.
163- Include dates when the source has dates. If no date is available, say
164 "undated" rather than guessing.
165- Treat the user's direct statements as highest authority for the user's own
166 current view.
167- Treat holder-attributed takes as beliefs by that holder, not automatically
168 as facts about the world or the brain owner.
169- Mark confidence low when evidence comes from a single weak snippet, an
170 undated page, or a fuzzy semantic match.
171- Preserve source ids in citations when search or page payloads include them.
172
173## Anti-Patterns
174
175- Running `concept-synthesis` for a single-idea question.
176- Presenting an entity's MRR, ARR, role, or status trajectory as conceptual
177 lineage without explaining the distinction.
178- Treating normal temporal evolution as contradiction.
179- Inventing abandoned branches because the story would be more interesting.
180- Saving or rewriting brain pages without explicit user instruction.
181- Using real names, companies, funds, or fork-specific examples in bundled
182 fixtures or documentation.
183
184## Related Skills and Operations
185
186- `skills/concept-synthesis/SKILL.md` - broad mutating concept-map synthesis.
187- `skills/query/SKILL.md` - general brain search and cited answers.
188- `skills/brain-ops/SKILL.md` - source attribution and brain-first behavior.
189- `find_trajectory` - structured typed-fact and event timelines for entities.
190- `find_contradictions` - cached suspected contradiction findings.
191
192## Tools Used
193
194- `search` - keyword search for exact phrase variants and dated mentions.
195- `query` - semantic search for conceptual matches.
196- `get_page` - full context for candidate source pages.
197- `list_pages` - concept-page discovery and scoped page enumeration.
198- `takes_search` - holder-attributed beliefs, bets, hunches, and facts.
199- `find_contradictions` - cached contradiction findings when relevant.
200- `find_trajectory` - optional structured entity trajectory side-channel.
201
202---
203
204**Source:** [`garrytan/gbrain`](https://github.com/garrytan/gbrain) → `skills/idea-lineage/SKILL.md`