Enterprise Context Refresh
Invocation: As your first action, call
crane_skill_invoked(skill_name: "context-refresh"). This is non-blocking — if the call fails, log the warning and continue. Usage data drives/skill-audit.
Audit and update all enterprise context: D1 docs, VCMS executive summaries, and venture metadata. Produces a refresh report and records cadence completion.
/context-refresh [venture-code | --audit-only]
vc): Audit + fix for a single venture--audit-only: Report only, no changesRun the doc audit to get the full status matrix:
crane_doc_audit(all: true)crane_doc_audit(venture: "{code}")Display the audit results showing present, missing, and stale docs per venture.
Unless --audit-only is set:
crane_doc_audit(all: true, fix: true)crane_doc_audit(venture: "{code}", fix: true)This regenerates all auto-generable missing AND stale docs. The content-hash guard prevents no-op uploads when source files haven't changed.
Report which docs were generated, refreshed, unchanged, or failed.
For each venture (or the specified venture), check the executive summary age:
crane_notes(tag: "executive-summary", venture: "{code}")
Flag any summary older than 30 days as stale. For stale summaries:
config/ventures.json for portfolio metadata (status, BVM stage, tagline, tech stack)prd or strategy for the venturecrane_note(action: "update", id: "{note_id}", content: "...")Read config/ventures.json. For each venture:
capabilities match reality (look for workers/*/src for has_api, migrations/ for has_database)portfolio.bvmStage matches the executive summaryrepos list is currentFlag any drift but do NOT auto-fix - present findings to Captain.
## Context Refresh Report
| Venture | Docs | Exec Summary | Drift |
|---------|------|--------------|-------|
| vc | 3/3 refreshed | Updated (was 49d old) | None |
| sc | 3/3 unchanged | Stale (49d) - pending approval | None |
...
### Summary
- Docs: N generated, M refreshed, K unchanged, J failed
- Exec Summaries: X updated, Y pending approval, Z current
crane_schedule(action: "complete", name: "context-refresh", result: "{success|warning|failure}", completed_by: "crane-mcp-{hostname}", summary: "{brief outcome}")
Result mapping:
success: All docs refreshed, all exec summaries current or updatedwarning: Some docs failed or exec summaries still stale (pending approval)failure: Audit or regeneration failed entirely~/dev/{code}-console)config/ventures.json without Captain approval