AgenticCode/.planning/codebase/STACK.md

Technology Stack

Analysis Date: 2026-03-27

Languages

Primary:

• JavaScript (Node.js) - Core framework and tooling
• CommonJS (.cjs) - Module format for all library files
• Markdown - Configuration, documentation, and state files

Runtime

Environment:

• Node.js (version not explicitly specified, uses #!/usr/bin/env node shebang)

Package Manager:

• npm (inferred from package.json presence)
• Lockfile: Not detected in codebase

Frameworks

Core:

• Get Shit Done (GSD) Framework v1.29.0 - Agentic code orchestration and planning
• Native Node.js APIs - child_process, fs, path

Search & Web:

• Brave Search API - Web search integration via HTTP fetch

Build/Dev:

• Node.js built-in utilities - No external build tool detected

Key Dependencies

Critical:

• child_process - Subprocess execution for git commands and CLI operations
• fs - File system operations for planning document management
• path - Cross-platform path handling
• os - Environment detection (home directory, temp directories)

Infrastructure:

• fetch API (native Node.js) - HTTP requests for Brave Search API

Configuration

Environment:

• Stored in ~/.gsd/ directory with separate API key files
• Environment variable overrides: BRAVE_API_KEY, FIRECRAWL_API_KEY, EXA_API_KEY

Key Configuration Files:

• .planning/config.json - Project-wide configuration and feature flags
• settings.json - Agent-specific settings (per ./.agent/, ./.claude/, ./.gemini/, etc.)
• .gsd-file-manifest.json - File integrity tracking with SHA256 hashes

Configuration Features:

• Multi-repository workspace support
• Model profile resolution
• Milestone and workstream management
• Phase numbering strategies (decimal or custom)

Platform Requirements

Development:

• Node.js with built-in ES2020+ support
• Git (for repository operations and commits)
• Bash/Shell environment for command execution
• File system with support for symlinks and deep directory structures

Production:

• Self-contained Node.js CLI tool
• No external runtime required beyond Node.js
• Execution via node gsd-tools.cjs or direct command invocation

---

Stack analysis: 2026-03-27