diff --git a/PROJECT_SUMMARY.md b/PROJECT_SUMMARY.md
new file mode 100644
index 0000000..c43a9d7
--- /dev/null
+++ b/PROJECT_SUMMARY.md
@@ -0,0 +1,44 @@
+# claude-code-is-programmable — Project Summary
+
+- Upstream: [disler/claude-code-is-programmable](https://github.com/disler/claude-code-is-programmable)
+- Stars (upstream): 256
+- Description: Scale your compute with Claude Code as a programmable agentic coding tool 
+- Primary Languages: Python (11), JavaScript (2)
+- Detected Stack: Python
+
+## Tooling
+- Minimal tooling detected
+
+## Build
+- No build configuration detected
+
+## Common Commands
+- No Node scripts detected
+
+## Project Layout (top-level)
+- .claude
+- ai_docs
+- bonus
+- images
+- tests
+- .aider.conf.yml
+- .env.sample
+- .gitignore
+- .mcp.sample.json
+- aider_is_programmable_1.sh
+- aider_is_programmable_2.js
+- aider_is_programmable_2.py
+
+## CI/CD
+- No CI workflows detected
+
+## Docker
+- No Docker artifacts detected
+
+## Quickstart
+
+## Suggested Next Steps
+- Add .editorconfig
+- Add GitHub Actions CI (lint, type, test)
+- Add Dockerfile for containerized runs
+