docs: set up MkDocs site with technical/general docs split

Add mkdocs.yml (windmill theme, mermaid2, matching ~/Chirone/chirone/etl setup) with nav split into "ThothII (Documentazione Tecnica)" — architecture overview, existing design specs/plans, reports — and "Considerazioni Generali" for cross-project notes. Add docs/general/pi-configuration.md explaining Pi's three model-resolution tiers (built-in, user models.json, project extension) and where GLM/DeepSeek/ Qwen each sit. Add docs/architecture/overview.md synthesizing the ThothII architecture for the doc site. Relocate the L2 run report into docs/reports/. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-02 12:37:26 +02:00
parent 4479683cf4
commit 7c417d4cf1
9 changed files with 527 additions and 0 deletions
@@ -0,0 +1,76 @@
+site_name: ThothII Docs
+site_description: Documentazione tecnica di ThothII e considerazioni generali sull'ambiente di sviluppo
+site_url: https://mptyl.github.io/ThothII/
+repo_url: https://github.com/mptyl/ThothII
+repo_name: mptyl/ThothII
+edit_uri: edit/main/docs/
+docs_dir: docs
+site_dir: site
+use_directory_urls: true
+theme:
+  name: windmill
+  highlightjs: true
+  hljs_languages:
+  - yaml
+  - sql
+  - bash
+  - python
+  - json
+  - typescript
+plugins:
+- search
+- mermaid2
+extra_css:
+- stylesheets/extra.css
+extra_javascript:
+- javascripts/layout-init.js
+markdown_extensions:
+- admonition
+- attr_list
+- md_in_html
+- tables
+- toc:
+    permalink: true
+- pymdownx.details
+- pymdownx.highlight:
+    anchor_linenums: true
+- pymdownx.inlinehilite
+- pymdownx.snippets
+- pymdownx.superfences:
+    custom_fences:
+    - name: mermaid
+      class: mermaid
+      format: !!python/name:mermaid2.fence_mermaid
+- pymdownx.tabbed:
+    alternate_style: true
+nav:
+- Home: index.md
+- ThothII (Documentazione Tecnica):
+  - Panoramica Architettura: architecture/overview.md
+  - Specifiche di Design:
+    - Architettura ThothII: superpowers/specs/2026-06-25-thothii-architecture-design.md
+    - Backend: superpowers/specs/2026-06-27-backend-design.md
+    - Frontend: superpowers/specs/2026-06-27-frontend-design.md
+    - CLI Port / Skill: superpowers/specs/2026-06-27-cli-port-completo-skill-riscritta-design.md
+    - Settings Menu: superpowers/specs/2026-06-28-settings-menu-design.md
+    - Ollama Ensure: superpowers/specs/2026-06-29-ollama-ensure-design.md
+    - Session Management: superpowers/specs/2026-06-29-session-management-design.md
+    - Session UI Refinements: superpowers/specs/2026-06-29-session-ui-refinements-design.md
+    - Workflow Contract Hardening: superpowers/specs/2026-07-01-workflow-contract-hardening-design.md
+  - Piani di Implementazione:
+    - Harness: superpowers/plans/2026-06-25-harness-implementation.md
+    - Backend: superpowers/plans/2026-06-27-backend-implementation.md
+    - Frontend: superpowers/plans/2026-06-27-frontend-implementation.md
+    - Harness RPC Readiness: superpowers/plans/2026-06-27-harness-rpc-readiness.md
+    - CLI Porting / Skill: superpowers/plans/2026-06-27-tht-porting-cli-skill.md
+    - Settings Menu: superpowers/plans/2026-06-28-settings-menu.md
+    - Ollama Ensure: superpowers/plans/2026-06-29-ollama-ensure.md
+    - Session Management: superpowers/plans/2026-06-29-session-management.md
+    - Session UI Refinements: superpowers/plans/2026-06-29-session-ui-refinements.md
+    - Cross-Model Behavior Matrix: superpowers/plans/2026-06-30-cross-model-behavior-matrix.md
+    - Workflow Contract Hardening: superpowers/plans/2026-07-01-workflow-contract-hardening.md
+  - Report:
+    - L2 Run Report (2026-06-27): reports/l2-run-report-2026-06-27.md
+    - "Stato e Ripresa (snapshot 2026-06-27, superato da PROJECT_STATE.md)": superpowers/2026-06-27-stato-e-ripresa.md
+- Considerazioni Generali:
+  - Configurazione dei modelli in Pi: general/pi-configuration.md