Skip to content

Open-source SEO, GEO, and marketing skills for AI agents.

docs: add surgical engineering standard (#75)

Tong Chenb5bf765fd43d
diff --git a/CLAUDE.md b/CLAUDE.md
index 88e15337..de40de5b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,6 +4,18 @@
Toprank is a host-agnostic plugin providing SEO, Google Ads, and Meta Ads skills for AI coding agents. It is distributed via the `nowork-studio` Claude Code marketplace and via direct agent install on OpenClaw, Codex, and Hermes. Every change here is user-facing.
+## Engineering Execution Standard
+
+**Surgical, verified, minimum-change engineering.** Make the smallest scoped change that solves the real problem, verify it, and do not disturb anything else.
+
+- **Understand before changing.** Inspect the relevant code, current state, and failure mode before editing.
+- **State material assumptions.** If ambiguity changes the implementation, risk, or user-visible behavior, clarify before acting.
+- **Prefer the smallest correct change.** No speculative features, premature abstractions, or unrelated "while I'm here" refactors.
+- **Scope cleanup tightly.** Match existing style. Clean up only mess introduced by the change. Mention unrelated issues; do not silently fix them.
+- **Make success verifiable.** For bugs, reproduce when practical. For features, define expected behavior. Run the narrowest meaningful validation, then broader checks if risk warrants.
+- **Protect high-risk boundaries.** Before destructive, public, production, billing, credential, or communication side effects: verify actor, target, scope, approval, blast radius, and resulting state.
+- **Leave the system easier to operate.** If the workflow recurs or the bug pattern is reusable, encode it as a test, guardrail, skill, or automation.
+
## Agent entry points (single sources of truth)
- **`AGENTS.md`** — the universal skill resolver. Every host reads this to route user intents to the right skill. Update it whenever a skill is added, removed, or its purpose changes.