pi-operation-logger

Creates and updates a structured operation-log.md to track tasks across code changes, debugging, and migrations.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/1nv1s1b1e/operation-logger-skill --skill pi-operation-logger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pi-operation-logger
Source: https://github.com/1nv1s1b1e/operation-logger-skill/tree/main/.pi/skills/operation-logger
Command: npx skills add https://github.com/1nv1s1b1e/operation-logger-skill --skill pi-operation-logger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Long-running tasks in development projects lose context as conversations drift and tools forget prior steps. This Skill provides a persistent operation log to capture a complete history of actions, decisions, and outcomes.

Core Features & Use Cases

  • Create and maintain operation-log.md in the project root.
  • Record structured entries for PLAN, DECISION, ERROR, FIX, READ, WRITE, and more.
  • Enable cross-session continuity, auditing, and traceability across complex multi-file changes, debugging sessions, and migrations.

Quick Start

Create or resume an operation-log.md in the project root and begin a new logging session to capture all subsequent steps.

Frequently Asked Questions about pi-operation-logger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain context for long-running debugging sessions across multiple files?

You can maintain context for long-running debugging sessions by persisting every meaningful operation in an operation-log.md file. This captures a complete history of actions, decisions, and outcomes to prevent context loss across drifting conversations.

What is the best way to track decisions and errors during complex code migrations?

The best way to track decisions and errors during code migrations is to record structured entries in a persistent log. Capturing PLAN, DECISION, ERROR, and FIX events ensures full traceability and auditability for multi-step migration tasks.

How do I start logging operations for a new development task?

To start logging operations, create or resume an operation-log.md file in your project root and begin a new logging session. This automatically captures all subsequent steps, reads, writes, and outcomes as structured entries.

Can I use a single operation log for cross-session continuity and auditing?

Yes, you can use a single operation log for cross-session continuity and auditing. It persists long-term context by tracking every meaningful operation, enabling you to review past actions and outcomes even after tools forget prior steps.

Does this operation logging approach work without external dependencies?

Yes, this operation logging approach works without external dependencies. It relies solely on creating and updating a markdown file in your project root to maintain long-term context for multi-step tasks.

Why does my multi-step task lose traceability after ending a coding session?

Multi-step tasks lose traceability because tools forget prior steps and conversations drift over time. Persisting every meaningful operation in a structured log prevents this context loss by maintaining a complete history of actions and outcomes.