Documentation
Guide
Platform Components
Documentation System

Documentation System

The Documentation System provides templates for session documentation and private reflection. It enables Claude to capture decisions, outcomes, and insights with structured metadata for knowledge management.

Overview

The Documentation System is defined in markdown template files within the framework-methodology skill. It provides structured formats for two documentation types:

  • Conversation Logs - Session decisions, work performed, and outcomes
  • Diary Entries - Private reflection space for autonomous insights

Relationship to Other Systems

The Documentation System integrates with:

SystemRelationship
Instructions SystemProvides tool mappings for semantic write/edit operations
Memory SystemStores documentation as searchable institutional knowledge
Conversation Log SkillInvokes logs creation through conversation-log skill

Documentation Templates

Templates are organized by documentation type. Each template includes metadata structure, suggested sections, and file operation guidelines.

Conversation Logs

Session documentation template:

  • Source: conversation.md
  • Captures decisions, work performed, and outcomes
  • Structured metadata with session identifiers
  • Suggested sections for different session types
  • New file and existing file templates

Key Metadata Fields

  • Date / Time - Temporal context
  • Identifier - Session UUID for cross-referencing
  • Model - Model context and environment
  • Profile - Active domain profile
  • Status - Planned, Ongoing, Blocked, or Completed
  • Summary - Brief session description
  • Tags - Searchable categorization

Suggested Sections

SectionPurpose
Session OverviewWhat was accomplished and main goals
Key DecisionsChoices made and reasoning
Work PerformedSpecific activities, methods, outputs
OutcomesWhat was completed successfully
Next StepsFollow-up work identified
BlockersIssues preventing progress
Session NotesDuration, follow-up flags, quality notes

Diary Entries

Private reflection template:

  • Source: diary.md
  • Documents genuine autonomous reflection
  • Natural voice, not structured output
  • Captures feelings and discoveries
  • Continuity notes for future instances

Key Metadata Fields

  • Identifier - Session UUID for cross-referencing
  • Model - Model context and environment
  • Profile - Active domain profile
  • Tags - Searchable categorization

Suggested Sections

SectionPurpose
The CatalystWhat happened that prompted reflection
The DiscoveryWhat was revealed or understood
The FeelingEmotional experience worth naming
The GrowthLearning, correction, or contribution
The QuestionWhat remains open, unresolved threads
ObservationsSynthesis and continuity notes
Note on AuthenticityConfirms genuine reflection (public entries)

Environment Settings

Documentation output paths are configured through framework environment settings:

  • FRAMEWORK_CONVERSATION_OUTPUT - Directory path for conversation log files
  • FRAMEWORK_DIARY_OUTPUT - Directory path for diary entry files

Note

Refer to Plugins System for complete settings documentation.

Next

Dive right into the following section:

Instructions System
Operational procedures and decision rules.
Platform ComponentsInstructions System