skills.rest
novel-jp
novel-jpOFFICIAL
Explore all skills by this author →
GitHub

learn-ce-maintain

Compare small edits with structural revisions to decide between in-place updates and superseding versions.

Updated Mar 12, 2026
Search Tags:#versioning#context-engineering#design-docs#documentation-maintenance#requirements-change#learning-exercise
One-click install
npx skills add https://github.com/novel-jp/projsight-plugin --skill learn-ce-maintain
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: learn-ce-maintain
Source: https://github.com/novel-jp/projsight-plugin/tree/main/skills/learn-ce-maintain
Command: npx skills add https://github.com/novel-jp/projsight-plugin --skill learn-ce-maintain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

このスキルは、要件変更にあわせて既存の設計ドキュメントをどう更新するかを判断し、更新作業まで進める練習を支援します。

Core Features & Use Cases

  • 変更規模に応じて、既存 DD を上書き更新するか新版を作るかを見極めます。
  • 小規模変更と大規模変更を比較し、判断基準に沿って対応方針を整理します。
  • 02-03 で作成した DD を前提に、差分更新と supersedes による履歴管理を体験できます。

Quick Start

このスキルを使って、02-03 で作成した DD を確認し、変更規模に応じた更新判断と実施を進めてください。

Frequently Asked Questions about learn-ce-maintain

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

FAQPage Schema
How to decide between updating an existing design doc in place or creating a new version?▼

Design doc maintenance decisions compare small edits versus structural revisions, evaluating change scale to determine whether an in-place update or a superseding new version is appropriate.

When should I use supersedes-based versioning for design documents?▼

Supersedes-based versioning is used for large-scale requirement changes that require structural revisions, replacing an old design doc with a new version while preserving lifecycle history.

What is the best way to maintain design docs through requirement changes?▼

Scenario-based revision planning retrieves existing design doc content, compares change scales, and applies lifecycle tracking with upsert and supersedes operations to maintain documentation accuracy.

Can I apply in-place updates to a design doc for minor requirement changes?▼

In-place updates apply to small-scale design doc edits, modifying existing content directly without creating a new version, keeping the documentation lifecycle streamlined.

Does design doc maintenance work with existing documentation created from prior exercises?▼

Design doc maintenance operates on existing design docs created in prior learning exercises, retrieving their content to practice revision planning and lifecycle tracking workflows.

Related Skills

Explore More Education & Research Skills→
loianeloiane
50

brownfield-onboarding

Onboard an existing Spring codebase into a spec-driven workflow with baseline and design doc.

Community
Advanced
AshesOfTheUndeadAshesOfTheUndead

Version Management Skill

Enforce directory structures and automated Git versioning for frontend projects.

Community
Advanced
kinetaskinetas

autoReport

Toggle Collector AI's auto report collection state for report.md maintenance.

Community
Basic
burgebjburgebj

octopus-quick

Execute small software changes with atomic commits and state tracking.

Community
Intermediate