drafting-system-context

Draft and audit system-context.md with Mermaid C4 diagrams against the Design Brief.

Updated Aug 18, 2025
One-click install
npx skills add https://github.com/masa-codehub/gemini_agent --skill drafting-system-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drafting-system-context
Source: https://github.com/masa-codehub/gemini_agent/tree/main/.gemini/skills/drafting-system-context
Command: npx skills add https://github.com/masa-codehub/gemini_agent --skill drafting-system-context

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Drafts and audits the system-context.md according to the Design Brief to ensure a precise SSOT and reliable project guidance.

Core Features & Use Cases

  • Drafts the system-context.md based on the Design Brief, producing clear text and a faithful system-context diagram.
  • Generates a Mermaid C4 Context Diagram that aligns with the written content.
  • Performs a strict self-audit using the drafting checklist to identify and resolve inconsistencies.

Quick Start

Run the drafting workflow to generate the system-context draft and perform the self-audit.

Frequently Asked Questions about drafting-system-context

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

FAQPage Schema
How do I draft a system context document from a design brief?

To draft a system context document from a design brief, generate clear text content and a faithful system-context diagram that aligns with the brief to ensure a precise single source of truth for project guidance.

How do I generate a Mermaid C4 context diagram for system documentation?

Generate a Mermaid C4 context diagram by mapping the written system context content directly into the diagram structure, ensuring the visual representation faithfully aligns with the text documentation for accurate system visualization.

What is a system context audit checklist used for in design projects?

A system context audit checklist is used to perform a strict self-audit of the drafted system-context document, identifying and resolving inconsistencies between the text, Mermaid diagrams, and the original design brief.

Can I ensure my system context acts as a single source of truth using a self-audit trail?

Yes, you can ensure your system context acts as an accurate single source of truth by applying a self-audit trail that cross-references the generated draft against the design brief to detect and resolve structural inconsistencies.

Do I need a design brief to start drafting system context documentation?

Yes, a design brief is required to start drafting system context documentation, serving as the foundational input to generate the draft text, Mermaid C4 diagrams, and the subsequent self-audit verification trail.

What is the best way to audit system context diagrams against written documentation?

The best way to audit system context diagrams against written documentation is to run a drafting workflow that applies a strict checklist, verifying strict alignment between the Mermaid C4 diagram and the system-context text.