VividKit Crystal clear AI coding
VI
Choose Your Setup Get Started with AgentKit Continue with ClaudeKit Migrate from ClaudeKit to AgentKit Clean cutover from ClaudeKit What Is AgentKit? How AgentKit Works AgentKit Kits, Skills, Agents & Hooks AgentKit Runtime Support AgentKit Desktop App AgentKit Configuration AgentKit CLI Quick Reference AgentKit Skills Cheatsheet AgentKit Workflows AgentKit Statusline Update AgentKit CLI & Kits AgentKit Helper Clean reinstall of AgentKit AgentKit Troubleshooting What is ClaudeKit? ClaudeKit CLI Guide Command Finder Commands Cheat Sheet Workflow Recipes CLI Quick Reference Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Other coding tools How ClaudeKit Works Inside ClaudeKit Finding Your Unknowns Session Recovery Fix from Logs UI/UX Guide Accounts Switcher IDE Config Remote Control Codex App System Diagramming UI Review Gate Promotions Support VividKit

Quick Ref / Command

Marketing Kit

/ak:journal

Technical Session Journal

Persist chronological technical journals under plans/journals using the first-class CLI, preserving work history without replacing current docs, ADRs, or product decision sources.

01

Gather events

02

Draft concise entry

03

Persist with CLI

04

Validate when needed

Rule 01

Prefer concrete errors, paths, outcomes, and decisions over vague retrospectives.

Rule 02

Persist through ak journal create; do not leave the journal only in chat.

Rule 03

Automatic journal steps are controlled by explicit flags and config precedence.

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Gather events Collect root cause, key changes, impacts, decisions, next steps, concrete errors, paths, and outcomes from the session.
  2. 2 Draft concise entry Write a short title and markdown body with concrete evidence instead of vague summaries.
02

Work

Agent / skill execution

  1. 3 Persist with CLI Use ak journal create with title, summary, and stdin so no interactive editor is required.
  2. 4 Validate when needed Run ak journal validate <slug-or-filename-stem> for entries that need checking.
03

Verify

Gate, review, validation

  1. 5 Skip AgentWiki publish Report “AgentWiki publish skipped” because publishing from this skill is deferred and the local file remains source of truth.
  2. 6 Browse history Use ak journal list, ak journal show <slug>, or the Journals page to inspect existing entries.
04

Close

Report, handoff, artifact

  1. 7 Respect auto policy When run automatically after other workflows, honor --skip-journal, journal.auto config, and precedence: flag > project config > user config > default true.
  2. 8 Publish socially only when configured For social posts, resolve config, draft per-channel bodies, dry-run post-social first, then publish only after inspecting dry-run output.

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

Session reflection Recommended 
/ak:journal after fixing the OAuth callback race condition
Use when:
You want to preserve a concise technical record after implementation or debugging.
Expected:
Captures what happened, decisions, next steps, persists under plans/journals, and notes AgentWiki publish skipped.
Failure archaeology 
/ak:journal why the deployment rollback was necessary
Use when:
The entry should explain root cause, impact, and lessons for future sessions.
Expected:
May invoke journal-writer for honesty, but still persists through ak journal create.
Campaign-audit journal 
/ak:journal capture this campaign-audit session
Use when:
A working session should leave a dated technical journal, not a status slide.
Expected:
Writes a dated journal entry with changes, decisions, concrete paths, and next steps under plans/journals.

Handled Scope

  • Session reflection
  • Chronological work records
  • Journal CLI persistence
  • Auto-journal preferences
  • Social-publishing dry runs

Artifacts Produced

Journal result

Pattern

Created file path, one-line summary, validation status when run, AgentWiki publish skipped.

The journal preserves work history; it should not be cited as the durable product spec.

Next