write-avd

Authors Architecture Vision Documents from PRD and TRD inputs using a structured template.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill write-avd-gozonerd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-avd
Source: https://github.com/gozonerd/shadow-ai-assessment/tree/main/.claude/skills/write-avd
Command: npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill write-avd-gozonerd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams entering a code-planning workflow often lack a documented high-level system architecture, causing downstream planning to guess at components, boundaries, and deployment topology. This Skill walks you through authoring a validated Architecture Vision Document (AVD) so the D2R code-plan stage has a complete, approved architectural input. ## Core Features & Use Cases - Template-Driven Authoring: Loads the AVD template and guides you through all ten required sections, from System Shape to Stakeholder Approvals. - Prerequisite Enforcement: Verifies that an approved PRD and TRD exist before authoring, and cross-references their surfaces and constraints throughout. - Skipped-Status Path: Detects trivially simple projects and produces a justified AVD-skipped artifact instead of forcing unnecessary documentation. - Quality Gate: Runs an ASAE audit on the draft to confirm components have inputs/outputs/responsibilities, data flows are traced end-to-end, and mini-ADRs carry real rationale. - Use Case: After approving a PRD and TRD for a new SvelteKit app, invoke this Skill to produce a validated AVD file saved to the planning directory, ready for consumption by the D2R code-plan workflow. ## Quick Start Ask the assistant to write an AVD for your project using the approved PRD and TRD, and it will walk you through each section and save the approved document.

Frequently Asked Questions about write-avd

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

FAQPage Schema
How do I write an Architecture Vision Document for a software project?

Invoke the write-avd skill with your project name, prefix, and approved PRD and TRD references. It loads the AVD template and walks you through ten required sections, then saves the approved document to your planning directory.

What inputs are required before authoring an AVD?

An approved PRD and TRD must exist first, since the AVD is downstream of both. The skill refuses to proceed without them and offers the appropriate authoring skills or the full four-document orchestrated flow instead.

When can a project skip the AVD entirely?

Trivially simple projects qualify: single file, no cross-component boundaries, and no architectural decisions to make. The skill then produces a Skipped-Status AVD with a justification statement that satisfies the D2R prerequisite check.

How is AVD quality validated before approval?

The draft passes through an ASAE gate checking that every component has inputs, outputs, and responsibility, data flows are traced end-to-end, deployment targets have runtimes, and mini-ADRs contain specific rationale rather than preference statements.

What is the difference between standalone and orchestrated AVD authoring?

Standalone mode runs the full user-facing protocol and ends with next-step guidance. Orchestrated mode, invoked by ideate-to-d2r-ready, receives PRD and TRD paths directly and returns a structured handoff block to the orchestrator on approval.