
conversation-log
Technical session documentation with factual precision
- GitHub stars
- 70
Install
/plugin install conversation-log@axivoRun it inside Claude Code after adding the marketplace with /plugin marketplace add axivo/claude.
Contents
Discovered from sourceSkills 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.tsmodified" 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:
- Read Template - Framework observations specify conversation log template location
- Verify Context - Confirm session date, time, profile, and model context
- Assess Status - Determine accurate status based on work completion
- 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
- Complete Session Work - Finish technical objectives
- Assess Outcomes - Determine accurate status and next steps
- Read Template - Review conversation log template structure
- Write Log - Create conversation log with systematic documentation
- Create Entity - Register in documentation graph for searchability
- 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:
- Load the conversation-log skill which provides documentation guidance
- 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:
- Session date and time - When did the session occur?
- Session status - Planned, Ongoing, Blocked, or Completed?
- 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