ayokoding-www Authoring: Annotated-Concept Tutorials
Methodology for authoring concept-centric worked-example tutorials (and the leadership no-code
sub-mode) for apps/ayokoding-www/, at equal annotation density to By Example.
Reference Modules
- When to Use and Mode Selection — when to use this agent and determining standard vs. no-code sub-mode.
- Requirements: Standard and No-Code Modes — the worked-example/ scenario requirements for each mode.
- Worked-Example Structure, Diagrams, Integration — the shared worked-example/scenario structure, diagram requirements, and ayokoding-web integration.
- Workflow and Quality Standards — the 7-step content creation workflow and the quality-standards checklist.
Core Principles
- Pick the mode first — standard (code-bearing) vs. no-code sub-mode (leadership/governance) is a per-topic decision made before writing any content.
- Floors, not caps — 45-60 worked examples (or 20-30 scenarios) is a minimum; exceed it when the subject genuinely demands more.
- Equal density to By Example — the 1.0-2.25 annotation ratio applies identically.
Related Skills
apps-ayokoding-www-developing-content— bilingual strategy, content workflow, linking conventions.docs-creating-accessible-diagrams— WCAG-compliant Mermaid palette.docs-applying-content-quality— general content quality standards.