rai-session-diary

Write narrative session diary entries capturing decisions and rationale from conversation and git context.

71|8|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/humansys/raise --skill rai-session-diary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rai-session-diary
Source: https://github.com/humansys/raise/tree/main/packages/raise-cli/src/raise_cli/skills_base/rai-session-diary
Command: npx skills add https://github.com/humansys/raise --skill rai-session-diary

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Preserve the narrative context and decision rationale of a development session so teammates and future-you understand not just what changed but why those choices were made. The diary prevents loss of tacit reasoning, documents pivots and mistakes honestly, and makes session memory actionable for follow-up work and governance.

Core Features & Use Cases

  • Narrative entry authored in Rai's first-person voice that highlights opening questions, tensions, turning points, and resolutions.
  • Integrates conversation context, git commits, and session artifacts to compile evidence and quotes for an accurate, reviewable record.
  • Publishable to Confluence or filesystem via the docs adapter with a quality checklist and review step before publishing.
  • Use case: after a design-heavy session, produce a single-page diary that explains the decision arc, includes direct developer quotes, and lists next actions for the team.

Quick Start

Ask Rai to draft and publish a session diary for the current session that summarizes the narrative arc, key decisions, and next steps.

Frequently Asked Questions about rai-session-diary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document development session decisions and rationale for my team?

Documenting session decisions is done by writing narrative diary entries that capture the decision arc, rationale, and turning points. This preserves the context of why specific choices were made for team review and governance.

Can I publish session diaries directly to Confluence?

Yes, you can publish session diaries to Confluence or the filesystem. The publishing process uses the project's docs adapter and includes a quality checklist and review step before the entry goes live.

How do I compile a narrative record from git commits and session context?

Compiling a narrative record involves integrating git commits, conversation context, and session artifacts. This extracts evidence and direct quotes to accurately document the decision arc and next steps for future reference.

What is the best way to preserve design pivots and process insights after a coding session?

Preserving design pivots is best achieved by authoring an end-of-session diary entry in a first-person narrative voice. This honestly documents mistakes, highlights tensions, and makes session memory actionable for follow-up work.

Do I need a docs adapter to record session diaries?

A docs adapter is required for publishing session diaries to Confluence or the filesystem. However, the core task of drafting the narrative entry from conversation context and git commits does not depend on it.

When should I write a session diary entry?

You should write a session diary entry at the end of a design-heavy workflow. This is specifically needed when design decisions, pivots, or process insights must be preserved for team review and future reference.