What is the 'litmus test' used by this skill?

The litmus test asks 'Do we have a choice?' If there is no choice due to external constraints, it's a requirement. If a choice was made among alternatives, it belongs in design or decisions.

How does it handle conflicting feedback in PR threads?

The skill performs a mandatory scan of all threads first to identify final positions and themes, ensuring that later conclusions which supersede earlier ones are the only ones applied.

How does it distinguish between requirements and design?

It uses signal words and behavioral patterns: requirements focus on user-facing outcomes and constraints, while design focuses on component names, mechanisms, and implementation specifics.

Does it automatically update files not in my current PR?

No, it includes a guardrail that identifies when a change belongs in an out-of-scope document and asks for user confirmation before applying updates to those files.

Document Update Discipline

Name: Document Update Discipline
Author: flox

byflox

•

コンテンツ管理

Maintains architectural integrity by routing technical updates and PR feedback to the correct documentation abstraction level.

Document Update Discipline is a specialized capability for Claude Code designed to maintain high-quality technical documentation within the Forge framework. It provides a structured methodology for processing PR feedback, meeting notes, and design discussions, ensuring that requirements stay focused on outcomes while design documents capture implementation mechanisms. By applying a rigorous litmus test to determine the correct location for every change, it prevents documentation rot and ensures architectural decisions (ADRs) are properly recorded and cross-referenced across your repository.

主な機能

01Enforcement of Architectural Decision Records (ADRs) for significant changes

02Structured synthesis of multi-thread PR discussions and meeting transcripts

03Automated abstraction level classification between requirements and design

04Guided guardrails for updating out-of-scope files during reviews

051 GitHub stars

06Cross-document consistency checks to prevent implementation leakage

ユースケース

01Managing technical decision reversals and updating all dependent documentation

02Extracting actionable architectural conclusions from messy meeting transcripts

03Applying complex PR feedback that spans requirements, design, and implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flox/forge-plugin document-update-discipline

For use in Claude.ai and ChatGPT

主な機能

01Enforcement of Architectural Decision Records (ADRs) for significant changes

02Structured synthesis of multi-thread PR discussions and meeting transcripts

03Automated abstraction level classification between requirements and design

04Guided guardrails for updating out-of-scope files during reviews

051 GitHub stars

06Cross-document consistency checks to prevent implementation leakage

ユースケース

01Managing technical decision reversals and updating all dependent documentation

02Extracting actionable architectural conclusions from messy meeting transcripts

03Applying complex PR feedback that spans requirements, design, and implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flox/forge-plugin document-update-discipline

For use in Claude.ai and ChatGPT