diff --git a/.idea/agent_platform_oci.iml b/.idea/agent_platform_oci.iml
new file mode 100644
index 0000000..853e1f0
--- /dev/null
+++ b/.idea/agent_platform_oci.iml
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="TemplatesService">
+    <option name="TEMPLATE_FOLDERS">
+      <list>
+        <option value="$MODULE_DIR$/templates" />
+      </list>
+    </option>
+  </component>
+</module>
\ No newline at end of file
diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml
new file mode 100644
index 0000000..919ce1f
--- /dev/null
+++ b/.idea/codeStyles/Project.xml
@@ -0,0 +1,7 @@
+<component name="ProjectCodeStyleConfiguration">
+  <code_scheme name="Project" version="173">
+    <ScalaCodeStyleSettings>
+      <option name="MULTILINE_STRING_CLOSING_QUOTES_ON_NEW_LINE" value="true" />
+    </ScalaCodeStyleSettings>
+  </code_scheme>
+</component>
\ No newline at end of file
diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml
new file mode 100644
index 0000000..a55e7a1
--- /dev/null
+++ b/.idea/codeStyles/codeStyleConfig.xml
@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
+  </state>
+</component>
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
new file mode 100644
index 0000000..3fb2fd0
--- /dev/null
+++ b/.idea/modules.xml
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/agent_platform_oci.iml" filepath="$PROJECT_DIR$/.idea/agent_platform_oci.iml" />
+    </modules>
+  </component>
+</project>
\ No newline at end of file
diff --git a/README.md b/README.md
index a48fd3b..3502e39 100644
--- a/README.md
+++ b/README.md
@@ -7881,8 +7881,8 @@ Dentro de `agent_template_backend`:
 
 ```bash
 source .venv/bin/activate
-cd agent_template_backend
-pip install -e ../agent_framework
+cd templates/agent_template_backend
+pip install -e ../../libs/agent_framework
 pip install -r requirements.txt
 python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
 ```
@@ -7949,7 +7949,7 @@ Se os MCP Servers forem processos Python separados, suba cada um em uma porta di
 Exemplo:
 
 ```bash
-cd ../mcp_servers/financeiro_mcp_server
+cd mcp/servers/financeiro_mcp_server
 source .venv/bin/activate
 python -m uvicorn main:app --host 0.0.0.0 --port 8300 --reload
 ```
@@ -7998,7 +7998,7 @@ Install before the [npm](https://nodejs.org/) and:
 
 ```bash
 cd agent_platform_oci
-cd agent_frontend
+cd apps/agent_frontend
 python -m http.server 5173
 ```
 
diff --git a/README_en.md b/README_en.md
index b659653..58ff62c 100644
--- a/README_en.md
+++ b/README_en.md
@@ -7787,8 +7787,8 @@ Inside `agent_template_backend`:
 
 ```bash
 source .venv/bin/activate
-cd agent_template_backend
-pip install -e ../agent_framework
+cd templates/agent_template_backend
+pip install -e ../../libs/agent_framework
 pip install -r requirements.txt
 python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
 ```
@@ -7855,7 +7855,7 @@ If the MCP Servers are separate Python processes, upload each one on a different
 Example:
 
 ```bash
-cd ../mcp_servers/financeiro_mcp_server
+cd mcp/servers/financeiro_mcp_server
 source .venv/bin/activate
 python -m uvicorn main:app --host 0.0.0.0 --port 8300 --reload
 ```
@@ -7902,7 +7902,7 @@ curl -X POST http://localhost:8000/debug/mcp/call/consultar_titulo_financeiro \
 
 ```bash
 cd agent_platform_oci
-cd agent_frontend
+cd apps/agent_frontend
 python -m http.server 5173
 ```