Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(charts): colocate planning records (#5780)

Cindy Zhang377296d7253b
diff --git a/packages/charts/README.md b/packages/charts/README.md
index 2325ed0799..26cb01eb49 100644
--- a/packages/charts/README.md
+++ b/packages/charts/README.md
@@ -25,8 +25,8 @@ It ships to npm **only under the `@canary` dist-tag** — there is never a stabl
## Status
Under active development. The config-model chart and its marks/chrome are in place;
-API and visuals are still being refined. See the repo-root `CHARTV2_*` docs for the
-plan, design research, and verification checklist.
+API and visuals are still being refined. See [`docs/`](./docs/) for the plan, design research, readiness audit, and
+verification checklist.
## Usage
diff --git a/docs/CHARTV2_PHASE1_PLAN.md b/packages/charts/docs/CHARTV2_PHASE1_PLAN.md
similarity index 100%
rename from docs/CHARTV2_PHASE1_PLAN.md
rename to packages/charts/docs/CHARTV2_PHASE1_PLAN.md
diff --git a/docs/CHARTV2_READINESS.md b/packages/charts/docs/CHARTV2_READINESS.md
similarity index 100%
rename from docs/CHARTV2_READINESS.md
rename to packages/charts/docs/CHARTV2_READINESS.md
diff --git a/docs/CHARTV2_STAGE1_DESIGN.md b/packages/charts/docs/CHARTV2_STAGE1_DESIGN.md
similarity index 100%
rename from docs/CHARTV2_STAGE1_DESIGN.md
rename to packages/charts/docs/CHARTV2_STAGE1_DESIGN.md
diff --git a/docs/CHARTV2_VERIFICATION_CHECKLIST.md b/packages/charts/docs/CHARTV2_VERIFICATION_CHECKLIST.md
similarity index 100%
rename from docs/CHARTV2_VERIFICATION_CHECKLIST.md
rename to packages/charts/docs/CHARTV2_VERIFICATION_CHECKLIST.md
diff --git a/packages/charts/docs/README.md b/packages/charts/docs/README.md
new file mode 100644
index 0000000000..ec7a4050ec
--- /dev/null
+++ b/packages/charts/docs/README.md
@@ -0,0 +1,13 @@
+# Charts planning and verification
+
+These package-local records track the canary-only Charts package while its API,
+visuals, and verification mature:
+
+- [`CHARTV2_PHASE1_PLAN.md`](./CHARTV2_PHASE1_PLAN.md): implementation sequence and evidence.
+- [`CHARTV2_STAGE1_DESIGN.md`](./CHARTV2_STAGE1_DESIGN.md): API and correctness research.
+- [`CHARTV2_READINESS.md`](./CHARTV2_READINESS.md): launch-readiness snapshot.
+- [`CHARTV2_VERIFICATION_CHECKLIST.md`](./CHARTV2_VERIFICATION_CHECKLIST.md): verification matrix.
+
+The historical `ChartV2` name remains in these filenames because the records
+predate extraction into `@astryxdesign/charts`. Current consumer guidance lives
+in the package [`README`](../README.md) and `.doc.mjs` files.