diff --git a/AGENTS.md b/AGENTS.md
index d8bd34d..21c26b7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -32,7 +32,7 @@ flutter/craftd_widget/  # Flutter library (pub.dev)
 docs/                   # site documentation (MkDocs)
 ```
 
-Full module dependency graph → `ia/module-graph.md`
+Full module dependency graph → `ai/module-graph.md`
 
 ---
 
@@ -40,9 +40,9 @@ Full module dependency graph → `ia/module-graph.md`
 
 Before starting any task, identify the platform and read the corresponding file:
 
-- Android/KMP → `ia/instructions/android.md`
-- iOS → `ia/instructions/ios.md`
-- Flutter → `ia/instructions/flutter.md`
+- Android/KMP → `ai/instructions/android.md`
+- iOS → `ai/instructions/ios.md`
+- Flutter → `ai/instructions/flutter.md`
 
 Ignore folders outside the platform of the current task:
 - Android/KMP tasks → ignore `ios/` and `flutter/`
@@ -67,7 +67,7 @@ When starting `/apply`, read the `platform:` field from the change's `proposal.m
 ## Available Skills
 
 Before starting any task:
-1. List all files in `ia/skills/`
+1. List all files in `ai/skills/`
 2. Identify which one covers the current task
 3. Read that file in full before proceeding
 
@@ -103,7 +103,7 @@ When applying a change that adds a new Android/KMP component (detectable by the
 - Agent Docs/Sample → documentation and sample app tasks
 
 **Round 4** — reviewer (after Round 3):
-- Agent Reviewer → reviews all produced code against the rules in `ia/skills/architecture.md`. No build — each agent already validated theirs.
+- Agent Reviewer → reviews all produced code against the rules in `ai/skills/architecture.md`. No build — each agent already validated theirs.
 
 Each agent runs in an isolated worktree (`isolation: "worktree"`) and validates the build before marking `[x]`.
 
diff --git a/README-AI-CONTEXT.md b/README-AI-CONTEXT.md
index a81f6e2..abdbd52 100644
--- a/README-AI-CONTEXT.md
+++ b/README-AI-CONTEXT.md
@@ -4,7 +4,7 @@ CraftD uses multiple AI coding tools (Claude Code, GitHub Copilot, Gemini, Curso
 
 ```
 📄 AGENTS.md  ← single source of truth (master initializer)
-📁 ia/        ← detailed context: instructions, skills, module graph
+📁 ai/        ← detailed context: instructions, skills, module graph
 ```
 
 ```mermaid
@@ -16,7 +16,7 @@ graph LR
     CODEX["Codex / OpenAI<br/>(reads natively)"]
 
     AG["📄 AGENTS.md<br/>Master Initializer"]
-    IA["📁 ia/<br/>Detailed Context"]
+    IA["📁 ai/<br/>Detailed Context"]
 
     CLAUDE -->|reads| AG
     COPILOT -->|reads| AG
@@ -27,10 +27,10 @@ graph LR
     AG -->|references| IA
 ```
 
-## ia/ structure
+## ai/ structure
 
 ```
-ia/
+ai/
   module-graph.md         ← module dependency graph
   instructions/
     android.md            ← Android/KMP patterns
diff --git a/ia/instructions/android.md b/ai/instructions/android.md
similarity index 100%
rename from ia/instructions/android.md
rename to ai/instructions/android.md
diff --git a/ia/instructions/flutter.md b/ai/instructions/flutter.md
similarity index 100%
rename from ia/instructions/flutter.md
rename to ai/instructions/flutter.md
diff --git a/ia/instructions/ios.md b/ai/instructions/ios.md
similarity index 100%
rename from ia/instructions/ios.md
rename to ai/instructions/ios.md
diff --git a/ia/module-graph.md b/ai/module-graph.md
similarity index 100%
rename from ia/module-graph.md
rename to ai/module-graph.md
diff --git a/ia/skills/android-gradle-logic.md b/ai/skills/android-gradle-logic.md
similarity index 100%
rename from ia/skills/android-gradle-logic.md
rename to ai/skills/android-gradle-logic.md
diff --git a/ia/skills/android-testing.md b/ai/skills/android-testing.md
similarity index 100%
rename from ia/skills/android-testing.md
rename to ai/skills/android-testing.md
diff --git a/ia/skills/architecture.md b/ai/skills/architecture.md
similarity index 100%
rename from ia/skills/architecture.md
rename to ai/skills/architecture.md
diff --git a/ia/skills/compose-ui.md b/ai/skills/compose-ui.md
similarity index 100%
rename from ia/skills/compose-ui.md
rename to ai/skills/compose-ui.md
diff --git a/ia/skills/new-component.md b/ai/skills/new-component.md
similarity index 95%
rename from ia/skills/new-component.md
rename to ai/skills/new-component.md
index 559fe14..273c948 100644
--- a/ia/skills/new-component.md
+++ b/ai/skills/new-component.md
@@ -102,4 +102,4 @@ Fix any compilation errors before proceeding.
 
 ## iOS / Flutter
 
-Follow the same pattern adapted to each platform. See `ia/instructions/ios.md` and `ia/instructions/flutter.md` for platform-specific folder structure and conventions.
+Follow the same pattern adapted to each platform. See `ai/instructions/ios.md` and `ai/instructions/flutter.md` for platform-specific folder structure and conventions.
diff --git a/ia/skills/review-pr.md b/ai/skills/review-pr.md
similarity index 100%
rename from ia/skills/review-pr.md
rename to ai/skills/review-pr.md
diff --git a/ia/skills/run-build.md b/ai/skills/run-build.md
similarity index 100%
rename from ia/skills/run-build.md
rename to ai/skills/run-build.md