sync-architecture

Analyze session history to update architecture documents in monorepos.

41|4|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/etr/groundwork --skill sync-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-architecture
Source: https://github.com/etr/groundwork/tree/main/skills/sync-architecture
Command: npx skills add https://github.com/etr/groundwork --skill sync-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps architecture documentation in sync with actual implementation decisions made during sessions, ensuring the team references up-to-date guidance.

Core Features & Use Cases

  • Analyze session outcomes to identify architectural changes, deviations from the documented architecture, or new tech choices.
  • Propose and apply updates to architecture files to reflect decisions, ensuring alignment across documents.

Quick Start

Run the architecture-sync skill after a session to update the architecture document with implemented changes.

Frequently Asked Questions about sync-architecture

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

FAQPage Schema
How do I keep architecture documentation in sync with code changes after a development session?

To sync architecture documentation with code changes, analyze session history to identify architectural deviations and new tech choices, then update the architecture docs under your specs directory to reflect implemented decisions.

What is the best way to update architecture docs in a monorepo after implementing new components?

Updating architecture docs in a monorepo involves analyzing session outcomes to detect component additions and structural deviations, then applying targeted updates to single-file or directory-based architecture structures to maintain alignment.

How do I detect architectural deviations made during a coding session?

Detect architectural deviations by reading session data to evaluate implemented decisions against existing architecture documents, identifying new technology choices, structural changes, and deviations from the documented architecture.

Can I use session analysis to automate architecture document updates for multi-project setups?

Yes, you can automate architecture document updates in multi-project setups by analyzing session history to determine affected architecture sections and applying changes directly to the architecture structures in the specs directory.

When do I need to run an architecture sync for my software engineering workflow?

You need to run an architecture sync after a development session to ensure architecture documents capture implemented changes, preventing the team from referencing outdated architectural guidance.

Does architecture documentation sync work with both single-file and directory-based structures?

Architecture documentation sync supports both single-file and directory-based architecture structures, reading session data to determine affected sections and updating the files under the specs directory accordingly.