From secondbrain
Generates freshness reports for secondbrain entities like ADRs, tasks, notes, and discussions, categorizing by staleness levels with summaries, tables, and remediation actions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/secondbrain:secondbrain-freshnessThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate a comprehensive freshness report for all secondbrain entities.
Generate a comprehensive freshness report for all secondbrain entities.
Verify secondbrain is initialized:
.claude/data/config.yamlRead .claude/data/config.yaml to get:
For each enabled entity:
Format by entity and urgency:
## Freshness Report
Generated: 2026-01-15 10:30
### Summary
| Entity | Critical | Stale | Warning | OK |
|--------|----------|-------|---------|-----|
| ADRs | 2 | 5 | 3 | 12 |
| Tasks | 0 | 8 | 4 | 15 |
| Notes | 1 | 3 | 6 | 25 |
| Discussions | 0 | 2 | 1 | 10 |
**Total needing attention:** 30 items
---
### Critical (Needs Immediate Attention)
#### ADRs (2 items)
| ID | Title | Status | Age |
|----|-------|--------|-----|
| ADR-0003 | API Gateway Selection | proposed | 95 days |
| ADR-0007 | Database Migration | draft | 78 days |
#### Notes (1 item)
| ID | Title | Age |
|----|-------|-----|
| 2025-10-01-legacy-system | Legacy System Overview | 106 days |
---
### Stale (Should Review)
#### Tasks (8 items)
| ID | Title | Status | Priority | Age |
|----|-------|--------|----------|-----|
| TASK-0012 | Update documentation | in_progress | medium | 45 days |
| TASK-0015 | Fix login bug | todo | high | 42 days |
...
---
### 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
For each critical/stale item, offer specific actions:
Update .claude/data/config.yaml:
meta:
last_freshness_check: 2026-01-15T10:30:00
Default thresholds (configurable per entity):
| Entity | Default | Critical |
|---|---|---|
| ADRs | 30 days | 60 days |
| Tasks | 14 days | 28 days |
| Notes | 30 days | 60 days |
| Discussions | 7 days | 14 days |
Skip items with terminal statuses:
## 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.
Complete breakdown with tables and recommendations (default).
{
"generated": "2026-01-15T10:30:00",
"summary": {
"critical": 3,
"stale": 18,
"warning": 13,
"ok": 62
},
"by_entity": {
"adrs": { "critical": 2, "stale": 5, ... },
...
},
"items": [...]
}
npx claudepluginhub sergio-bershadsky/ai --plugin secondbrainProduces a knowledge dashboard showing recent entries, corrections, expiring items, stale knowledge, and unresolved work. Supports team mode for cross-author context.
Provides a concise briefing on current state — tasks, emails, handovers, and priorities — by reading a lazily-regenerated cache. Useful for status checks, morning reviews, or end-of-day wrap-ups.
Conducts structured weekly retrospectives for solopreneurs: scans git repos, interviews the founder, and records findings into issues and canonical files.