# Journey

> Create session learning logs that persist institutional memory across Claude Code sessions. Use when this capability is needed.

- Skill: `tomevault-io/journey` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/journey`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/journey/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/journey

---


# Journey Skill

Create or update session learning logs that persist institutional memory across Claude Code sessions.

## When to Use

Use `/journey` when:
- After completing significant work in a session
- After discovering important patterns or learnings
- After making architectural decisions
- After fixing non-trivial bugs
- When the session contains knowledge worth preserving

## Commands

### Create New Journey
```
/journey {title}
```
Creates a new journey file with a summary of the current session.

### List Journeys
```
/journey --list
```
Shows all existing journeys.

### Read Journey
```
/journey --read {filename}
```
Reads a specific journey file.

### Show Recent
```
/journey --recent
```
Shows the 5 most recent journeys.

## Journey File Format

Journeys are saved to `.claude/journeys/` with naming: `YYYY-MM-DD-{slug}.md`

### Template Structure

```markdown
# Journey: {Title}

**Date:** YYYY-MM-DD
**Tags:** #tag1 #tag2 #tag3

## Summary

1-3 sentences describing what was accomplished and why it matters.

## What Was Done

1. **First major item**
   - Details
   - More details

2. **Second major item**
   - Details

## Key Learnings

- **Learning 1**: Explanation with context
- **Learning 2**: Explanation with context

## Files Changed

| File | Change |
|------|--------|
| `path/to/file.ts` | Brief description |

## Patterns Discovered

### Pattern Name
\`\`\`code
// Example code showing the pattern
\`\`\`

## Decisions Made

| Decision | Rationale |
|----------|-----------|
| Choice made | Why it was made |

## Connected To

- Related skills, files, or future work
```

## Writing Guidelines

### Summary
- Be concise but specific
- Mention the "why" not just the "what"
- Future Claude sessions should understand the context

### Key Learnings
- Focus on insights that prevent future mistakes
- Include code patterns when relevant
- Explain the "gotcha" moments

### Tags
Common tags:
- `#bugfix` - Bug fixes
- `#feature` - New features
- `#refactor` - Code restructuring
- `#theming` - Theme-related work
- `#tooling` - Build/dev tooling
- `#performance` - Performance work
- `#meta` - Claude Code/skills work

## Example Usage

After a session fixing theme issues:

```
/journey Dashboard Theming Fixes
```

Claude will create `.claude/journeys/2026-02-02-dashboard-theming-fixes.md` with:
- Summary of what was fixed
- Key learnings about the three-theme system
- Files that were changed
- Patterns discovered (like the 3-way theme check)

## Purpose

Journeys create **institutional memory** that:
1. Helps future sessions avoid repeating mistakes
2. Documents decisions and their rationale
3. Preserves patterns and best practices
4. Tracks the evolution of the codebase

Unlike git commits (which track *what* changed), journeys track *why* and *what was learned*.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nomos-guild) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->