Documentation Rules
All documentation in English. Root README concise, detailed docs in `/docs`.
What this skill does
# Documentation Standards **CRITICAL**: All documentation in English. Root README concise, detailed docs in `/docs`. ## Structure **Root-Level (ONLY):** - `README.md` - Overview + quick start - `CHANGELOG.md` - Version history - `AGENTS.md` - AI instructions - `LICENSE`, `CONTRIBUTING.md`, `SECURITY.md` **All Other Docs in `/docs`:** - `ARCHITECTURE.md`, `DEVELOPMENT.md`, `ROADMAP.md` - `specs/`, `guides/`, `diagrams/`, `benchmarks/` ## Update Requirements by Commit Type | Type | Update | |------|--------| | `feat` | README features, API docs, CHANGELOG "Added" | | `fix` | Troubleshooting, CHANGELOG "Fixed" | | `breaking` | CHANGELOG + migration guide, version docs | | `perf` | Benchmarks, CHANGELOG "Performance" | | `security` | SECURITY.md, CHANGELOG "Security" | | `docs` | Verify spelling/links only | | `refactor` | Update if behavior changed | ## Quality Checks (CI/CD) ```bash markdownlint **/*.md # Lint markdown markdown-link-check **/*.md # Check links codespell **/*.md # Spell check ``` **MUST pass before commit** (see AGENT_AUTOMATION).
Related in core
skillkit
IncludedToolkit for creating and validating skills and subagents. Use when: creating a new skill (fast or full mode), validating an existing skill, deciding Skills vs Subagents, migrating docs to skills, estimating token cost, or running a security scan. Triggers: "create skill", "build skill", "validate skill", "new subagent", "skills vs subagents", "estimate tokens", "security scan".
problem-solving
IncludedApply systematic problem-solving techniques for marketing challenges including campaign complexity (simplification cascades), creative blocks (collision-zone thinking), recurring campaign patterns (meta-pattern recognition), assumption constraints (inversion exercise), audience scale uncertainty (scale game), and dispatch when stuck. Techniques derived from proven problem-solving frameworks adapted for marketing execution.
seo-mastery
IncludedSearch engine optimization strategies and tactics for organic growth. Use when optimizing content for search, conducting keyword research, performing SEO audits, or building link strategies.
agent-workflow
IncludedUse when any Maestro command is invoked — provides foundational workflow design principles across prompt engineering, context management, tool orchestration, agent architecture, feedback loops, knowledge systems, and guardrails.
marketing-fundamentals
IncludedCore marketing concepts, psychology, and frameworks for effective marketing. Use for foundational knowledge on funnels, customer journey, positioning, value propositions, and marketing psychology.
email-marketing
IncludedEmail campaign strategy, automation, and optimization. Use when creating email sequences, improving deliverability, designing automation workflows, or optimizing email performance.