diff --git a/README.md b/README.md
index ffe62f9..6af5e50 100644
--- a/README.md
+++ b/README.md
@@ -237,8 +237,13 @@ openwokwi/
 ├── scripts/
 │   └── generate-component-metadata.ts    # AST parser for component discovery
 │
-├── ARCHITECTURE.md                 # Detailed architecture documentation
-├── WOKWI_LIBS.md                   # Wokwi integration documentation
+├── doc/
+│   ├── ARCHITECTURE.md                 # Detailed architecture documentation
+│   ├── WOKWI_LIBS.md                   # Wokwi integration documentation
+│   ├── SETUP_COMPLETE.md               # Project status overview
+│   └── examples/                       # Example screenshots
+│
+├── CLAUDE.md                       # AI assistant guidance
 └── update-wokwi-libs.bat           # Update local Wokwi libraries
 ```
 
@@ -290,7 +295,7 @@ npm install
 npm run build
 ```
 
-See [WOKWI_LIBS.md](WOKWI_LIBS.md) for more details about Wokwi integration.
+See [WOKWI_LIBS.md](doc/WOKWI_LIBS.md) for more details about Wokwi integration.
 
 ## Troubleshooting
 
diff --git a/frontend/README.md b/frontend/README.md
index 122b4ec..e19e288 100644
--- a/frontend/README.md
+++ b/frontend/README.md
@@ -209,8 +209,8 @@ See [backend documentation](../backend/README.md) for API details.
 
 - [Main Project README](../README.md)
 - [Development Guide (CLAUDE.md)](../CLAUDE.md)
-- [Architecture Documentation](../ARCHITECTURE.md)
-- [Wokwi Integration](../WOKWI_LIBS.md)
+- [Architecture Documentation](../doc/ARCHITECTURE.md)
+- [Wokwi Integration](../doc/WOKWI_LIBS.md)
 - [Monaco Editor API](https://microsoft.github.io/monaco-editor/api/index.html)
 - [Vite Documentation](https://vitejs.dev/)
 - [Zustand Guide](https://docs.pmnd.rs/zustand/getting-started/introduction)