{"slug":"knowledge-consolidation","title":"knowledge-consolidation","summary":"Build frameworks from scattered insights across all braindumps and notes","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-28T15:11:30.354355Z","repo":{"url":"https://github.com/huytieu/COG-second-brain","stars":1236,"forks":147,"license":"MIT","updatedAt":"2026-09-28T08:52:07Z"},"bodyHtml":"<hr>\n<h2>name: knowledge-consolidation\ndescription: Build frameworks from scattered insights across all braindumps and notes\nroles: [all]\nintegrations: []</h2>\n<h1>COG Knowledge Consolidation Skill</h1>\n<h2>Purpose</h2>\n<p>Transform scattered insights from braindumps, daily briefs, and check-ins into coherent frameworks and \"single source of truth\" knowledge documents through pattern recognition and systematic synthesis.</p>\n<h2>When to Invoke</h2>\n<ul>\n<li>User wants to consolidate their insights</li>\n<li>User says \"consolidate knowledge\", \"build frameworks\", \"synthesize insights\"</li>\n<li>Time for periodic knowledge base maintenance (weekly, monthly, quarterly)</li>\n<li>User wants to extract patterns from accumulated braindumps</li>\n<li>Before major decisions that could benefit from framework consultation</li>\n</ul>\n<h2>Agent Mode Awareness</h2>\n<p><strong>Check <code>agent_mode</code> in <code>00-inbox/MY-PROFILE.md</code> frontmatter:</strong></p>\n<ul>\n<li>If <code>agent_mode: team</code> — delegate scanning and pattern extraction to parallel sub-agents (e.g., one per domain: personal braindumps, professional braindumps, project-specific content, daily briefs). Each agent identifies themes and patterns, then a synthesis agent combines findings into frameworks.</li>\n<li>If <code>agent_mode: solo</code> (default) — handle all scanning, pattern recognition, and framework building directly. No delegation.</li>\n</ul>\n<h2>Pre-Flight Check</h2>\n<p><strong>Get current timestamp (REQUIRED before generating any files):</strong></p>\n<ol>\n<li>Run <code>date '+%Y-%m-%d %H:%M'</code> using Bash to get the actual current date and time</li>\n<li>Store this value and use it for the <code>created:</code> frontmatter field</li>\n<li>NEVER guess or fabricate the time — always use the value returned by the <code>date</code> command</li>\n</ol>\n<h2>Process Flow</h2>\n<h3>1. Data Gathering</h3>\n<p><strong>Scan vault for unprocessed or partially processed content:</strong></p>\n<ul>\n<li><p>All braindumps since last consolidation:</p>\n<ul>\n<li><code>02-personal/braindumps/</code></li>\n<li><code>03-professional/braindumps/</code></li>\n<li><code>04-projects/*/braindumps/</code></li>\n<li><code>00-inbox/braindump-*.md</code> (mixed domain)</li>\n</ul>\n</li>\n<li><p>Daily briefs and check-ins:</p>\n<ul>\n<li><code>01-daily/briefs/</code></li>\n<li><code>01-daily/checkins/</code></li>\n</ul>\n</li>\n<li><p>Any meeting transcripts or project documents in:</p>\n<ul>\n<li><code>04-projects/*/planning/</code></li>\n<li><code>04-projects/*/resources/</code></li>\n</ul>\n</li>\n</ul>\n<p><strong>Determine scope:</strong></p>\n<ul>\n<li>Ask user: \"What time period should I analyze? (last week, last month, last quarter, all time, or custom range?)\"</li>\n<li>Identify unprocessed content (check for <code>status: \"captured\"</code> or missing consolidation metadata)</li>\n</ul>\n<p><strong>Gather statistics:</strong></p>\n<ul>\n<li>Total documents to analyze</li>\n<li>Breakdown by domain and type</li>\n<li>Date range coverage</li>\n</ul>\n<h3>2. Pattern Recognition</h3>\n<p>Apply systematic pattern detection across all content:</p>\n<h4>Frequency Analysis</h4>\n<p><strong>What comes up repeatedly?</strong></p>\n<ul>\n<li>Identify themes mentioned across multiple documents</li>\n<li>Track topic frequency and clustering</li>\n<li>Recognize persistent questions or concerns</li>\n<li>Spot recurring action items or decisions</li>\n</ul>\n<h4>Temporal Clustering</h4>\n<p><strong>What insights emerged together?</strong></p>\n<ul>\n<li>Group related insights by time period</li>\n<li>Identify how thinking evolved over time</li>\n<li>Recognize inflection points where thinking shifted</li>\n<li>Map catalysts that triggered changes</li>\n</ul>\n<h4>Domain Correlation</h4>\n<p><strong>What patterns cross domains?</strong></p>\n<ul>\n<li>Personal insights affecting professional thinking</li>\n<li>Professional learnings applied to projects</li>\n<li>Project experiences informing personal growth</li>\n<li>Strategic themes spanning all domains</li>\n</ul>\n<h4>Contradiction Analysis</h4>\n<p><strong>Where does thinking conflict?</strong></p>\n<ul>\n<li>Identify contradictory thoughts or approaches</li>\n<li>Recognize evolution vs. inconsistency</li>\n<li>Understand resolution or ongoing tension</li>\n<li>Track perspective shifts over time</li>\n</ul>\n<h4>Cross-Cutting Patterns</h4>\n<p><strong>Meta-patterns across all dimensions:</strong></p>\n<ul>\n<li>Decision-making approaches</li>\n<li>Problem-solving strategies</li>\n<li>Learning patterns</li>\n<li>Emotional/energy patterns</li>\n<li>Relationship patterns</li>\n<li>Creative processes</li>\n</ul>\n<h3>3. Framework Development</h3>\n<p>Synthesize patterns into actionable frameworks:</p>\n<h4>Identify Core Principles</h4>\n<p><strong>From scattered insights to fundamental truths:</strong></p>\n<ul>\n<li>What patterns reveal deeper principles?</li>\n<li>What rules or heuristics emerge?</li>\n<li>What mental models are forming?</li>\n<li>What strategies are proving effective?</li>\n</ul>\n<h4>Test Against Evidence</h4>\n<p><strong>Validate frameworks with source material:</strong></p>\n<ul>\n<li>Do source insights support these principles?</li>\n<li>Are there counter-examples or exceptions?</li>\n<li>How confident can we be in this framework?</li>\n<li>What are the boundary conditions?</li>\n</ul>\n<h4>Define Boundaries</h4>\n<p><strong>When does framework apply/not apply?</strong></p>\n<ul>\n<li>What contexts does this framework serve?</li>\n<li>What are its limitations?</li>\n<li>When should it NOT be used?</li>\n<li>What assumptions does it rely on?</li>\n</ul>\n<h4>Create Applications</h4>\n<p><strong>How to use this framework:</strong></p>\n<ul>\n<li>Specific use cases</li>\n<li>Decision-making applications</li>\n<li>Problem-solving templates</li>\n<li>Practical implementation steps</li>\n</ul>\n<h3>4. Knowledge Integration</h3>\n<p>Update and create knowledge base documents:</p>\n<h4>Update Existing Frameworks</h4>\n<p>For each framework that needs updating, use the consolidated-knowledge template in <code>references/templates.md</code>.</p>\n<p>Save to: <code>05-knowledge/consolidated/[framework-name]-framework.md</code></p>\n<h4>Create New Frameworks</h4>\n<p>For newly identified frameworks, use the new-framework template in <code>references/templates.md</code>.</p>\n<p>Save to: <code>05-knowledge/consolidated/[framework-name]-framework.md</code></p>\n<h4>Update Pattern Documentation</h4>\n<p>Document the pattern using the pattern template in <code>references/templates.md</code>.</p>\n<p>Save to: <code>05-knowledge/patterns/pattern-[name].md</code></p>\n<h4>Create Timeline Entries</h4>\n<p>Build the timeline entry using the thinking-evolution template in <code>references/templates.md</code>.</p>\n<p>Save to: <code>05-knowledge/timeline/[topic]-evolution-YYYY-MM.md</code></p>\n<h3>5. Generate Consolidation Report</h3>\n<p>Create the master consolidation document using the report template in <code>references/templates.md</code>.</p>\n<p>Save to: <code>05-knowledge/consolidated/consolidation-YYYY-MM-DD.md</code></p>\n<h3>6. Cleanup and Archival</h3>\n<p><strong>Mark processed braindumps:</strong>\nUpdate frontmatter in processed braindumps:</p>\n<pre><code>status: \"consolidated\"\nconsolidated_in: \"[[consolidation-YYYY-MM-DD]]\"\nconsolidated_date: \"YYYY-MM-DD\"\n</code></pre>\n<p><strong>Archive outdated content:</strong>\nMove superseded frameworks or insights to:\n<code>00-inbox/archive/[filename]-archived-YYYY-MM-DD.md</code></p>\n<p>Add note explaining why archived and what supersedes it.</p>\n<p><strong>Maintain clean knowledge base:</strong></p>\n<ul>\n<li>Remove redundancy while preserving important context</li>\n<li>Update cross-references</li>\n<li>Fix broken links</li>\n<li>Ensure consistent tagging</li>\n</ul>\n<h3>7. Confirm Completion</h3>\n<p>After consolidation:</p>\n<ul>\n<li>Show user: \"Knowledge consolidation complete! Processed <input disabled=\"disabled\" type=\"checkbox\" checked=\"checked\"> documents\"</li>\n<li>Highlight: \"<input disabled=\"disabled\" type=\"checkbox\" checked=\"checked\"> frameworks updated, <input disabled=\"disabled\" type=\"checkbox\" checked=\"checked\"> new frameworks created\"</li>\n<li>Show: \"Consolidation report saved to [file path]\"</li>\n<li>Suggest reviewing key frameworks created/updated</li>\n<li>Offer to explain any specific framework in detail</li>\n</ul>\n<h2>Loop Engineering</h2>\n<p>Consolidation is a <strong>loop-until-dry extraction with a completeness critic</strong>, not a single scan. See <code>.claude/skills/loop-engineering/SKILL.md</code> for the shared vocabulary.</p>\n<p><strong>The loop:</strong> scan a batch of in-scope documents → extract themes, patterns, and candidate framework principles → run the completeness critic (\"any in-scope doc not yet read? any theme recurring across N+ docs that no framework captures yet?\") → if the critic surfaces something new, run another extraction pass → stop when 2 passes in a row surface nothing new (dry). In <code>agent_mode: team</code>, the first scan fans out as one worker per domain (personal / professional / per-project / briefs); each returns its conclusions only, and a synthesis pass merges them.</p>\n<p><strong>The verifier (deterministic where it can be):</strong></p>\n<ul>\n<li><strong>Traceability:</strong> every framework principle links at least one source document. A principle with no <code>[[source]]</code> is dropped, not published. This is mechanical and is COG's verification-first rule for consolidation.</li>\n<li><strong>Coverage:</strong> every in-scope document ends marked <code>status: \"consolidated\"</code> with a <code>consolidated_in</code> backlink.</li>\n<li><strong>Dedup:</strong> before creating a framework, check <code>05-knowledge/consolidated/</code> so an existing framework is updated, not duplicated.</li>\n<li>The completeness critic (\"did we miss a theme?\") is the one judgment-based check; keep it explicit and evidence-linked.</li>\n</ul>\n<p><strong>Termination conditions (layered):</strong></p>\n<ul>\n<li><strong>Dry:</strong> K=2 consecutive passes find no new theme or document.</li>\n<li><strong>Coverage complete:</strong> all in-scope documents marked consolidated.</li>\n<li><strong>Hard cap:</strong> a max number of extraction passes, so a noisy corpus cannot loop forever.</li>\n</ul>\n<p><strong>Patterns:</strong> loop-until-dry (the spine) + plan-execute-verify (each pass) + orchestrator-workers (team-mode domain scans) + completeness critic.</p>\n<p><strong>In-loop context:</strong> write the consolidation report incrementally and dedup new themes against the running set, not against the conversation. Externalizing to the report file is what keeps a large corpus from overflowing the window.</p>\n<h2>Consolidation Guidelines</h2>\n<h3>Quality Over Quantity</h3>\n<ul>\n<li>Don't force insights that aren't mature enough</li>\n<li>Let patterns emerge naturally from evidence</li>\n<li>Be patient with incomplete thinking</li>\n<li>Quality frameworks require time and evidence</li>\n<li>Mark frameworks as \"emerging\" vs \"working\" vs \"stable\"</li>\n</ul>\n<h3>Preserve Nuance</h3>\n<ul>\n<li>Don't over-simplify complex insights</li>\n<li>Maintain important context and conditions</li>\n<li>Note when frameworks have limitations</li>\n<li>Preserve contradictions that haven't resolved yet</li>\n<li>Acknowledge uncertainty explicitly</li>\n</ul>\n<h3>Maintain Traceability</h3>\n<ul>\n<li>Always link back to source documents</li>\n<li>Show evidence trail for frameworks</li>\n<li>Document evolution of thinking</li>\n<li>Enable future validation or revision</li>\n<li>Make it easy to audit framework claims</li>\n</ul>\n<h3>Living Documents</h3>\n<ul>\n<li>Frameworks should evolve with new insights</li>\n<li>Regular updates better than perfect first draft</li>\n<li>Clear status indicators (emerging/working/stable)</li>\n<li>Encourage iteration and refinement</li>\n<li>Version history through Git</li>\n</ul>\n<h2>Analysis Techniques Reference</h2>\n<h3>Pattern Detection Methods</h3>\n<ol>\n<li><strong>Frequency Analysis:</strong> Count mentions, cluster topics</li>\n<li><strong>Temporal Clustering:</strong> Group by time, track evolution</li>\n<li><strong>Domain Correlation:</strong> Cross-domain connections</li>\n<li><strong>Contradiction Analysis:</strong> Identify conflicts, track resolution</li>\n<li><strong>Energy Pattern Detection:</strong> Emotional and practical patterns</li>\n</ol>\n<h3>Framework Synthesis Process</h3>\n<ol>\n<li><strong>Identify Core Principles:</strong> Extract fundamental truths</li>\n<li><strong>Test Against Evidence:</strong> Validate with sources</li>\n<li><strong>Define Boundaries:</strong> Establish applicability</li>\n<li><strong>Create Applications:</strong> Develop use cases</li>\n<li><strong>Document Evolution:</strong> Track development over time</li>\n</ol>\n<h3>Timeline Construction Method</h3>\n<ol>\n<li><strong>Mark Inflection Points:</strong> When thinking shifted</li>\n<li><strong>Identify Catalysts:</strong> What triggered changes</li>\n<li><strong>Document Evolution:</strong> How understanding developed</li>\n<li><strong>Extract Learnings:</strong> What evolution teaches</li>\n</ol>\n<h2>Success Metrics</h2>\n<ul>\n<li>Completeness: All relevant insights processed</li>\n<li>Coherence: Frameworks logically consistent</li>\n<li>Traceability: Clear links to source material</li>\n<li>Actionability: Frameworks applicable to decisions</li>\n<li>Evolution: Documented thinking progression</li>\n<li>User Value: Frameworks actually used in practice</li>\n</ul>\n<h2>Common Use Cases</h2>\n<ul>\n<li><strong>Weekly Consolidation:</strong> Process week's insights into patterns</li>\n<li><strong>Monthly Framework Development:</strong> Build strategic frameworks</li>\n<li><strong>Quarterly Strategic Synthesis:</strong> Big-picture consolidation</li>\n<li><strong>Annual Knowledge Base Cleanup:</strong> Maintain quality and relevance</li>\n<li><strong>Pre-Decision Framework Consultation:</strong> Apply frameworks to major decisions</li>\n<li><strong>Project Retrospective:</strong> Extract learnings for frameworks</li>\n</ul>\n<h2>Philosophy</h2>\n<p>The knowledge consolidation skill embodies COG's self-evolving intelligence:</p>\n<ul>\n<li>Transforms scattered thoughts into strategic frameworks</li>\n<li>Honors the evolution of thinking over time</li>\n<li>Builds \"single source of truth\" living documents</li>\n<li>Maintains traceability and evidence-based reasoning</li>\n<li>Creates actionable knowledge for better decision-making</li>\n<li>Respects nuance while seeking patterns</li>\n<li>Values iteration and continuous refinement</li>\n</ul>\n","files":[{"path":"references/templates.md","sizeBytes":11927,"isText":true},{"path":"SKILL.md","sizeBytes":11654,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-28T15:11:58.957932Z","sha256":"2302960C7D5E00C0FFDC011B7971B8C64D9031A565DD1CD8BC6660D754CC5A47","sizeBytes":8891},"review":null,"source":{"repositoryUrl":"https://github.com/huytieu/COG-second-brain","path":"skills/knowledge-consolidation","license":"MIT","commit":"4cdb6015dc6eb66f74bac513856ff6446ecb5d1b","subtreeSha":"D7FCA98B8C209A21F010FE675579B555D8612C17E2828A791060340DB289B0BF","lastSyncedAt":"2026-09-28T15:11:28.148164Z"},"reviewedAt":"2026-09-28T15:12:26.877863Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/huytieu/COG-second-brain/tree/main/skills/knowledge-consolidation"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install huytieu-cog-second-brain@llmmart"},{"target":"git","command":"git clone https://github.com/huytieu/COG-second-brain.git"}]}