WAD
Summary
Wil's Architecture Document: a typed WCL data model of a software system — C4 drill-down, arc42-style views — rendered into a twelve-chapter architecture book.
| Version | 0.1.0 |
| Created | 2026-07-02 |
| Last updated | — |
| Maintainer | maintainer |
A WAD captures a software system's architecture as typed WCL data: systems, containers, relations, infrastructure, decisions, procedures, domain objects, screens, and specs, filed under twelve views. Humans and extractor scripts populate data/; wdoc templates derive every diagram and render the book — the book is for humans. For implementation, an LLM decomposes reviewed WAD changes into specs sized for the coding agent that builds them (a strong model can implement straight from the WAD). This wskill covers the format, how to populate a WAD for a new or existing system (including the interview and codebase-scan checklists), extractor scripts, and the spec workflow.
§ 1Artifacts
The views this wskill ships — build them with just render (or the per-view recipes).
| View | Entry | Output |
|---|---|---|
| book | wdoc/book/main.wcl | out/book |
| ai skill | wdoc/skill/main.wcl | out/skill |
| Name | Relation | Status |
|---|---|---|
| wcl | prerequisite — WADs are WCL documents | exists |
| wdoc | peer — serve/comment/markdown mechanics | exists |
| wskill | peer — the format this wskill is built with | exists |
§ 3Sources
Sources drive the update workflow only — they are not topic content.
| ID | Kind | Locator | Covers | Last checked | Reflects version |
|---|---|---|---|---|---|
| wad_schema | code | crates/wcl/src/scaffold/templates/wad.wcl (heredoc WADSCHEMABASE_WCL — the canonical schema) | Every block type and field the per-view facts document. | 2026-07-02 | 0.1.0 |
| reference_wad | code | .wad/ in the WCL repository (the reference WAD, documenting WCL itself) | Worked examples: data files, extractors, book output. | 2026-07-02 | — |
| wadclihelp | cli | wcl init --help / wcl wad spec --help / wcl diff --help | The command table fact. | 2026-07-02 | — |