Prompt file imported from PauloHYBEX/Nexus-TCMS (
.windsurf/workflows/session-report.md). Copyright stays with the author.
Session Report
Generate a post-session summary capturing work performed, outcomes achieved, and git activity. Writes a report to .planning/reports/ for human review and stakeholder sharing.
Usage: session-report
Step 1: Gather Session Data
Collect data from available sources:
1a. Git Activity
git log --oneline --since="24 hours ago" --no-merges 2>/dev/null || echo "No recent commits"
git diff --stat HEAD~10 HEAD 2>/dev/null | tail -1 || echo "No diff available"
git log --format="%ai" --since="24 hours ago" 2>/dev/null | head -1
git log --format="%ai" --since="24 hours ago" 2>/dev/null | tail -1
1b. Planning State
Read .planning/STATE.md to get:
- Current milestone and phase
- Progress percentage
- Active blockers
- Recent decisions
Read .planning/ROADMAP.md to get milestone name and phase goals.
1c. Phase Artifacts
find .planning/phases -name "*-SUMMARY.md" -newer .planning/STATE.md 2>/dev/null
find .planning/phases -name "*-UAT.md" -newer .planning/STATE.md 2>/dev/null
find .planning/phases -name "*-VERIFICATION.md" -newer .planning/STATE.md 2>/dev/null
1d. Previous Reports
ls -la .planning/reports/SESSION_REPORT*.md 2>/dev/null || echo "No previous reports"
Step 2: Generate Report
node -e "require('fs').mkdirSync('.planning/reports',{recursive:true})"
Write .planning/reports/SESSION-[YYYYMMDD].md:
# Session Report
**Generated:** [timestamp]
**Project:** [from PROJECT.md title or directory name]
**Milestone:** [N] — [milestone name]
---
## Session Summary
**Duration:** [estimated from first to last commit timestamp, or "Single session"]
**Phase Progress:** [from STATE.md]
**Plans Executed:** [count of summaries written this session]
**Commits Made:** [count from git log]
## Work Performed
| Phase | Plans | Status | Key Deliverables |
|-------|-------|--------|-----------------|
| [N] | [IDs] | [complete/partial] | [what was built] |
## Decisions Made
[Decisions captured during this session, from STATE.md or DECISIONS.md changes]
## Issues Encountered
[Any blockers, bugs, or deviations noted in SUMMARYs]
## Files Changed
[Top 10 most-changed files from git diff --stat]
---
## Next Steps
[What STATE.md says is next]
---
*Generated by learnship session-report*
Step 3: Commit and Present
git add .planning/reports/
git commit -m "docs: session report [date]"
learnship > SESSION REPORT COMPLETE
Report: .planning/reports/SESSION-[date].md
Duration: [estimate]
Commits: [N]
Plans completed: [M]
Share this report with stakeholders or use it for team standups.
Learning Checkpoint
Read learning_mode from .planning/config.json.
If auto:
Learning moment: End of session is a natural reflection point:
@agentic-learning reflect— What was the most valuable thing accomplished this session? What would you do differently? Structured reflection at session boundaries builds compounding insight.
If manual: Add quietly: "Tip: @agentic-learning reflect to consolidate lessons from this session."