diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6fe2aad..08c0aac 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0] - 2026-04-16
+
+### Changed
+- **Version bumped to 1.0.0** — stable release milestone.
+- **README.md** — updated status to "Stable v1.0", updated roadmap to mark v1.0 as shipped.
+- **README-zh.md** — updated version references in agent format examples.
+
 ## [0.7.2.1] - 2026-04-16
 
 ### Removed
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..1aaf5ff
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,6 @@
+
+## Health Stack
+
+- typecheck: ./gradlew compileJava
+- test: ./gradlew test
+- archon: java -jar archon-cli/build/libs/archon-1.0.0.jar analyze .
diff --git a/README-zh.md b/README-zh.md
index a605fb2..9617ab1 100644
--- a/README-zh.md
+++ b/README-zh.md
@@ -177,7 +177,7 @@ AI agent 收到：
 
 ```json
 {
-  "version": "0.7.2.0",
+  "version": "1.0.0",
   "domains": ["core", "java", "cli"],
   "nodes": [
     ["java:com.archon.core.graph.DependencyGraph", 0, 820, "HIGH", true, true],
diff --git a/README.md b/README.md
index 2851400..f92469f 100644
--- a/README.md
+++ b/README.md
@@ -322,13 +322,13 @@ archon-cli/      — CLI with shadow JAR packaging
 - [x] v0.5 — Visualization (web UI)
 - [x] v0.6 — Cross-language edge detection
 - [x] v0.7 — JS/TS rewrite + Spring DI detection + command consolidation
-- [ ] v1.0 — Full AI-refactoring pipeline integration
+- [x] v1.0 — Stable release: multi-language analysis, AI agent integration, compressed agent format
 
 ---
 
 ## Status
 
-Experimental / early-stage system design
+Stable v1.0 — production-ready for Java, JavaScript/TypeScript, and Python codebases
 
 Not a coding assistant — a **code evolution control system**
 
diff --git a/TODOS.md b/TODOS.md
index 39c449e..4059163 100644
--- a/TODOS.md
+++ b/TODOS.md
@@ -41,20 +41,21 @@
 - **ViewServer API removed with archon-viz.** The CI examples TODO (#11 GitHub Action) remains relevant.
 - **Remaining gap:** TROUBLESHOOTING.md with common issues (JDK 1.8 on PATH, Spring DI requires compiled classes, diff lock file recovery).
 
-## 10. DiffCommand `--json` flag
+## ~~10. DiffCommand `--json` flag~~ — DONE (superseded)
 - **What:** Add a simpler `--json` flag alongside `--format agent` for lean diff output (just added/removed/changed edges without full graph metadata).
-- **Status:** LOW PRIORITY — `--format agent` in v0.7.0.0 covers the AI integration use case. A leaner JSON format would be nice-to-have for CI scripting.
-- **Context:** The Claude Code skill uses `--format agent` which works well. A simpler format would reduce output size for CI pipelines.
+- **Status:** DONE — superseded. `--format agent` covers the AI integration use case. A richer JSON format with structured diff output is planned for post-1.0.
+- **Context:** The Claude Code skill uses `--format agent` which works well. CEO review (2026-04-16) confirmed this is sufficient for v1.0.
 
 ## 11. GitHub Action for archon diff on PRs
 - **What:** Build a GitHub Action that runs `archon diff` on every pull request and posts the impact report as a PR comment.
 - **Why:** Zero-friction adoption — dependency analysis becomes part of code review automatically.
-- **Status:** DEFERRED — After dogfooding the Claude Code skill.
+- **Status:** DEFERRED to post-1.0 — Outside voice review (2026-04-16) found 12 issues including critical CI compatibility problems.
 - **Pros:** Automatic on every PR; team visibility
 - **Cons:** Docker packaging needed; CI/CD setup; may be slow for large repos
+- **Known issues for future implementation:** DiffCommand `--format agent` outputs TEXT not JSON (needs `--format json`). archon-core uses Jackson not Gson. JS/TS stash+checkout breaks in CI (node_modules disappears). Composite bash action may be simpler than TypeScript. `--ci` flag already exists. Fork PRs need `pull_request_target` or `workflow_run` trigger. Release workflow needed to publish shadow JAR. Checks API annotations require `checks:write` permission.
 
 ## 12. Community Setup (CONTRIBUTING.md + Issue Templates)
 - **What:** Create CONTRIBUTING.md with development setup, add GitHub issue templates (bug report, feature request), enable GitHub Discussions.
-- **Status:** DEFERRED — Low priority until open-source launch.
+- **Status:** PARTIALLY DONE — CI/CD workflows exist (build.yml, release.yml). CONTRIBUTING.md and issue templates still needed.
 - **Pros:** Attracts contributors; professional project appearance.
 - **Cons:** Community management overhead.
diff --git a/VERSION b/VERSION
index c943bc4..3eefcb9 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.7.2.1
+1.0.0
diff --git a/archon-cli/src/main/java/com/archon/cli/ArchonCli.java b/archon-cli/src/main/java/com/archon/cli/ArchonCli.java
index a8e88bf..f693526 100644
--- a/archon-cli/src/main/java/com/archon/cli/ArchonCli.java
+++ b/archon-cli/src/main/java/com/archon/cli/ArchonCli.java
@@ -11,7 +11,7 @@
         DiffCommand.class
     },
     mixinStandardHelpOptions = true,
-    version = "0.7.1.0"
+    version = "1.0.0"
 )
 public class ArchonCli implements Runnable {
     @Override
diff --git a/build.gradle.kts b/build.gradle.kts
index 183e8f0..5e5a926 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -4,7 +4,7 @@ plugins {
 
 allprojects {
     group = "com.archon"
-    version = "0.1.0"
+    version = "1.0.0"
 
     repositories {
         mavenCentral()