AGENT SKILL

memory-documentary

Generate evidence-based documentary reports by searching across Brain memory notes, project artifacts, and GitHub issues. Produces investigative journalism-style analysis with full citation chains.

License 许可
MIT
所属仓库
loriensleafs/brain
最近更新
2026-03-11
Stars
★ 0
Forks
0

01 前言 Front Matter

name
memory-documentary
model
claude-sonnet-4-5
agents
[ "analyst", "memory" ]
license
MIT
metadata
{ "version": "2.0.0", "category": "analysis", "timelessness": "8/10" }
description
Generate evidence-based documentary reports by searching across Brain memory notes, project artifacts, and GitHub issues. Produces investigative journalism-style analysis with full citation chains.

02 资源文件 1

03 SKILL.md 正文

Memory Documentary Skill

Generate comprehensive documentary-style reports from your memory systems with full evidence chains.


Quick Start

/memory-documentary [topic]

Example topics:

  • "recurring frustrations"
  • "coding patterns not codified"
  • "evolution of thinking on testing"
  • "decisions I second-guessed"
  • "what I complain about most"

Triggers

Use this skill when:

  • Search my memories for patterns about...
  • What does my history say about...
  • Generate a documentary on my [topic]
  • Cross-reference all systems for...
  • Evidence-based analysis of my [topic]

When to Use

Use this skill when:

  • You need cross-system evidence for a pattern or recurring theme
  • Investigating historical decisions and their evolution over time
  • Building a cited, verifiable narrative from memory data

Use memory skill instead when:

  • You need a simple search for a known fact or pattern
  • The query targets a single topic, not cross-system synthesis

Quick Reference

Phase Action Output
1 Topic Comprehension Search variants, scope boundaries
2 Investigation Planning Explicit queries per source
3 Data Collection Evidence with identifiers, timestamps
4 Report Generation Documentary with citations
5 Memory Updates Store meta-pattern discovered

Process

The skill searches ALL available data sources systematically:

Brain Memory Notes:

  • Semantic search across all note types (decisions, sessions, analysis, etc.)
  • Depth-based graph traversal for related notes
  • Folder-scoped searches for domain-specific findings

Project Artifacts:

  • sessions/ - Session logs (via Brain notes or file system)
  • analysis/ - Research reports
  • decisions/ - ADRs
  • planning/ - Plans and PRDs
  • retrospective/ - Learning extractions

GitHub Issues:

  • Open and closed issues
  • Comments and related PRs

Commands

# Standard invocation
/memory-documentary "recurring frustrations"

# With explicit time range
/memory-documentary "testing patterns" --since 2025-12-01

Report Structure

Executive Summary

  • Key finding in one sentence
  • Timeline span (earliest to most recent)
  • Evidence count (notes + issues + files)
  • Major pattern categories

Evidence Trail

Full citation for each finding:

  • Note title/permalink with retrieval command
  • Source folder (decisions/, sessions/, analysis/, etc.)
  • Creation date
  • Direct quote from source
  • Links to related evidence

Pattern Evolution

Timeline showing how thinking changed:

YYYY-MM-DD: [Note: ADR-015] - Initial state
YYYY-MM-DD: [Note: SESSION-2025-01-15] - First iteration
YYYY-MM-DD: [Issue #NNN] - Technical response

Unexpected Patterns

Cross-system synthesis revealing:

  • Frequency patterns (time clustering)
  • Correlation patterns (X happens before Y)
  • Avoidance patterns (conspicuous absence)
  • Contradiction patterns (saying vs doing)
  • Evolution patterns (recursive loops)
  • Emotional patterns (frustration markers)

Synthesis

  • What all sources agree on
  • What is recent vs crystallized knowledge
  • Actionable recommendations

Evidence Standards

Standard Requirement
Citation Every claim has note identifier, timestamp, quote
Quotes Direct quotes, not paraphrases
Verification Retrieval commands for all evidence
Cross-links Related evidence connected

Anti-Patterns

Avoid Why Instead
Partial searches Miss critical evidence Search across all folders and sources
Paraphrasing Loses verifiability Direct quotes only
Single query Miss variations 3+ query variants
Skipping folder scopes Incomplete picture Search decisions/, sessions/, analysis/, planning/

Verification

After execution:

  • [ ] Report saved to analysis/ folder in Brain memory
  • [ ] Every claim has a citation with source, identifier, and direct quote
  • [ ] Brain memory was searched across relevant folders
  • [ ] Meta-pattern stored as new Brain memory note (Phase 5)

Output Location

Reports saved as Brain memory notes in the analysis/ folder.


Related Skills

Skill Relationship
memory Operations (search, read, write)
exploring-knowledge-graph Brain graph traversal
retrospective Learning extraction
skillbook Pattern to skill conversion

On Invocation

Read: references/execution-protocol.md

This contains the full 5-phase execution protocol with detailed instructions for each data source.

04 同仓库更多 Skills

loriensleafs
loriensleafs/brain

validation-authority

Treat upstream validators as authoritative. Align local config to them. Use when validation fails unexpectedly, before modifying validator behavior, or when tempted to change upstream tool code.

★ 0
loriensleafs
loriensleafs/brain

using-brain-memory

Guidance for using Brain semantic memory effectively. Applies Zettelkasten atomic note principles with observations and relations. Use when deciding whether to query or create notes, structuring note content, or understanding the semantic knowledge graph.

★ 0
loriensleafs
loriensleafs/brain

threat-modeling

Structured security analysis using OWASP Four-Question Framework and STRIDE methodology. Generates threat matrices with risk ratings, mitigations, and prioritization. Use for attack surface analysis, security architecture review, or when asking what can go wrong.

★ 0
loriensleafs
loriensleafs/brain

taste-lints

Custom lints with agent-readable remediation instructions. Enforces taste invariants (file size, naming conventions, structured logging, complexity) and surfaces errors that agents can act on directly. Use when writing or reviewing code to catch style violations early.

Skill与智能体开发
★ 0
loriensleafs
loriensleafs/brain

style-enforcement

Validate code against style rules from .editorconfig, StyleCop.json, and Directory.Build.props. Detects line ending violations, naming convention issues, indentation problems, and charset mismatches across C#, Python, TypeScript, and JavaScript. Produces JSON reports for pre-commit hooks and CI pipelines.

★ 0
loriensleafs
loriensleafs/brain

steering-matcher

Match file paths against steering file glob patterns to determine applicable steering guidance. Use when orchestrator needs to inject context-aware guidance based on files being modified.

★ 0