What is requirement drift in the context of this skill?

Requirement drift occurs when implementation changes contradict the original project specifications defined in spec.md. This skill detects these discrepancies during synchronization and prompts the user to either update the spec or flag the divergence.

How does the skill identify which rows in the documentation to update?

It uses a unique '#' mapping ID column that persists across trace.md and arch.md documents, ensuring precise tracking and modification of features, classes, and methods without renumbering errors.

Does this skill support version control?

Absolutely. It includes a specific workflow step to perform a Git commit of your documentation files before any modifications are applied, ensuring you can always roll back if needed.

Can I preview changes before the documentation is modified?

Yes, the skill provides a Sync Target Analysis report in Phase 1, detailing exactly which rows will be added, modified, or deleted, along with their associated drift risk levels.

ArchFlow Architect Sync

Name: ArchFlow Architect Sync
Author: samdae

bysamdae

0•

학습 및 문서화

Synchronizes design-impacting code changes from debug traces and feature enhancements to architectural documentation.

ArchFlow Architect Sync is a specialized tool for document-driven development that ensures your project's architectural documentation stays perfectly aligned with the actual codebase. It intelligently filters design-impacting changes from debug logs and enhancement results, identifies requirement drift by comparing changes against original specifications, and automates the update of arch.md files while maintaining unique mapping IDs. This skill is essential for teams practicing rigorous documentation-first workflows, preventing the common problem of architectural rot as a project evolves through rapid iterations.

주요 기능

010 GitHub stars

02Automated Git commit integration for document version control and backups

03Conflict resolution workflows for handling overlapping architectural changes

04Maintains unique code mapping identifiers for consistent feature traceability

05Smart 3-way synchronization between trace, spec, and arch documents

06Automated detection of 'Requirement Drift' when implementation deviates from original specs

사용 사례

01Auditing codebase changes against business requirements to ensure compliance and documentation accuracy

02Integrating new feature designs from enhancement phases into existing system documentation

03Updating technical architecture after a complex bug fix that altered system design

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add samdae/archflow sync

For use in Claude.ai and ChatGPT

Download Skill