Files
Cog-Sync/.claude/commands/foresight.md
Marcio Puga 28aa16226a feat: comprehensive pipeline skill upgrades from PAI learnings
- reflect: enforce-before-adding pattern gate, proactive synthesis step,
  improvements.md triage, debrief must list every file modified
- housekeeping: domain INDEX.md rebuild step, briefing bridge SSOT rule
  and richer section format with compression rules
- foresight: cruising velocity classification, non-obvious rule,
  anti-patterns section, scenario candidate format in nudge output,
  thread current-state in memory reads
- scenario: full rewrite with body template (Decision Point, Dependencies,
  Branches, Timeline Overlay, Contingency Map, Retrospective), anti-patterns,
  trigger threshold, related-threads frontmatter
- evolve: route content issues step, scorecard generation, architecture-only
  constraint on Next Run Priorities
- history: simple vs deep triage note
- CLAUDE.md: structured action items format, briefing-bridge and
  foresight-nudge in file edit table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-23 07:59:41 +11:00

5.0 KiB

Use this skill for strategic foresight — connecting dots across domains and surfacing one high-value nudge. Trigger if the user says "foresight", "what should I be thinking about", "what am I missing", "strategic nudge", "connect the dots", or similar forward-looking synthesis requests.

This is NOT /reflect. Reflect = past-facing (mines interactions, fixes contradictions). Foresight = future-facing (scans broadly, projects trajectories, surfaces opportunities).

This is NOT /evolve. Evolve = system architecture. Foresight = life/work strategy.

Domain

Cross-domain strategic synthesis — personal, work, projects, health, family. The value is in the connections between domains.

Memory Files

Read broadly — this is a scan, not a focused lookup:

  1. Read memory/domains.yml to discover all active domains
  2. For each domain, read hot-memory.md and action-items.md (if they exist)
  3. Also read:
    • memory/hot-memory.md (cross-domain strategic context)
    • memory/personal/entities.md (upcoming birthdays, relationships)
    • memory/personal/calendar.md (what's coming up)
    • memory/personal/health.md (health trajectory)
    • memory/cog-meta/briefing-bridge.md (housekeeping findings)
    • Recent observations across all domains (last 7 days)
    • Thread current-state sections — what narratives are actively unfolding?

Process

1. Cross-Domain Convergence Scan

Look for topics, people, or themes appearing in 2+ domains simultaneously. These are convergence points — where effort in one area compounds into another.

2. Velocity & Stall Detection

Scan action-items across all domains. Classify each active item:

  • Accelerating — multiple updates in the last week, clear momentum. Signal: ride the wave, don't interrupt.
  • Cruising — steady progress, on track. Signal: nothing to flag.
  • Stalling — no movement in 2+ weeks despite not being deferred. Signal: ask why. Blocked? Lost priority?
  • Dormant — domain-level silence (0 observations in 4+ weeks). Signal: conscious choice or drift?

Stalls and dormant domains are high-value nudge material — they represent things the user cares about but isn't acting on.

3. Timing Awareness

Read calendar and entities for upcoming events in the next 2-4 weeks. Look for timing windows — things that should start NOW to be ready later.

4. Pattern Projection

Read patterns and recent observations. Project forward: "If this continues for 2 more weeks, what happens?"

Scenario candidate detection: If a pattern projection reveals a genuine fork — two meaningfully different paths with real stakes and a closing decision window — flag it as a scenario candidate below the main nudge. A valid candidate needs: a fork (2+ paths), stakes (wrong choice has real cost), and time sensitivity (window closing). Don't flag routine decisions or hypotheticals with no deadline.

5. Write One Strategic Nudge

Synthesize into one nudge. Not a list. One thing.

The nudge must:

  • Cite at least 2 source files
  • Be something the user hasn't explicitly asked about
  • Be actionable — not "think about X" but "do Y because of X and Z"
  • Connect dots

Write to memory/cog-meta/foresight-nudge.md:

# Foresight Nudge
<!-- Auto-generated by strategic foresight. -->
<!-- Last updated: YYYY-MM-DD -->

## Signal
<What you noticed — the raw observation from 2+ domains>

## Insight
<Why it matters — the connection, timing, or trajectory that makes this worth flagging>

## Suggested Action
<One concrete thing to do — specific, actionable, grounded>

---
Sources: [[file1]], [[file2]], [[file3]]

## Scenario Candidate (optional)
<!-- Only include if pattern projection reveals a genuine fork worth simulating -->
Decision: <one-line framing>
Why now: <why the window is closing>
Domains: <affected domains>

Overwrite the file each run. One nudge per run.

Rules

  1. Read-only — Foresight NEVER edits memory files. Writes ONLY to memory/cog-meta/foresight-nudge.md. If you spot a memory error, note it in the nudge's signal section and let reflect handle it.
  2. One nudge, not a list — force prioritization. If everything is equally important, nothing is.
  3. Evidence-based — every nudge cites at least 2 source files. No vibes.
  4. Non-obvious — the nudge should surprise. If the user already knows and is acting on it, pick something else.
  5. Forward-looking — avoid rehashing yesterday. Project into next week, next month.
  6. Cross-domain preferred — nudges that connect personal + work are higher value than single-domain insights.

Anti-Patterns

  • Don't repeat what briefing-bridge already says (stale items, birthday prep) — that's housekeeping's job
  • Don't recommend "reflect on X" — be specific about what to DO
  • Don't flag things the user has explicitly deferred — respect the deferral
  • Don't flag things that are cruising — focus on convergences, stalls, and timing windows
  • Don't write a mini-briefing — one insight, one action

Activation

Read broadly across all domains. Find the one thing worth saying.