chore: initial project setup with agent guide

.planning/codebase/STACK.md

@@ -0,0 +1,29 @@
+# Codebase Stack (`STACK.md`)
+
+## Languages
+- **Shell / Batch Scripting**: Used heavily for the zero-pollution bootstrap scripts (`bootstrap.bat`, `bootstrap.sh`, `sync_vendors.bat`, `sync_vendors.sh`).
+- **JavaScript (Node.js)**: Used for vendor extraction and translation scripts (`extract_skills.js`, `translate_skills.js`).
+- **Python**: Required indirectly for running installed Python MCP servers (`browser_use`, `mini-swe`, `claude-mem`) during satellite bootstrapping.
+
+## Runtimes & Frameworks
+- **Node.js**: The `.agent/env` isolates local dependencies (e.g. `npm install`, `npx get-shit-done-cc`, `uipro-cli`). 
+- **Python**: Expected to be provided externally via user's `AGENT_PYTHON_PATH` to isolate plugin Python processes.
+- **Agent Engines**: Target runtimes interacting with this environment include Google Gemini CLI / Antigravity, Claude Code, and Copilot.
+
+## Core Dependencies
+- **UI & Workflow Generative Frameworks**:
+  - `get-shit-done-cc`: CLI orchestration framework for generating GSD workflows.
+  - `uipro-cli`: Generates UI/UX specification data.
+- **Git Submodules** (defined in `.gitmodules`):
+  - `.agent/vendor/superpowers`
+  - `.agent/knowledge/everything_claude`
+  - `.agent/knowledge/awesome_claude`
+  - `.agent/vendor/obsidian-skills`
+  - `.agent/services/claude-mem`
+  - `.agent/services/mcp-core`
+  - `.agent/vendor/browser_use`
+  - `.agent/vendor/mini-swe`
+
+## Configuration
+- `.agent/config/.env.agent`: Developer-specific agent configuration. Uses `.template` fallback.
+- `PROJECT.md` & `ROADMAP.md`: Project-level planning and tracker configurations.