PAI 2.3 Migration Guide

Example migration from PAI v1.x to PAI v2.3

Progress Tracker

Phase 1: Prepare

Research upstream changes

mellanon / 2025-12-17-Claude Code Skills Structure and Usage Guide.md

Created January 22, 2026 08:04

Claude Code Skills Structure and Usage Guide - Best practices for skill development, activation patterns, and optimization strategies

generation_date: 2025-12-17 10:44 received_date: 2025-12-17 10:44 updated_date: 2025-12-24 tags:

git/track
scope/work
source/telegram
status/resource
topic/ai/claude

mellanon / 2026-01-22-PAI-Observability-Requirements.md

Created January 22, 2026 08:24

PAI Observability Requirements - Skill logging via PreToolUse hook

PAI Observability Requirements: Summary

This document outlines a three-tier observability system for PAI (Personal AI) agents, emphasising local-first event capture with optional cloud integration.

Core Architecture

The system captures events to JSONL files locally, making them queryable immediately via Unix tools (tail, grep, jq) without requiring infrastructure. Optional components include a collector daemon and observability stack (VictoriaMetrics + Grafana) for historical analysis and alerting.

Key Design Decisions

mellanon / 2026-01-22-PAI-Observability-Requirements.md

Last active January 23, 2026 15:59

PAI Observability Requirements - File-based event capture with optional forwarding to observability stack

generation_date: 2026-01-22 14:45 updated: 2026-01-23 15:00 tags:

type/requirements
para/project
topic/observability
topic/pai
topic/architecture
lifeos/awareness

mellanon / specflow-development-time-analysis.md

Last active February 11, 2026 03:52

SpecFlow Development Time Analysis - Where does development time go?

SpecFlow Development Time Analysis

Signal-Agent Feature Development - Understanding where time is spent

📊 Feature Implementation Status (signal-agent-1 & signal-agent-2)

Feature	Name	Agent-1	Agent-2	Elapsed
F-1	Event Schema and Types	✅	✅	~29m
F-2	Event Logging Library	✅	✅	~28m