wfc-architecture

Generate C4 architecture diagrams and ARCHITECTURE.md documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sam-fakhreddine/wfc --skill wfc-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wfc-architecture
Source: https://github.com/sam-fakhreddine/wfc/tree/main/wfc/skills/wfc-architecture
Command: npx skills add https://github.com/sam-fakhreddine/wfc --skill wfc-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation and maintenance of architecture documentation, ensuring clarity and consistency across your projects. It bridges the gap between your system's design and its actual implementation.

Core Features & Use Cases

  • Architecture Generation: Creates comprehensive ARCHITECTURE.md files with C4 diagrams (Context, Container, Component) in Mermaid format.
  • ADR Generation: Produces Architecture Decision Records to document key design choices.
  • Architecture Auditing: Verifies code alignment with existing architectural documentation.
  • Use Case: When starting a new project, use this Skill to generate initial architecture diagrams and documentation. For existing systems, use it to audit for architectural drift or to onboard new team members.

Quick Start

Use the wfc-architecture skill to generate architecture documentation for the current project.

Frequently Asked Questions about wfc-architecture

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

FAQPage Schema
How do I generate architecture documentation using the C4 model and Mermaid diagrams?

You can generate architecture documentation by creating a comprehensive ARCHITECTURE.md file with C4 diagrams (Context, Container, Component) in Mermaid format. This provides visual and textual documentation of your system's design for new projects or onboarding.

What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) documents key design choices in your system. You need ADRs when you want to capture the context, decision, and consequences of architectural choices to maintain clarity and consistency across your project.

How do I audit my code against existing architecture documentation?

You audit code against documented architecture by verifying code alignment with existing ARCHITECTURE.md files and C4 diagrams. This checks for architectural drift, ensuring your implementation matches your intended system design.

Can I use architecture diagrams for onboarding new team members to an existing system?

Yes, you can use generated C4 diagrams and ARCHITECTURE.md files for onboarding new team members. These documents bridge the gap between system design and actual implementation, giving new members a clear architectural overview.

What's the best way to document system architecture for a new project?

The best way to document system architecture for a new project is generating initial C4 diagrams (Context, Container, Component) alongside ARCHITECTURE.md. This establishes clear architectural boundaries and design decisions from the start.

Why should I use C4 model diagrams instead of generic architecture diagrams?

You should use C4 model diagrams because they provide structured Context, Container, and Component views that scale from high-level system boundaries to detailed component interactions. This structured approach ensures clarity and consistency in documentation.