# MCP 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:

```markdown
# 📋 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:

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

## 📋 Usage Example

```javascript
// 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