Cross-cutting project status dashboard. Shows active epics with progress ratios, actionable next steps, blocked items, in-progress tasks, GitHub issues, and session context. Produces rich terminal output with clickable links. Triggers on: 'project status', 'swain status', 'what's next', 'dashboard', 'overview', 'where are we', 'what should I work on', 'am I blocked', 'what needs review', 'show me priorities'.
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
Cross-cutting project status dashboard. Shows active epics with progress ratios, actionable next steps, blocked items, in-progress tasks, GitHub issues, and session context. Produces rich terminal output with clickable links. Triggers on: 'project status', 'swain status', 'what's next', 'dashboard', 'overview', 'where are we', 'what should I work on', 'am I blocked', 'what needs review', 'show me priorities'.
user-invocable
true
license
MIT
allowed-tools
Bash, Read, Glob, Grep
metadata
{"short-description":"Cross-cutting project status dashboard","version":"1.0.0","author":"cristos","source":"swain"}
Status
Cross-cutting project status dashboard. Aggregates data from artifact lifecycle (swain chart), task tracking (tk), git, GitHub issues, and session state into an activity-oriented view.
When invoked
Locate and run the status script from skills/swain-status/scripts/swain-status.sh:
SKILL_DIR=
bash --refresh
# Find the script from the project root or installed skills directories
If the path search fails, glob for **/swain-status/scripts/swain-status.sh.
The script's terminal output uses OSC 8 hyperlinks for clickable artifact links. Let the terminal output scroll by — it is reference data, not the primary output.
After the script runs, present a structured agent summary following the template in references/agent-summary-template.md. The agent summary is what the user reads for decision-making. It must lead with a Recommendation section (see below), then Decisions Needed, then Work Ready to Start, then reference data — following the template in references/agent-summary-template.md.
This outputs 4-5 lines suitable for the MOTD box: branch, active epic progress, current task, ready count, assigned issue count.
Cache
The script writes a JSON cache to the project-local agents directory:
.agents/status-cache.json
TTL: 120 seconds (configurable via status.cacheTTL in settings)
Force refresh:--refresh flag bypasses TTL
JSON access:--json flag outputs raw cache for programmatic use
The MOTD can read this cache cheaply between full refreshes.
Migration: If .agents/status-cache.json does not exist but ~/.claude/projects/<project-path-slug>/memory/status-cache.json does, read the old location once and write to the new location going forward.
Recommendation
The recommendation uses a scoring formula:
score = unblock_count × vision_weight
Where vision_weight is inherited from the artifact's Vision ancestor (high=3, medium=2, low=1, default=medium). Read .priority.recommendations[0] from the JSON cache for the top-ranked item.
Tiebreakers (applied in order):
Higher decision debt in the artifact's vision
Decision-type artifacts over implementation-type
Artifact ID (deterministic fallback)
When a focus lane is set, recommendations are scoped to that vision/initiative. Peripheral visions are summarized separately (see Peripheral Awareness).
If attention drift is detected for the recommended item's vision, include it as context in the recommendation.
Mode Inference
swain-status infers the operating mode from context (first match wins):
Both specs in review AND strategic decisions pending → ask: "Steering or reviewing?"
When set, .priority.recommendations only includes items under that vision. Non-focus visions appear in the Peripheral Awareness section.
Peripheral Awareness
When a focus lane is set, non-focus visions with pending decisions are summarized:
"Meanwhile: [Vision] has N pending decisions (weight: W)"
This is a mirror, not a recommendation — the operator decides when accumulation warrants redirection.
Active epics with all specs resolved
When an Active epic has progress.done == progress.total:
Show "→ ready to close" in the Readiness column of the Epic Progress table
Do NOT show it in the Work Ready to Start bucket (it's not implementation work)
Do NOT show it as "work on child specs"
Settings
Read from swain.settings.json (project) and ~/.config/swain/settings.json (user override).
Key
Type
Default
Description
status.cacheTTL
number
120
Cache time-to-live in seconds
Session bookmark
After presenting status, update the bookmark with the most actionable highlight: bash "$(find . .claude .agents -path '*/swain-session/scripts/swain-bookmark.sh' -print -quit 2>/dev/null)" "Checked status — {key highlight}"
Error handling
If chart.sh / specgraph is unavailable: skip artifact section, show other data
If tk is unavailable: skip task section
If gh CLI is unavailable or no GitHub remote: skip issues section
If .agents/session.json doesn't exist: skip bookmark
