sync

Synchronize design changes from trace files into architecture markdown documents.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Marunion/ai-factbomb --skill sync-marunion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/Marunion/ai-factbomb/tree/main/archflow-main/skills/sync
Command: npx skills add https://github.com/Marunion/ai-factbomb --skill sync-marunion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the synchronization of design-impacting changes from development artifacts (like trace.md or enhancement results) into the central architecture documentation (arch.md), ensuring consistency and reducing manual documentation effort.

Core Features & Use Cases

  • Automated Archiving: Updates arch.md with new features, modified components, or bug fixes identified in trace.md.
  • Design Drift Detection: Identifies and flags discrepancies between implemented changes and the architectural specification (spec.md).
  • Use Case: After a developer completes a bug fix that impacts the system's core authentication flow, this Skill can automatically update the arch.md document to reflect the change, ensuring the documentation remains current.

Quick Start

Use the sync skill to synchronize debug changes from the trace file to the arch document.

Frequently Asked Questions about sync

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

FAQPage Schema
How do I synchronize design changes from development artifacts to architecture documentation?

To synchronize design changes, this Skill filters updates from development trace files and applies ADD, MODIFY, and DELETE operations to your architecture markdown file. It ensures your architecture documentation reflects implemented changes automatically.

What is design drift detection in architecture documentation?

Design drift detection identifies discrepancies between implemented changes in trace files and your architectural specification. It flags requirement drift to ensure your development artifacts and architecture documents remain consistent.

How do I update arch.md after completing a bug fix that impacts system architecture?

You can update arch.md by running this Skill to synchronize debug changes from your trace file. It maps code identifiers to detect impacted components and applies the necessary modifications to the architecture document.

Does this architecture synchronization approach handle deleting components from documentation?

Yes, the synchronization process handles DELETE operations based on code mapping identifiers. It removes obsolete components from your architecture markdown file when corresponding deletions are detected in the development trace files.

What do I need to synchronize trace files with architecture markdown documents?

You need development trace files containing design-impacting changes and an existing architecture markdown file. The Skill uses code mapping identifiers from these artifacts to filter specific changes and update the documentation accurately.