devlog-maintainer

Propagate change outcomes into devlog current state, ADR records, and archival snapshots.

Updated May 10, 2026
One-click install
npx skills add https://github.com/JerryLinyx/muce --skill devlog-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devlog-maintainer
Source: https://github.com/JerryLinyx/muce/tree/main/.claude/skills/devlog-maintainer
Command: npx skills add https://github.com/JerryLinyx/muce --skill devlog-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents devlog drift by ensuring every real change in code and decisions is reflected in the correct layer of the project’s docs, without rewriting everything on each update.

Core Features & Use Cases

  • Structured devlog propagation: Updates the right parts of docs/devlog/current/, docs/devlog/records/, docs/devlog/appendix/, and docs/devlog/archive/ based on the change trigger (bug fix, feature delivery, review/validation, or version closeout).
  • ADR traceability with validation: Adds or updates records/ entries with required ADR frontmatter and then synchronizes backlog/capability/PRD/overview truths only where they actually changed.
  • Topology-aware and repo-agnostic operation: Works across repositories that follow the conventional docs/devlog/ topology, while explicitly asking before bootstrapping if that topology is missing.

Quick Start

Use the devlog-maintainer skill to update your docs/devlog/current cycle state and add the appropriate ADR record after the latest bug fix or feature delivery.

Frequently Asked Questions about devlog-maintainer

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

FAQPage Schema
How do I maintain an accurate architecture decision log and devlog across releases?

To maintain an accurate devlog, you propagate code changes into current state files and ADR records using a trigger-based matrix. This ensures your architecture decisions and release documentation stay synchronized without rewriting the entire history.

What is the best way to update ADR records after a bug fix or feature delivery?

The best way to update ADR records after a bug fix is to apply a trigger-based propagation matrix that adds required frontmatter to your records directory. This synchronizes only the backlog and capability documents that actually changed during the fix.

Can I use devlog propagation tools in repositories that lack a standard docs topology?

You can use devlog propagation in repositories lacking a standard topology, but the system will explicitly ask before bootstrapping the missing docs/devlog directory structure. It operates topology-aware to ensure changes map to the correct archival layers.

How do I enforce required ADR frontmatter fields during documentation maintenance?

To enforce required ADR frontmatter fields during documentation maintenance, the system validates records entries against predefined schema requirements before synchronizing the current cycle state. This prevents incomplete architecture decisions from entering the devlog.

Why does my devlog drift out of sync with the actual project state?

Your devlog drifts out of sync because real code changes are not automatically reflected in the correct documentation layers. Applying a structured propagation process updates current state, ADR records, and archival snapshots only where changes occurred.

When should I run an index refresh or checklist verification for my devlog?

You should run an index refresh or checklist verification for your devlog during version closeouts or reviews when supporting scripts are present. This validates that your structured project governance documentation accurately reflects the propagated change outcomes.