feat: memory system upgrade + directory contract refactor

.claude/CLAUDE.md

@@ -26,26 +26,25 @@ mega-brain/
 │   └── glossary/       -> Domain glossaries
 ├── agents/         -> AI agents (conclave, cargo, persons)
 ├── .claude/        -> Claude Code integration
-├── docs/           -> Documentation, PRDs, plans
-│   ├── prd/            -> Product requirements
-│   └── plans/          -> Plan mode outputs
+├── reference/      -> Documentation, guides, protocols
+├── .planning/      -> GSD plans, roadmap, state
 ├── bin/            -> CLI tools (npm)
 ├── inbox/          -> Raw materials (L3)
-├── artifacts/      -> Pipeline stages (L3)
+├── artifacts/      -> Generated outputs (audit, validation)
 ├── knowledge/      -> Knowledge base (L3)
 └── logs/           -> Session logs (L3)
 ```
 
 ## Plan Mode
 
-Plans MUST be saved to `docs/plans/` (not ~/.claude/plans/).
-When in plan mode, save the plan file to: `docs/plans/YYYY-MM-DD-description.md`
+Plans MUST be saved to `.planning/` (not ~/.claude/plans/).
+When in plan mode, save the plan file to: `.planning/YYYY-MM-DD-description.md`
 
 ### Layer System
 
 | Layer | Content | Git Status |
 |-------|---------|------------|
-| L1 (Community) | core/, agents/conclave, .claude/, bin/, docs/ | Tracked (npm package) |
+| L1 (Community) | core/, agents/conclave, .claude/, bin/, reference/ | Tracked (npm package) |
 | L2 (Pro) | agents/cargo, agents/sub-agents | Tracked (premium) |
 | L3 (Personal) | .data/, .env, agents/persons | Gitignored |
 

.claude/settings.json

@@ -0,0 +1,228 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/session_start.py",
+            "timeout": 10000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/inbox_age_alert.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/skill_indexer.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/session_index.py",
+            "timeout": 5000
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/gsd-check-update.js",
+            "timeout": 10000
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/continuous_save.py",
+            "timeout": 2000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/user_prompt_submit.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/skill_router.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/quality_watchdog.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/memory_hints_injector.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/enforce_plan_mode.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/memory_updater.py",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/claude_md_guard.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/creation_validator.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 '/Users/thiagofinch/Documents/Projects/mega-brain/.claude/hooks/directory_contract_guard.py'",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/continuous_save.py",
+            "timeout": 2000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/post_tool_use.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/post_batch_cascading.py",
+            "timeout": 30000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/enforce_dual_location.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/pending_tracker.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/agent_creation_trigger.py",
+            "timeout": 10000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/agent_index_updater.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/claude_md_agent_sync.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/pipeline_checkpoint.py",
+            "timeout": 5000
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/gsd-context-monitor.js",
+            "timeout": 10000
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/continuous_save.py",
+            "timeout": 2000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/session_index.py",
+            "timeout": 5000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/stop_hook_completeness.py",
+            "timeout": 10000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/ralph_wiggum.py",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/session_end.py",
+            "timeout": 10000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/session_autosave_v2.py save session_end",
+            "timeout": 10000
+          },
+          {
+            "type": "command",
+            "command": "python3 .claude/hooks/agent_memory_persister.py",
+            "timeout": 5000
+          }
+        ]
+      }
+    ]
+  },
+  "permissions": {
+    "deny": [
+      "Bash(rm -rf *)",
+      "Bash(sudo *)",
+      "Bash(chmod 777 *)",
+      "Bash(git push --force *)",
+      "Bash(git push --force)",
+      "Bash(git reset --hard *)"
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "node .claude/hooks/gsd-statusline.js"
+  }
+}

.gitignore

@@ -136,7 +136,7 @@ logs/**
 .claude/monitoring/
 .claude/mission-control/
 .claude/learning-system/
-.claude/agent-memory/
+# .claude/agent-memory/ → tracked (persistent agent memory, L1 community)
 .claude/jarvis/
 .claude/audit-*.json
 .claude/guides/
@@ -188,6 +188,10 @@ reference/README-RALPH-*.md
 
 # Docs internos L3
 docs/referencias/
+docs/audit/
+
+# Artifacts audit (runtime output — L3 only)
+artifacts/audit/
 
 # Agentes populados L3 (boardroom outputs, voice)
 agents/boardroom/outputs/
@@ -200,6 +204,17 @@ core/intelligence/speakers/VOICE-REGISTRY.yaml
 core/intelligence/speakers/voice_embeddings/
 core/intelligence/speakers/*.pkl
 
+# Pessoas internas — dados L3 (nunca rastrear)
+# Colaboradores, parceiros, pessoas internas à operação
+knowledge/dossiers/persons/*-PEDRO-*.md
+knowledge/dossiers/persons/*-VALERIO-*.md
+knowledge/sources/pedro*/
+knowledge/sources/valerio*/
+agents/persons/pedro*/
+agents/persons/valerio*/
+inbox/pedro*/
+inbox/PEDRO*/
+
 # Frameworks externos (nunca rastrear)
 .aiox/
 bilhon/
@@ -260,6 +275,7 @@ bilhon/
 !.env.example
 !.mcp.example.json
 !README.md
+!CLAUDE.md
 !CONTRIBUTING.md
 !QUICK-START.md
 !API-KEYS-GUIDE.md
@@ -341,6 +357,10 @@ bilhon/
 !.claude/templates/
 !.claude/templates/**
 
+# .claude/agent-memory (persistent per-agent memory)
+!.claude/agent-memory/
+!.claude/agent-memory/**
+
 # .claude/get-shit-done
 !.claude/get-shit-done/
 !.claude/get-shit-done/**