diff --git a/QUICKSTART.md b/QUICKSTART.md
index 4a37540..6e32af5 100644
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -75,7 +75,7 @@ publish:
 
 ## GitHub Action Usage
 
-Add to `.github/workflows/maintenance.yml`:
+Add to `.github/workflows/groundkeeper.yml`:
 
 ```yaml
 name: Repository Maintenance
diff --git a/README.md b/README.md
index 2fca9da..fcd1fc8 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ npm install -g groundkeeper
 
 ### As a GitHub Action
 
-Add to your workflow file (e.g., `.github/workflows/maintenance.yml`):
+Add to your workflow file (e.g., `.github/workflows/groundkeeper.yml`):
 
 ```yaml
 name: Repository Maintenance
@@ -116,7 +116,7 @@ Options:
 
 ## Configuration
 
-The configuration file is validated against `packages/schemas/agent.schema.json`.
+The configuration file is validated against `packages/schemas/agent.schema.json`. Groundkeeper reads `.github/agent.yml` as the source of truth by default.
 
 ### Schema
 
@@ -190,7 +190,7 @@ cat .groundkeeper/report.md
 ### Run in CI/CD
 
 ```yaml
-# .github/workflows/maintenance.yml
+# .github/workflows/groundkeeper.yml
 name: Weekly Maintenance
 on:
   schedule: