How does this help with AI-assisted coding?

By maintaining structured logs, Claude has a clearer understanding of the project's history and current state, leading to better-informed suggestions and fewer repeated mistakes.

Can I record the rationale behind a technical choice?

Yes, the 'decision' log type specifically prompts for context, rationale, tradeoffs, and impact to ensure technical debt is minimized.

What types of logs can I create?

You can record four distinct types of entries: decisions, progress updates, surprises (unexpected behaviors), and deviations from the original plan.

How does the skill know where to log information?

It scans the design-docs/plans/ directory to identify active plans and writes entries to the corresponding markdown files based on the project scope.

Structured Workflow Logging

Name: Structured Workflow Logging
Author: JSai23

byJSai23

•

생산성 및 워크플로

Maintains a structured record of project decisions, progress, surprises, and deviations within design documentation.

This skill automates the process of keeping project documentation up-to-date by providing a structured framework for logging real-time developments during the software lifecycle. It allows developers and AI agents to record crucial context—including rationales for technical decisions, unexpected discoveries, and shifts in project scope—directly into active plan documents. By standardizing how progress and surprises are captured, it ensures long-term maintainability and provides a clear audit trail for complex coding workflows, preventing the loss of critical 'why' information during development.

주요 기능

01Automatic detection and updating of active design-docs and plan files

02Timestamped progress updates for active development plans

03Standardized deviation reporting for plan adjustments and scope changes

04Detailed surprise recording to capture unexpected technical discoveries

05Automated decision logging with rationale and tradeoff tracking

061 GitHub stars

사용 사례

01Tracking unexpected API behavior discovered during the integration phase

02Maintaining a historical record of plan changes to keep team members and AI context aligned

03Documenting why a specific library was chosen over an alternative during a refactor

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jsai23/claude-tooling logging-a

For use in Claude.ai and ChatGPT

Download Skill