Skip to content

Design documents

v0.1.0

Client-facing design documents in Word (architecture, network security, assessments) on the client's own template, checked so they read as written by a consultant.

Paste it into Claude Code, Cursor or Codex.

Install in your project
npx skills add keenskills/skills --skill writing-design-documents

Write, check, fix

The skill’s own loop on the Contoso example (a fictional company): a first draft, the real check’s findings, the fixes, and the final document.

The draft was made by putting back five habits of generated text; its findings, the fixes and both documents are real output.

Network Security Design · first draft

Purpose

This document describes the proposed network security design for the Contoso pre-production web applications — the current configuration as of 24-Sep-2026, the target design and the changes needed to implement it.

Scope

In scope

  • The three web applications and their private endpoints.
  • Network security groups and application security groups in the spoke VNet.

Out of scope

  • Hub network resources, which are managed by the hub team.

Current State

This section summarises the configuration of the pre-production subscription, captured with read-only Azure CLI commands.

ResourcePublic accessPrivate endpoint
app-contoso-portal, Web appDisabled10.20.1.4
sql-contoso-data, Azure SQLEnabled10.20.1.5
Table 1: Findings
#FindingImpact
1sql-contoso-data allows public access with the ‘Allow Azure services’ rule.Any Azure resource can reach the public endpoint, regardless of subscription.

Proposed Architecture

Internet traffic enters through an Application Gateway with WAF. We recommend a robust approach that leverages private endpoints throughout; the database stays private once the application teams confirm their dependencies.

Implementation Plan

Note. The cloud team applies each change in an agreed change window.

#ActivityOwner
1Disable public access on sql-contoso-data and remove the ‘Allow Azure services’ ruleCloud team
check: 8 findingsexit 1
$ python scripts/docbuilder.py check contoso-draft.docx1punctuation: 1 x em dash4semicolon in prose: 'Internet traffic enters through an Application Gateway with WAF. We re'5inline bold or bold lead-in: 'Note. The cloud team applies each change in an agreed change window.'2provenance/banned wording: 'azure cli'2provenance/banned wording: 'cli'2provenance/banned wording: 'read-only'3AI-sounding word: 'leverages'3AI-sounding word: 'robust'

A skill for Claude Code and other coding agents for producing client-facing design documents in Word (architecture, network security, assessments) on the client's own template, written so they read as prepared by a consultant rather than generated.

Sample: fictional Contoso network security design on a plain template

The agent writes the document as a short Python script on top of the client's .docx template, lets Word refresh the table of contents and export a PDF, then runs check until nothing is reported. The template keeps its cover, change record, header, footer, heading numbering and colours; the script only supplies content.

Docs