Back to Details

secondbrain-freshness

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Freshness Report

新鲜度报告

Generate a comprehensive freshness report for all secondbrain entities.
为所有secondbrain实体生成全面的新鲜度报告。

Prerequisites

前置条件

Verify secondbrain is initialized:
  1. Check for 
    .claude/data/config.yaml
  2. If not found, indicate no secondbrain project found
确认secondbrain已初始化：
  1. 检查是否存在 
    .claude/data/config.yaml
  2. 若未找到，提示未发现secondbrain项目

Workflow

工作流

Step 1: Load Configuration

步骤1：加载配置

Read 
.claude/data/config.yaml
to get:
  • All enabled entities
  • Freshness thresholds per entity
  • Monthly partitioning settings
读取 
.claude/data/config.yaml
以获取：
  • 所有已启用的实体
  • 每个实体的新鲜度阈值
  • 月度分区设置

Step 2: Analyze Each Entity

步骤2：分析每个实体

For each enabled entity:
  1. Load all records
  2. Check date fields (created, date, date_updated)
  3. Compare against freshness threshold
  4. Categorize by staleness level:
    • Critical (2x threshold): Needs immediate attention
    • Stale (1x threshold): Should be reviewed
    • Warning (0.75x threshold): Approaching staleness
针对每个已启用的实体：
  1. 加载所有记录
  2. 检查日期字段（created、date、date_updated）
  3. 与新鲜度阈值进行对比
  4. 按过时程度分类：
    • 严重（2倍阈值）：需立即处理
    • 过时（1倍阈值）：应进行审核
    • 警告（0.75倍阈值）：即将过时

Step 3: Generate Report

步骤3：生成报告

Format by entity and urgency:
undefined
按实体和紧急程度格式化：
undefined

Freshness Report

Freshness Report

Generated: 2026-01-15 10:30
Generated: 2026-01-15 10:30

Summary

Summary

EntityCriticalStaleWarningOK
ADRs25312
Tasks08415
Notes13625
Discussions02110
Total needing attention: 30 items
EntityCriticalStaleWarningOK
ADRs25312
Tasks08415
Notes13625
Discussions02110
Total needing attention: 30 items

Critical (Needs Immediate Attention)

Critical (Needs Immediate Attention)

ADRs (2 items)

ADRs (2 items)

IDTitleStatusAge
ADR-0003API Gateway Selectionproposed95 days
ADR-0007Database Migrationdraft78 days
IDTitleStatusAge
ADR-0003API Gateway Selectionproposed95 days
ADR-0007Database Migrationdraft78 days

Notes (1 item)

Notes (1 item)

IDTitleAge
2025-10-01-legacy-systemLegacy System Overview106 days
IDTitleAge
2025-10-01-legacy-systemLegacy System Overview106 days

Stale (Should Review)

Stale (Should Review)

Tasks (8 items)

Tasks (8 items)

IDTitleStatusPriorityAge
TASK-0012Update documentationin_progressmedium45 days
TASK-0015Fix login bugtodohigh42 days
...
IDTitleStatusPriorityAge
TASK-0012Update documentationin_progressmedium45 days
TASK-0015Fix login bugtodohigh42 days
...

Recommended Actions

Recommended Actions

  1. ADR-0003: 95 days in "proposed" status
    • Action: Review and move to admitted/rejected
  2. ADR-0007: 78 days in "draft" status
    • Action: Complete draft or cancel
  3. TASK-0012: 45 days in progress
    • Action: Check if blocked, update status
  4. 2025-10-01-legacy-system: 106 days old note
    • Action: Archive or update content
undefined
  1. ADR-0003: 95 days in "proposed" status
    • Action: Review and move to admitted/rejected
  2. ADR-0007: 78 days in "draft" status
    • Action: Complete draft or cancel
  3. TASK-0012: 45 days in progress
    • Action: Check if blocked, update status
  4. 2025-10-01-legacy-system: 106 days old note
    • Action: Archive or update content
undefined

Step 4: Offer Remediation

步骤4：提供补救建议

For each critical/stale item, offer specific actions:
  • Draft ADRs: Complete or cancel
  • Proposed ADRs: Review and decide
  • In-progress tasks: Check if blocked
  • Old notes: Archive or refresh
  • Stale discussions: Mark resolved or schedule follow-up
针对每个严重/过时条目，提供具体操作建议：
  • 草稿ADRs： 完成或取消
  • 待审核ADRs： 审核并决策
  • 进行中任务： 检查是否受阻
  • 旧笔记： 归档或更新内容
  • 过时讨论： 标记为已解决或安排跟进

Step 5: Update Last Check

步骤5：更新最后检查时间

Update 
.claude/data/config.yaml
:
yaml
meta:
  last_freshness_check: 2026-01-15T10:30:00
更新 
.claude/data/config.yaml
：
yaml
meta:
  last_freshness_check: 2026-01-15T10:30:00

Staleness Thresholds

过时阈值

Default thresholds (configurable per entity):
EntityDefaultCritical
ADRs30 days60 days
Tasks14 days28 days
Notes30 days60 days
Discussions7 days14 days
默认阈值（可按实体配置）：
EntityDefaultCritical
ADRs30 days60 days
Tasks14 days28 days
Notes30 days60 days
Discussions7 days14 days

Status Exceptions

状态例外

Skip items with terminal statuses:
  • ADRs: implemented, tested, rejected, canceled
  • Tasks: done, completed, canceled
  • Notes: archived
  • Discussions: archived
跳过处于终态的条目：
  • ADRs： implemented、tested、rejected、canceled
  • Tasks： done、completed、canceled
  • Notes： archived
  • Discussions： archived

Output Formats

输出格式

Summary Only

仅摘要

undefined
undefined

Freshness Summary

Freshness Summary

  • Critical: 3 items need immediate attention
  • Stale: 18 items should be reviewed
  • Warning: 13 items approaching staleness
Run with 
--detailed
for full breakdown.
undefined
  • Critical: 3 items need immediate attention
  • Stale: 18 items should be reviewed
  • Warning: 13 items approaching staleness
Run with 
--detailed
for full breakdown.
undefined

Full Report

完整报告

Complete breakdown with tables and recommendations (default).
包含表格和建议的完整明细（默认格式）。

JSON Export

JSON导出

json
{
  "generated": "2026-01-15T10:30:00",
  "summary": {
    "critical": 3,
    "stale": 18,
    "warning": 13,
    "ok": 62
  },
  "by_entity": {
    "adrs": { "critical": 2, "stale": 5, ... },
    ...
  },
  "items": [...]
}
json
{
  "generated": "2026-01-15T10:30:00",
  "summary": {
    "critical": 3,
    "stale": 18,
    "warning": 13,
    "ok": 62
  },
  "by_entity": {
    "adrs": { "critical": 2, "stale": 5, ... },
    ...
  },
  "items": [...]
}

Tips

提示

  1. Run weekly — Set calendar reminder for freshness reviews
  2. Address critical first — Focus on oldest items
  3. Archive liberally — Better to archive than ignore
  4. Update thresholds — Adjust based on your workflow pace
  5. Check after sprints — Good time to clean up stale items
  1. 每周运行一次 — 设置日历提醒进行新鲜度审核
  2. 优先处理严重条目 — 聚焦最旧的内容
  3. 大胆归档 — 归档好过忽略
  4. 更新阈值 — 根据你的工作节奏调整
  5. Sprint后检查 — 清理过时条目的好时机