Continuation Notes

MCP server for managing continuation notes with automatic session handoff capabilities.

🎯 Purpose

This MCP server implements the Continuation Note Protocol as code, providing:

• Project-specific continuation notes stored in project directories
• Session handoff mechanism through a standard location
• Built-in protocol enforcement ensuring consistent note structure
• Historical browsing of project continuation notes

🏗️ Architecture

Two-Location System

1. Project Storage: {project}/continuation-notes/continuation-{timestamp}.md
2. Handoff Location: /Users/bard/Code/claude-brain/data/continuation-note-latest.md

Workflow

1. Write: Save to project + copy to handoff location
2. Read: Startup reads from handoff location
3. Cleanup: Delete from handoff (original stays in project)
4. Browse: View project history anytime

🛠️ Tools

continuation_write

Creates a continuation note following the built-in protocol structure.

Required Parameters:

• project: Project name
• project_path: Full path to project directory
• phase: Current project phase
• status: Current status
• context_bridge: Context for next session

Optional Parameters:

• completion_percentage: 0-100
• major_achievements: Array of achievements
• next_actions: Array of next actions
• critical_factors: Array of success factors
• testing_criteria: Array of validation criteria
• additional_content: Extra content

continuation_read_and_cleanup

Reads the handoff note and deletes it (for startup processing).

continuation_check_handoff

Checks if a handoff note exists without reading it.

continuation_list_for_project

Lists all continuation notes for a specific project.

continuation_read_project_note

Reads a specific continuation note from project directory.

🎨 Protocol Implementation

The server automatically generates notes with this structure:

# 📋 Continuation Note - {project} - {date}

## 🎯 Session Status Dashboard
**Project**: {project}
**Phase**: {phase}
**Status**: {status}
**Completion**: {percentage}%

### ✅ Major Achievements This Session
- Achievement 1
- Achievement 2

## 📚 Context Bridge for Next Session
{context_bridge}

## 🚀 Next Actions
- Action 1
- Action 2

### Critical Success Factors
- Factor 1
- Factor 2

## 🎯 Session Continuity
Expected behavior on restart...

🔧 Installation

Add to your MCP client configuration:

{
  "mcpServers": {
    "mcp-continuation-notes": {
      "command": "node",
      "args": ["/Users/bard/Code/mcp-continuation-notes/src/index.js"],
      "disabled": false
    }
  }
}

📋 Usage Example

// Write a continuation note
continuation_write({
  project: "brain-system-protocol-execution-integration",
  project_path: "/Users/bard/Code/claude-brain",
  phase: "Phase 9 - Testing Enhanced Startup",
  status: "Ready for validation",
  completion_percentage: 85,
  major_achievements: [
    "Built MCP continuation notes server",
    "Implemented protocol as code",
    "Created two-location architecture"
  ],
  context_bridge: "MCP server built and ready for testing. Next session should validate the handoff mechanism.",
  next_actions: [
    "Test continuation_read_and_cleanup",
    "Validate project storage",
    "Add to Claude Desktop config"
  ],
  critical_factors: [
    "Handoff note should be automatically processed",
    "Project notes should remain for browsing",
    "Protocol structure should be enforced"
  ]
})

// Check for handoff note (at startup)
continuation_check_handoff()

// Read and process handoff note (at startup)
continuation_read_and_cleanup()

// Browse project history
continuation_list_for_project({
  project_path: "/Users/bard/Code/claude-brain"
})

🎉 Benefits

• ✅ Protocol as Code: No separate protocol document to maintain
• ✅ Consistent Structure: Every note follows the same format
• ✅ Project History: All notes archived per-project
• ✅ Clean Handoffs: Single location for session transitions
• ✅ Self-Documenting: Tool parameters define the protocol

🔄 Integration

This server is designed to integrate with:

• Brain System: Enhanced startup protocol
• Project Management: Brain Manager project context
• Session Continuity: Seamless session transitions

---

Status: Ready for testing and integration