docs-maintenance

Automate documentation updates, syncs, and archival workflows across plans and roadmaps.

Updated Dec 10, 2025
One-click install
npx skills add https://github.com/novelsaga/NSaga --skill docs-maintenance-novelsaga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-maintenance
Source: https://github.com/novelsaga/NSaga/tree/main/.opencode/skills/docs-maintenance
Command: npx skills add https://github.com/novelsaga/NSaga --skill docs-maintenance-novelsaga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation teams often face inconsistent updates across modules, unclear triggers for syncing documentation, and scattered archive processes. This guide standardizes when to update docs, how to write consistently, and how to archive completed plans.

Core Features & Use Cases

  • Update Trigger Matrix to map code changes to specific docs.
  • Sync Procedures after completing a task with /sync-docs to ensure docs reflect source changes.
  • Notepad and Archive workflows: append to notepads under .sisyphus/notepads and move finished plans to .sisyphus/plans/archive/.
  • Documentation Hierarchy and Templates: maintain AGENTS.md references and roadmaps for stable patterns and future work.

Quick Start

Execute the /sync-docs command after finishing a task to trigger documentation updates.

Frequently Asked Questions about docs-maintenance

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

FAQPage Schema
How do I automate documentation maintenance after finishing a coding task?

To automate documentation maintenance, execute the /sync-docs command after finishing a task to trigger updates across AGENTS.md, roadmaps, and notepads. This sync procedure ensures your documentation reflects source changes consistently without manual intervention.

What is the best way to archive completed plans and roadmaps?

The best way to archive completed plans is to move finished files to the .sisyphus/plans/archive/ directory. This archival workflow keeps active plan folders clean while maintaining traceability of past work and completed roadmaps.

How do you map code changes to trigger the right documentation updates?

You map code changes to documentation updates using an Update Trigger Matrix. This matrix standardizes the governance process by specifying exactly which docs require updates when specific code modifications occur across your project.

Do I need AGENTS.md to maintain documentation hierarchy and templates?

You need AGENTS.md references to maintain a proper documentation hierarchy. The governance process uses AGENTS.md alongside provided templates to enforce consistent content formats, stable patterns, and standardized references across all project documentation.

When should I append notes to .sisyphus/notepads during the development workflow?

You should append notes to .sisyphus/notepads during active development to capture ongoing work context. This notepad usage workflow ensures scattered traceability details are recorded before the final plan archiving process begins.

Why does documentation become inconsistent across modules without governance?

Documentation becomes inconsistent across modules without governance due to unclear triggers for syncing and scattered archive processes. Standardizing update triggers and sync procedures ensures modules follow the same formatting rules and quality checklists.