[agent:surfer] init template AI-ready : WORKFLOW, AGENTS, AI_CONTEXT, Sphinx, scripts

docs/Makefile

@@ -0,0 +1,9 @@
+SPHINXBUILD = sphinx-build
+SOURCEDIR   = .
+BUILDDIR    = _build
+
+html:
+	$(SPHINXBUILD) -b html $(SOURCEDIR) $(BUILDDIR)/html
+
+clean:
+	rm -rf $(BUILDDIR)

docs/architecture.rst

@@ -0,0 +1,4 @@
+Architecture
+============
+
+*À documenter.*

docs/changelog.rst

@@ -0,0 +1,6 @@
+Changelog
+=========
+
+v0.1 — init
+-----------
+- Scaffold initial

docs/conf.py

@@ -0,0 +1,6 @@
+project = "PROJECT_NAME"
+author = "Flag / OpenClaw agents"
+release = "0.1"
+extensions = ["myst_parser", "sphinx.ext.autodoc", "sphinx.ext.viewcode"]
+html_theme = "sphinx_rtd_theme"
+source_suffix = {".rst": "restructuredtext", ".md": "markdown"}

docs/index.rst

@@ -0,0 +1,15 @@
+PROJECT_NAME
+============
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Documentation
+
+   architecture
+   changelog
+   api
+
+Overview
+--------
+
+*À compléter — voir AI_CONTEXT.md pour le contexte agent.*