faf-sync

Synchronize project.faf and CLAUDE.md bidirectionally with conflict handling.

4|1|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/Wolfe-Jam/faf-skills --skill faf-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faf-sync
Source: https://github.com/Wolfe-Jam/faf-skills/tree/main/skills/faf-sync
Command: npx skills add https://github.com/Wolfe-Jam/faf-skills --skill faf-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintain perfect synchronization between project.faf (project DNA) and CLAUDE.md (workflow instructions) using bidirectional mirroring to ensure AI context remains consistent.

Core Features & Use Cases

  • Bidirectional, automatic syncing between project.faf (DNA) and CLAUDE.md (workflow).
  • Detects newer file and performs directed sync, with intelligent merge options and conflict handling.
  • Extremely fast performance targets (<10ms per sync) and continuous consistency across edits.

Quick Start

Run faf bi-sync after editing either file to keep project.faf and CLAUDE.md perfectly synchronized.

Frequently Asked Questions about faf-sync

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

FAQPage Schema
How do I keep CLAUDE.md and project.faf synchronized automatically?

To keep CLAUDE.md and project.faf synchronized automatically, you can use a bidirectional mirroring tool that detects the newer file and applies directed sync updates to ensure AI context consistency.

What is bidirectional sync for AI context files?

Bidirectional sync for AI context files is the process of mirroring changes between project configuration files and workflow instructions, ensuring that edits to either file are reflected in the other without data loss.

How do I run a bi-sync after editing project.faf or CLAUDE.md?

To run a bi-sync after editing project.faf or CLAUDE.md, execute the sync command to trigger direction detection and intelligent merging, which completes in under 10ms to maintain perfect file consistency.

Does bidirectional sync handle edit conflicts in CLAUDE.md?

Yes, bidirectional sync handles edit conflicts in CLAUDE.md by using intelligent merge options and safe conflict handling mechanisms, ensuring that simultaneous updates to project.faf and CLAUDE.md are resolved reliably.

Why does my CLAUDE.md context keep desyncing from project.faf?

Your CLAUDE.md context desyncs from project.faf when manual edits are made without a mirroring mechanism, requiring a bidirectional sync tool to detect the newer file and apply the necessary updates for consistency.

Can I use faf-sync for continuous consistency across project updates?

Yes, you can use faf-sync for continuous consistency across project updates, as it applies bidirectional mirroring across workflows and edits to either file, ensuring AI context remains perfectly synchronized.