Session Information Provider

Skill Metadata

Field	Value
Version	1.0.0
Tier	Alfred (Session Management)
Auto-load	On session start or when status requested
Purpose	Provide comprehensive project and session overview

What It Does

Comprehensive session and project information provider that gives users complete context about their current MoAI-ADK project state, including Git status, SPEC progress, version information, and system resources.

Core capabilities:

✅ Project metadata and configuration display
✅ Git repository status and commit history
✅ SPEC progress tracking and completion metrics
✅ Version information and update availability
✅ System resource monitoring
✅ Checkpoint status and restoration options
✅ Session metrics and handoff information

When to Use

✅ When starting a new Claude Code session
✅ When checking project status and progress
✅ Before making significant changes or commits
✅ When users ask "what's the status", "show project info", "where are we"
✅ When reviewing project context and history
✅ Before running /alfred commands

Core Information Categories

1. Project Overview

🗿 Project: MoAI-ADK
📁 Location: /Users/goos/MoAI/MoAI-ADK
🌍 Language: 한국어 (Korean)
🔧 Mode: Team (GitFlow)
⚡ Toolchain: Python optimized

2. Version Information

📦 Current: v0.15.2
🆓 Update Available: v0.16.0
⬆️  Upgrade Command: pip install --upgrade moai-adk
📝 Release Notes: https://github.com/moai-adk/moai-adk/releases/tag/v0.16.0

3. Git Repository Status

🌿 Branch: develop (3 commits ahead of main)
📝 Changes: 5 modified, 2 added
🔨 Last Commit: feat: Complete skill consolidation (2 hours ago)
📊 Commit Hash: a1b2c3d

4. SPEC Progress

📋 Total SPECs: 15
✅ Completed: 12 (80%)
⏳ In Progress: 2
📝 Pending: 1
📊 Completion Rate: 80%

5. System Resources

🧠 Memory Usage: 2.4GB / 16GB (15%)
💾 Disk Space: 45GB free
🔄 CPU Usage: 12%
⚡ Session Duration: 45 minutes

6. Available Checkpoints

🗂️  Checkpoints: 3 available
   📌 auth-system-implementation (30 min ago)
   📌 skill-consolidation (2 hours ago)
   📌 feature-branch-workflow (yesterday)
↩️  Restore: /alfred:0-project restore

Quick Start Commands

Basic Status Check

# Simple project overview
Skill("moai-session-info")

Detailed Status with Metrics

# Comprehensive status with all details
Skill("moai-session-info")
# Response includes all categories above

Before Major Operations

# Always check status before:
# - /alfred:1-plan (planning new features)
# - /alfred:2-run (implementing changes)
# - git operations (commits, merges)

Skill("moai-session-info")
# Review status, then proceed with operation

Information Sources

The skill gathers information from multiple sources:

Project Configuration

.moai/config.json - Project settings and language
pyproject.toml - Package version and dependencies
.git/ - Repository status and history

SPEC Tracking

.moai/specs/ - SPEC documents and completion status
SPEC metadata - Progress tracking and milestones

System Resources

psutil - Memory and CPU usage
File system - Disk space and project size
Session metrics - Current session duration

Version Information

Package registries - Latest available versions
GitHub releases - Release notes and changelogs

Status Message Format

The skill generates structured status messages with consistent formatting:

🚀 MoAI-ADK Project Status

📋 Project Overview
   🗿 Project: {project_name}
   📁 Location: {project_path}
   🌍 Language: {language}
   🔧 Mode: {git_mode}

📦 Version Information
   📦 Current: {current_version}
   {update_information}
   📝 Release Notes: {release_url}

🌿 Git Repository
   🌿 Branch: {branch} ({commit_hash})
   📝 Changes: {file_changes}
   🔨 Last: {last_commit_message}

📊 SPEC Progress
   📋 Total: {total_specs}
   ✅ Completed: {completed_specs} ({percentage}%)
   ⏳ In Progress: {in_progress_specs}

🧠 System Resources
   🧠 Memory: {memory_usage}
   💾 Disk: {disk_space}
   ⚡ Session: {session_duration}

🗂️  Checkpoints
   {checkpoint_list}
   ↩️  Restore: /alfred:0-project restore

Integration with Alfred Commands

This skill is automatically invoked by:

SessionStart Hook Integration

# In session_start__show_project_info.py
# Automatically called when session starts
Skill("moai-session-info")

Command Integration

# Before /alfred:1-plan
if context == "planning":
    Skill("moai-session-info")  # Show current status

# Before /alfred:2-run
if context == "implementation":
    Skill("moai-session-info")  # Confirm project state

# Before git operations
if "git" in command:
    Skill("moai-session-info")  # Show repository status

Error Handling and Fallbacks

Graceful Degradation

The skill provides useful information even when some sources fail:

# If Git commands fail:
# Still show project info, version, and system resources

# If SPEC counting fails:
# Still show Git status and version information

# If network access fails:
# Still show local information (Git, SPECs, system)

Common Error Scenarios

Git repository not found: Shows project info without Git details
No .moai/config.json: Uses default settings and basic project detection
Network unavailable: Shows local information only
Permission denied: Provides read-only information where possible

Performance Considerations

Optimization Strategies

Caching: Cache expensive operations (Git history, version checks)
Timeouts: 5-second timeout for network operations
Lazy Loading: Load detailed information only when requested
Incremental Updates: Update only changed information

Resource Usage

Memory: Minimal footprint (< 10MB)
Network: Only for version checks (cached locally)
Disk: Reads existing files, no modifications
CPU: Lightweight operations, quick response times

Usage Examples

Example 1: Session Start

# User starts new Claude Code session
Skill("moai-session-info")

# Output:
🚀 MoAI-ADK Session Started

📋 Project Overview
   🗿 Project: MoAI-ADK
   📁 Location: /Users/goos/MoAI/MoAI-ADK
   🌍 Language: 한국어
   🔧 Mode: Team

📦 Version: v0.15.2 → v0.16.0 available
📝 Release Notes: https://github.com/...

🌿 Branch: develop (3 ahead)
📝 Changes: 5 modified, 2 added
📋 SPEC Progress: 12/15 (80%)

Example 2: Pre-Implementation Check

# User wants to implement new feature
"/alfred:2-run SPEC-AUTH-001"

# Alfred automatically calls:
Skill("moai-session-info")

# User sees status before implementation begins

Example 3: Status Query

# User asks: "what's our current status?"
Skill("moai-session-info")

# Complete project status displayed

End of Skill | Optimized for quick status checks and session context