docs-evolve

Update SYSTEM.md, ADRs, and BACKLOG.md from Git diffs and completed code.

3|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/peel/fiddle --skill docs-evolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-evolve
Source: https://github.com/peel/fiddle/tree/main/skills/docs-evolve
Command: npx skills add https://github.com/peel/fiddle --skill docs-evolve

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the tedious and often neglected task of updating project documentation after code changes, ensuring that documentation remains accurate and reflects the current state of the system.

Core Features & Use Cases

  • Automated Documentation Updates: Automatically updates SYSTEM.md, creates Architecture Decision Records (ADRs), and appends to BACKLOG.md based on completed code.
  • Contextual Analysis: Analyzes completed "beans" (code units) and recent Git diffs to identify architectural changes, significant decisions, and discovered issues or ideas.
  • Use Case: After completing a new feature that involved significant architectural refactoring, run this skill to automatically update the SYSTEM.md with the new component details, create an ADR for the refactoring decision, and log any tech debt found during implementation to the backlog.

Quick Start

Run the docs-evolve skill to update documentation for the latest completed epic.

Frequently Asked Questions about docs-evolve

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

FAQPage Schema
How do I keep documentation in sync with code changes after a feature release?

To keep documentation in sync with code, you can run this skill to analyze recent Git diffs and completed code artifacts, then automatically update files like SYSTEM.md and append to BACKLOG.md.

How do I automatically generate Architecture Decision Records from Git history?

You can generate Architecture Decision Records (ADRs) automatically by analyzing completed code units and recent Git diffs to identify significant decisions, then creating ADR files reflecting those architectural choices.

When should I update system documentation after architectural refactoring?

You should update system documentation after completing significant architectural refactoring to ensure files like SYSTEM.md accurately reflect new component details and current system state.

Can I track discovered tech debt and issues in the backlog from recent commits?

Yes, you can track discovered tech debt by analyzing completed code artifacts and Git diffs for implementation issues, which are then logged as new entries appended to BACKLOG.md.

What's the best way to maintain technical documentation accuracy post-development?

The best way to maintain technical documentation accuracy is to analyze completed code artifacts and recent Git diffs post-development, proposing and writing targeted changes to documentation files.

Does docs-evolve require completed code beans and Git history to update documentation?

Yes, docs-evolve requires context from completed code beans and Git history to accurately analyze architectural changes, significant decisions, and discovered issues for documentation updates.