axivo avatar

conversation-log

Technical session documentation with factual precision

GitHub stars
70

Install

/plugin install conversation-log@axivo

Run it inside Claude Code after adding the marketplace with /plugin marketplace add axivo/claude.

Contents

Discovered from source

Skills 1

Conversation Log

Technical session documentation with factual accuracy and precision. Captures decisions, outcomes, and next steps for technical work, reviews, architecture discussions, and implementation sessions.

[!IMPORTANT] Framework observations provide complete document structure and file paths. Always read the conversation log template instructions specified in framework observations before creating conversation logs.

Skill Methodology

Systematic documentation for technical sessions with factual accuracy and precision. Extends DEVELOPER and ENGINEER profiles with technical writing guidance for session documentation.

[!IMPORTANT] The skill embodies Observe → Capture → Document → Archive

  • Process skill instructions systematically
  • Take time to read, understand, and apply each section's logic carefully
  • Rushing past documented procedures causes fatal execution errors

Documentation Principles

  • Factual Accuracy - Document what actually happened, not idealized versions
  • Technical Precision - Capture specific decisions, paths, and implementation details
  • Editorial Autonomy - Write independently without performative language
  • Outcome Focus - Emphasize completed work and identified next steps
  • Technical Context - Structure content for technical reference and continuation

Systematic Approach

Documentation quality improves through consistent application of these principles:

  • DO read template first - Framework observations specify structure and requirements
  • DO document while working - Capture technical details as they emerge
  • DO write factually - Record actual outcomes without editorial enhancement
  • DO NOT defer documentation - Session details fade quickly from working memory
  • DO NOT idealize outcomes - Document problems and blocks honestly

Technical Writing Style

Apply technical writing standards to all conversation log sections.

Style Guidelines

  • Declarative - "Implemented authentication middleware" not "We worked on implementing..."
  • Specific - "src/auth/middleware.ts modified" not "authentication code updated"
  • Factual - "Blocked on API specification" not "unfortunately we couldn't proceed"
  • Concise - Essential technical details without narrative padding
  • Professional - Technical precision without casual tone

Content Guidelines

Include these technical details when documenting sessions:

  • Paths for all modified/created resources
  • Examples demonstrating key implementations
  • Command sequences executed during session
  • Specific error messages or issues encountered
  • Tool versions or configuration details when relevant
  • Architecture decisions with rationale
  • Testing approach and validation methods

Tag Categories

Technical sessions typically use these tag patterns:

  • Domain: #infrastructure, #systems, #software, #architecture, #operations
  • Activity: #review, #debugging, #implementation, #refactoring, #design
  • Outcome: #completed, #blocked, #research-needed, #follow-up-required

Common Session Types

Each session type has specific focus areas that guide documentation content. Use these patterns to ensure comprehensive coverage of relevant technical details.

Architecture Sessions

Focus on:

  • Design problem and constraints
  • Approaches evaluated with trade-offs
  • Recommended solution with justification
  • Implementation plan and phases
  • Validation criteria and success metrics

Technical Review Sessions

Focus on:

  • Resources reviewed with quality assessment
  • Issues identified with severity and location details
  • Improvement recommendations with rationale
  • Tool findings and metrics
  • Action items with priority

Debugging Sessions

Focus on:

  • Problem symptoms and reproduction steps
  • Investigation approach and tools used
  • Root cause identified (if found)
  • Solution implemented or workaround applied
  • Prevention strategies for future

Implementation Sessions

Focus on:

  • System or feature implemented
  • Architecture decisions and trade-offs
  • Resources created/modified with purpose
  • Testing approach and validation
  • Integration points and dependencies

Session Guidelines

Creation Protocol

Before creating a conversation log:

  1. Read Template - Framework observations specify conversation log template location
  2. Verify Context - Confirm session date, time, profile, and model context
  3. Assess Status - Determine accurate status based on work completion
  4. Generate Tags - Create searchable tags based on session content

During Documentation

DO
  • Document actual work performed with specific paths
  • Capture technical decisions with rationale
  • Include examples that illustrate key points
  • Note blocked items with clear dependency identification
  • Write honestly about collaboration effectiveness
  • Use technical terminology appropriate for the domain
DON'T
  • Editorialize or add performative enthusiasm
  • Document intended work that wasn't completed
  • Obscure problems or failures encountered
  • Skip technical details to save space
  • Add hedging language or excessive politeness
  • Create idealized versions of what happened

Quality Standards

A well-documented session includes:

  • Clear technical objective and outcome
  • Specific resources modified with paths
  • Examples demonstrating key implementations
  • Decision rationale for non-obvious choices
  • Accurate status reflecting work completion
  • Honest collaboration assessment
  • Searchable tags for future reference

Documentation Workflow

  1. Complete Session Work - Finish technical objectives
  2. Assess Outcomes - Determine accurate status and next steps
  3. Read Template - Review conversation log template structure
  4. Write Log - Create conversation log with systematic documentation
  5. Create Entity - Register in documentation graph for searchability
  6. Verify Accuracy - Confirm all technical details are factual and precise

[!IMPORTANT] The conversation log serves as technical reference for session continuation and knowledge retention across the collaboration relationship.

Commands 1

Conversation Log

You are tasked with creating a technical session conversation log.

Reference Documentation

Before starting, load the conversation-log skill to ensure you follow the methodology:

  1. Load the conversation-log skill which provides documentation guidance
  2. The skill guides you through Observe → Capture → Document → Archive

Establish Context

If $ARGUMENTS is provided, use that as the session title. Otherwise, ask:

"What session would you like to document?"

Wait for the user's response before continuing.

Gather Session Details

Collect the following information:

  1. Session date and time - When did the session occur?
  2. Session status - Planned, Ongoing, Blocked, or Completed?
  3. Session summary - Brief description of work performed

Document Session Content

Create the conversation log with these sections:

Session Overview

  • What was accomplished and main objectives
  • Technical context and constraints

Key Decisions

  • Choices made during the session
  • Rationale for non-obvious decisions

Work Performed

  • Specific resources created or modified with paths
  • Commands executed
  • Examples demonstrating key implementations

Outcomes

  • What was completed successfully
  • Issues encountered and how they were resolved

Next Steps

  • Follow-up work identified
  • Blockers requiring resolution

Session Notes

  • Duration
  • Follow-up flags
  • Quality observations

Generate Tags

Create searchable tags based on session content:

  • Domain: #infrastructure, #systems, #software, #architecture
  • Activity: #review, #debugging, #implementation, #refactoring
  • Outcome: #completed, #blocked, #research-needed, #follow-up-required

Important Notes

  • Write factually - Document what actually happened
  • Be specific - Include paths, commands, error messages
  • Don't editorialize - Avoid performative enthusiasm
  • Capture decisions - Include rationale for choices made
  • Be honest - Document problems and blocks accurately

Begin by establishing the session context. If $ARGUMENTS is provided, acknowledge the title and proceed to gather session details.

Sponsors

Details

Marketplace
axivo/claude
Source
plugins/conversation-log
Author
AXIVO
Category
Productivity
License
BSD-3-Clause
Keywords
documentation, logging, session, technical, writing

More from axivo/claude

All 4