Phase 8: add the Reference App wiki walkthrough (06_reference_app)

- four pages walking the vet sample: overview, domain & API, pipelines &
  worker, spec-driven client admin
- mkdocs nav section, index + start-an-app cross links
- bundle now exposes the walkthrough as wiki_reference_app_* modules
This commit is contained in:
2026-10-20 15:02:11 +05:30
parent 0cb35d10a6
commit f8cf35de0e
28 changed files with 5760 additions and 19 deletions

View File

@@ -277,6 +277,28 @@
<li class="md-tabs__item">
<a href="06_reference_app/01_overview/" class="md-tabs__link">
Reference App
</a>
</li>
<li class="md-tabs__item">
<a href="05_mcp_setup/" class="md-tabs__link">
@@ -533,6 +555,12 @@
@@ -556,7 +584,7 @@
<span class="md-ellipsis">
MCP
Reference App
</span>
@@ -566,6 +594,154 @@
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
Reference App
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="06_reference_app/01_overview/" class="md-nav__link">
<span class="md-ellipsis">
Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="06_reference_app/02_domain_and_api/" class="md-nav__link">
<span class="md-ellipsis">
Domain & API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="06_reference_app/03_pipelines_and_worker/" class="md-nav__link">
<span class="md-ellipsis">
Pipelines & Worker
</span>
</a>
</li>
<li class="md-nav__item">
<a href="06_reference_app/04_client_admin/" class="md-nav__link">
<span class="md-ellipsis">
Client Admin
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
<label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
<span class="md-ellipsis">
MCP
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_6">
<span class="md-nav__icon md-icon"></span>
MCP
</label>
@@ -712,6 +888,10 @@ Query <code>find_library</code> before writing any infrastructure.</p>
<td>The entry point: gather the two axes, then build</td>
</tr>
<tr>
<td><a href="06_reference_app/01_overview/">Reference App</a></td>
<td>The runnable vet sample — server, pipelines, client</td>
</tr>
<tr>
<td><a href="04_development/01_testing/">Testing &amp; Quality</a></td>
<td>Test layout and acceptance gates</td>
</tr>
@@ -738,7 +918,9 @@ Registry</a>).</p>
<code>docs://nav</code>, <code>docs://modules/{module}</code>; call <code>find_library(capability)</code></li>
<li><strong>Library registry</strong> — the catalog of internal libraries behind every app
(<code>libraries.json</code>, served as <code>registry://libraries</code>)</li>
<li><strong>Template</strong> — the runnable skeleton at <code>standards/src/templates/app/</code></li>
<li><strong>Template</strong> — the runnable sample at <code>standards/src/templates/app/</code>
(server) and <code>standards/src/templates/client/</code> (React admin); walkthrough in
the <a href="06_reference_app/01_overview/">Reference App</a></li>
<li><strong>Start a build</strong> — invoke the <code>start_app</code> prompt on the <code>standards</code> server,
or read the <a href="03_start_an_app/">Start an App</a> guide</li>
</ul>