Merge pull request #6 from dev-sire/001-physical-ai-book

added final documentations

Author: dev-sire

README.md

@@ -0,0 +1,41 @@
+# Physical AI & Humanoid Robotics Book
+
+Welcome to the official repository for the "Physical AI & Humanoid Robotics Book"! This project serves as a comprehensive guide for anyone interested in the exciting convergence of artificial intelligence and physical robotic systems, with a particular focus on humanoid forms.
+
+## About the Book
+
+This book is meticulously crafted to educate developers, researchers, students, and enthusiasts on the principles, challenges, and advancements in Physical AI and Humanoid Robotics. Our core purpose is to provide a deep dive into how modern AI algorithms are integrated into physical machines to enable intelligent behavior, focusing on the unique aspects of humanoid design and interaction.
+
+## Key Themes & Learning Objectives
+
+Throughout the chapters, readers will explore critical topics designed to build a robust understanding of the field:
+
+*   **The Convergence of AI and Robotics:** Understand the symbiotic relationship between advanced AI and physical robotics.
+*   **Humanoid Design and Mechanics:** Gain insights into the mechanical engineering, kinematics, and actuation systems that define humanoid robots.
+*   **Perception and Cognition:** Learn how robots use sensors and AI to perceive their environment, process information, and make autonomous decisions.
+*   **Control and Manipulation:** Discover the algorithms and hardware architectures enabling complex movements, dexterous manipulation, and human-robot interaction.
+*   **Ethical and Societal Implications:** Engage with the profound ethical, social, and economic considerations arising from the proliferation of advanced humanoid robotics.
+
+By the culmination of this book, readers are expected to:
+
+*   **Master Fundamental Concepts:** Develop a solid grasp of core theories in Physical AI and humanoid robotics.
+*   **Appreciate Interdisciplinary Nature:** Understand how fields like AI, mechanical engineering, computer science, and ethics interweave.
+*   **Identify Research Frontiers:** Recognize current challenges and promising future directions in the research landscape.
+*   **Evaluate Applications & Ethics:** Critically assess the practical applications and ethical frameworks surrounding advanced robotics.
+
+## Glossary of Terms
+
+To ensure clarity and accessibility, the book includes a comprehensive [Glossary](docs/glossary.md) defining key technical jargon and AI-specific terminology. Some examples include:
+
+*   **Actuator:** A component responsible for converting energy into motion.
+*   **Degrees of Freedom (DoF):** The number of independent parameters defining a mechanical system's configuration.
+*   **SLAM (Simultaneous Localization and Mapping):** A computational method for mapping an environment while tracking location within it.
+*   **Artificial General Intelligence (AGI):** Hypothetical AI capable of human-level intelligence across any task.
+*   **Deep Learning:** A subset of machine learning using neural networks to learn from vast data.
+*   **Reinforcement Learning (RL):** An AI method focused on maximizing rewards through agent actions in an environment.
+
+## Getting Started
+
+To navigate the book's content, explore the `docs/` directory, which contains individual chapters, an introduction, module summaries, and a syllabus.
+
+We encourage contributions and feedback from the community to make this resource even better!

docusaurus.config.js

@@ -17,17 +17,10 @@ const config = {
   title: 'Physical AI & Humanoid Robotics Book',
   tagline: 'A guide to bridging digital AI with real-world robotic systems.',
   favicon: 'img/favicon.ico',
-
-  // Set the production url of your site here
-  url: 'https://your-docusaurus-site.com',
-  // Set the /<baseUrl>/ pathname under which your site is served
-  // For GitHub pages deployment, it is often '/<projectName>/'
-  baseUrl: '/',
-
-  // GitHub pages deployment config.
-  // If you aren't using GitHub pages, you don't need these.
-  organizationName: 'your-org', // Usually your GitHub org/user name.
-  projectName: 'physical-ai-book', // Usually your repo name.
+  url: 'https://dev-sire.github.io',
+  baseUrl: '/Humanoid-AI-Book/',
+  organizationName: 'dev-sire',
+  projectName: 'Humanoid-AI-Book',
 
   onBrokenLinks: 'throw',
   onBrokenMarkdownLinks: 'warn',

history/prompts/general/002-add-detailed-readme.general.prompt.md

@@ -0,0 +1,45 @@
+---
+id: 002
+title: Add Detailed Readme.md to Project Root
+stage: general
+date: 2025-12-06
+surface: agent
+model: claude-sonnet-4-5-20250929
+feature: none
+branch: 001-physical-ai-book
+user: user
+command: in the root of the project add a detailed Readme.md explaining the book
+labels: ["documentation","readme"]
+links:
+  spec: null
+  ticket: null
+  adr: null
+  pr: null
+files:
+  - Readme.md
+tests:
+
+---
+
+## Prompt
+
+in the root of the project add a detailed Readme.md explaining the book
+
+## Response snapshot
+
+Created `Readme.md` in the project root with a detailed explanation of the book, including its purpose, key themes, learning objectives, and a reference to the glossary.
+
+## Outcome
+
+- ✅ Impact: A new `Readme.md` file was created, providing a comprehensive overview of the book.
+- 🧪 Tests: No specific tests were performed, content was visually reviewed.
+- 📁 Files: One file created: `Readme.md`.
+- 🔁 Next prompts: null
+- 🧠 Reflection: The task involved synthesizing information from existing introduction and glossary files to create a concise yet detailed project overview for the main README.
+
+## Evaluation notes (flywheel)
+
+- Failure modes observed: null
+- Graders run and results (PASS/FAIL): null
+- Prompt variant (if applicable): null
+- Next experiment (smallest change to try): null