# 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.