From secondbrain
Generates freshness reports for secondbrain entities like ADRs, tasks, notes, and discussions, categorizing by staleness levels with summaries, tables, and remediation actions.
npx claudepluginhub sergio-bershadsky/ai --plugin secondbrainThis skill uses the workspace's default tool permissions.
Generate a comprehensive freshness report for all secondbrain entities.
Produces a project knowledge dashboard showing recent entries, corrections, expiring items, stale knowledge, and unresolved work. Team mode adds activity, teammate entries, and review queue.
Provides briefing on current tasks, emails, handovers, priorities from GitHub issues, git logs, and local markdown files via lazy cache regeneration. Use anytime for status checks.
Reviews Archcore documentation health: compact dashboard (counts, status, relations, orphans) or --deep full audit (coverage gaps, staleness, relation health, recommendations).
Share bugs, ideas, or general feedback.
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": [...]
}