docs: output generated sources under docs/lib and docs/mcp

docforge/cli/commands.py

@@ -39,7 +39,7 @@ def cli() -> None:
 @click.option(
     "--docs-dir",
     type=click.Path(path_type=Path),
-    default=Path("docs"),
+    default=Path("docs/lib"),
     help="Directory for MD sources",
 )
 @click.option(
@@ -61,7 +61,7 @@ def cli() -> None:
 @click.option(
     "--out-dir",
     type=click.Path(path_type=Path),
-    default=Path("mcp_docs"),
+    default=Path("docs/mcp"),
     help="MCP output directory",
 )
 def build(
@@ -144,6 +144,7 @@ def build(
             docs_dir,
             project_name,
             module_is_source,
+            readme_dir=mkdocs_yml.parent,
         )
 
         click.echo(f"Generating MkDocs config {mkdocs_yml}...")
@@ -177,7 +178,7 @@ def build(
 @click.option(
     "--out-dir",
     type=click.Path(path_type=Path),
-    default=Path("mcp_docs"),
+    default=Path("docs/mcp"),
     help="MCP root directory",
 )
 def serve(