diff --git a/.changeset/refactor-385-consolidate-duplicates.md b/.changeset/refactor-385-consolidate-duplicates.md
new file mode 100644
index 00000000..f8efeb31
--- /dev/null
+++ b/.changeset/refactor-385-consolidate-duplicates.md
@@ -0,0 +1,6 @@
+---
+"create-expert": patch
+---
+
+Consolidate duplicate property definitions with sync notes
+
diff --git a/apps/create-expert/src/lib/agents-md-template.ts b/apps/create-expert/src/lib/agents-md-template.ts
index 51dfb03a..766ceeba 100644
--- a/apps/create-expert/src/lib/agents-md-template.ts
+++ b/apps/create-expert/src/lib/agents-md-template.ts
@@ -80,6 +80,9 @@ See docs/making-experts/best-practices.md for public guidelines.
 - Uses \`attemptCompletion\`: Signals completion properly
 - Error handling: Graceful with helpful messages
 
+Note: These properties are also defined in create-expert-toml.ts.
+Keep both files synchronized when updating.
+
 ## CLI Reference
 
 ### Running Experts
diff --git a/apps/create-expert/src/lib/create-expert-toml.ts b/apps/create-expert/src/lib/create-expert-toml.ts
index c3a09533..ec95fc5e 100644
--- a/apps/create-expert/src/lib/create-expert-toml.ts
+++ b/apps/create-expert/src/lib/create-expert-toml.ts
@@ -55,6 +55,8 @@ Return a structured list of properties:
 These properties ensure experts follow Perstack best practices.
 See docs/making-experts/best-practices.md for the public guidelines.
 
+Note: Also defined in agents-md-template.ts - keep synchronized.
+
 **Security:**
 - Minimal tool access: Uses \`pick\` for only needed tools
 - Minimal environment: Uses \`requiredEnv\` for only needed variables