From e73d4ad7960bc58b9370d61337e30a3a679c2ed1 Mon Sep 17 00:00:00 2001
From: HiranoMasaaki <lambda.groove@gmail.com>
Date: Sat, 3 Jan 2026 05:22:36 +0000
Subject: [PATCH] fix(create-expert): sync AGENTS.md template with actual
 architecture
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update the PBT framework architecture diagram to match implementation:

Before (incorrect):
- happy-path-manager, unhappy-path-manager, adversarial-manager
- expert-designer (non-existent)

After (correct):
- ecosystem-builder
- integration-manager → functional-manager, usability-manager
- expert-tester

Also removes references to non-existent `think` tool from examples.

Closes #351

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .changeset/sync-agents-md-architecture.md     | 12 +++++++++
 .../src/lib/agents-md-template.ts             | 25 ++++++++-----------
 2 files changed, 23 insertions(+), 14 deletions(-)
 create mode 100644 .changeset/sync-agents-md-architecture.md

diff --git a/.changeset/sync-agents-md-architecture.md b/.changeset/sync-agents-md-architecture.md
new file mode 100644
index 00000000..da6220d2
--- /dev/null
+++ b/.changeset/sync-agents-md-architecture.md
@@ -0,0 +1,12 @@
+---
+"create-expert": patch
+---
+
+Sync AGENTS.md template with actual PBT framework architecture
+
+The architecture diagram now correctly reflects the implementation:
+- Replaced non-existent experts (happy-path-manager, unhappy-path-manager,
+  adversarial-manager, expert-designer) with actual implementation
+- Added ecosystem-builder, integration-manager, functional-manager,
+  usability-manager
+- Removed references to non-existent `think` tool from examples
diff --git a/apps/create-expert/src/lib/agents-md-template.ts b/apps/create-expert/src/lib/agents-md-template.ts
index 5f4ff08d..bc252186 100644
--- a/apps/create-expert/src/lib/agents-md-template.ts
+++ b/apps/create-expert/src/lib/agents-md-template.ts
@@ -36,16 +36,13 @@ This project uses a Property-Based Testing (PBT) approach to create high-quality
 
 \`\`\`
 create-expert (Coordinator)
-├── property-extractor      → Extracts success criteria
-├── happy-path-manager      → Stage 1: Normal operation testing
-│   ├── expert-designer     → Creates/improves Expert definitions
-│   └── expert-tester       → Runs tests and evaluates results
-├── unhappy-path-manager    → Stage 2: Error handling testing
-│   ├── expert-designer
-│   └── expert-tester
-├── adversarial-manager     → Stage 3: Security testing
-│   ├── expert-designer
-│   └── expert-tester
+├── property-extractor      → Extracts testable properties from requirements
+├── ecosystem-builder       → Creates Expert ecosystem (main + demo + setup + doctor)
+├── integration-manager     → Orchestrates functional and usability testing
+│   ├── functional-manager  → Runs happy-path, unhappy-path, adversarial tests
+│   │   └── expert-tester   → Executes tests and reports results
+│   └── usability-manager   → Runs demo, setup, doctor, error guidance tests
+│       └── expert-tester   → Executes tests and reports results
 └── report-generator        → Final property achievement report
 \`\`\`
 
@@ -123,7 +120,7 @@ Detailed instructions for the expert.
 type = "mcpStdioSkill"
 command = "npx"
 packageName = "@perstack/base"
-pick = ["readTextFile", "think", "attemptCompletion"]
+pick = ["readTextFile", "attemptCompletion"]
 \`\`\`
 
 ## Best Practices for Creating Experts
@@ -175,7 +172,7 @@ Always use \`pick\` to limit tools:
 type = "mcpStdioSkill"
 command = "npx"
 packageName = "@perstack/base"
-pick = ["readTextFile", "think", "attemptCompletion"]  # Only what's needed
+pick = ["readTextFile", "attemptCompletion"]  # Only what's needed
 \`\`\`
 
 ### 4. Let Them Collaborate
@@ -276,14 +273,14 @@ endpoint = "https://api.example.com/mcp"
 \`@perstack/base\` provides essential tools:
 - File operations: \`readTextFile\`, \`writeTextFile\`, \`editTextFile\`, etc.
 - Shell execution: \`exec\`
-- Control flow: \`attemptCompletion\`, \`think\`, \`todo\`
+- Control flow: \`attemptCompletion\`, \`todo\`
 
 \`\`\`toml
 [experts."my-expert".skills."@perstack/base"]
 type = "mcpStdioSkill"
 command = "npx"
 packageName = "@perstack/base"
-pick = ["readTextFile", "writeTextFile", "think", "attemptCompletion"]
+pick = ["readTextFile", "writeTextFile", "attemptCompletion"]
 \`\`\`
 
 ## Testing Experts