From 8ca0add87555342e0fd0700b6f073b0868b43467 Mon Sep 17 00:00:00 2001
From: Woojin Son <swj1265@naver.com>
Date: Tue, 24 Feb 2026 00:14:54 +0900
Subject: [PATCH 1/2] docs: add essential documents about opencode support

---
 README.md                                     | 13 ++++++++++
 .../TEMPLATE_README.md                        | 26 ++++++++++++++++++-
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e09065c..ba8a890 100644
--- a/README.md
+++ b/README.md
@@ -78,6 +78,19 @@ uv sync
 This command installs all dependencies defined in `pyproject.toml` and prepares the project for execution.
 
 
+### OpenCode Quick Start
+
+```bash
+# Launch in the current project
+opencode .
+
+# One-shot run
+opencode run "Design a customer support chatbot"
+```
+
+OpenCode reads environment variables from the project root `.env` (set in `langgraph.json` as `env: ".env"`).
+
+
 ### Start Building with AI
 
 Act includes built-in **Agent Skills**—folders of instructions that allow AI agents to **discover, activate, and execute** specialized capabilities for this project.
diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md
index 568fc48..cf8d535 100644
--- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md	
+++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md	
@@ -80,6 +80,18 @@ uv sync --package {{ cookiecutter.cast_snake }}
 
 > Member names match the `[project].name` in each `pyproject.toml` under `casts/<cast_name>`.
 
+## OpenCode Quick Start
+
+```bash
+# Launch in the current project
+opencode .
+
+# One-shot run
+opencode run "Design a customer support chatbot"
+```
+
+OpenCode reads environment variables from the project root `.env` (set in `langgraph.json` as `env: ".env"`).
+
 ## Graph Registry (langgraph.json)
 
 Declare graphs to expose in `langgraph.json`. A basic example is as follows:
@@ -400,6 +412,18 @@ uv sync --package {{ cookiecutter.cast_snake }}
 
 > 멤버명은 `casts/<cast_name>` 하위의 각 `pyproject.toml`의 `[project].name`과 일치합니다.
 
+## OpenCode 빠른 시작
+
+```bash
+# 현재 프로젝트에서 실행
+opencode .
+
+# 원샷 실행
+opencode run "고객 지원 챗봇 설계를 도와줘"
+```
+
+OpenCode는 프로젝트 루트의 `.env`를 사용합니다(`langgraph.json`의 `env: ".env"`).
+
 ## 그래프 레지스트리(langgraph.json)
 
 `langgraph.json`에서 노출할 그래프를 선언합니다. 기본 예시는 다음과 같습니다.
@@ -638,4 +662,4 @@ uv run ruff format .
 ---
 
 **본 템플릿은 [Proact0](https://www.proact0.org/)에서 관리하고 있습니다.**
-{% endif %}
\ No newline at end of file
+{% endif %}

From 584088defacff54e9550ddb0e9dcca8b119eb86c Mon Sep 17 00:00:00 2001
From: Woojin Son <swj1265@naver.com>
Date: Tue, 24 Feb 2026 00:32:16 +0900
Subject: [PATCH 2/2] docs: add opencode guide in readme.kr

---
 README_KR.md                                        | 13 +++++++++++++
 .../{{ cookiecutter.act_slug }}/TEMPLATE_README.md  |  2 +-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/README_KR.md b/README_KR.md
index e2a634b..a234d11 100644
--- a/README_KR.md
+++ b/README_KR.md
@@ -78,6 +78,19 @@ uv sync
 이 명령은 `pyproject.toml`에 정의된 모든 의존성을 설치하고 프로젝트 실행을 준비합니다.
 
 
+### OpenCode 빠른 시작
+
+```bash
+# 현재 프로젝트에서 실행
+opencode .
+
+# One-shot run
+opencode run "고객 지원 챗봇 설계를 도와줘"
+```
+
+OpenCode는 프로젝트 루트의 `.env`를 사용합니다(`langgraph.json`의 `env: ".env"`).
+
+
 ### AI와 함께 빌드 시작하기
 
 Act에는 **Agent Skills**가 내장되어 있습니다. 이는 AI 에이전트가 프로젝트를 위한 전문 기능을 **발견(Discover), 활성화(Activate), 실행(Execute)** 할 수 있도록 하는 지침 폴더입니다.
diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md
index cf8d535..7cde6f6 100644
--- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md	
+++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md	
@@ -418,7 +418,7 @@ uv sync --package {{ cookiecutter.cast_snake }}
 # 현재 프로젝트에서 실행
 opencode .
 
-# 원샷 실행
+# One-shot run
 opencode run "고객 지원 챗봇 설계를 도와줘"
 ```