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.mdindex 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.