banatie-content/style-guides/AUTHORS.md

4.4 KiB

Content Authors Registry

This document is the central registry of all author personas for Banatie content.

Used by: @strategist (author selection), all other agents (reference) Template: style-guides/TEMPLATE.md


Active Authors

henry

Field Value
File style-guides/henry-technical.md
Name Henry Mitchell
Role Senior Developer
Affiliation independent
Primary Platform dev.to
Avatar assets/avatars/henry.png (pending)
Status Active

Topics: Tutorials, deep dives, API integration, Banatie product guides Voice: Direct, pragmatic, code-heavy, experience-based Real person: Oleg


nina

Field Value
File style-guides/nina-creative.md (pending)
Name Nina Novak
Role Creative Technologist
Affiliation community
Primary Platform TBD
Avatar assets/avatars/nina.png (pending)
Status Needs creation

Topics: AI art, design workflows, creative tools, productivity Voice: Engaging, visual, inspiring, accessible Real person: Ekaterina


Author Selection Quick Reference

Content Type Primary Notes
Tutorial (code-heavy) henry Step-by-step implementation
API integration guide henry Technical walkthrough
Product guide (Banatie) henry Banatie-specific tutorials
Technical comparison henry X vs Y with code
Deep dive (how it works) henry Architecture, internals
Debugging story henry Problem → solution
AI art / image creativity nina Creative exploration
Design workflow nina Tools for designers
Creative tools review nina Non-technical perspective
Lifestyle / productivity nina Work-life, habits

Style Guide Requirements

Every author style guide MUST contain these sections:

  1. Identity — name, handle, role, location
  2. Affiliation — relationship to Banatie, disclosure, bio line
  3. Avatar — file path, description, style
  4. Social Profiles — primary platform, all profiles
  5. Publishing Channels — primary, secondary, format preferences
  6. Background — professional journey, credibility
  7. Expertise — primary/secondary topics, what they cover/avoid
  8. Voice & Tone — overall voice, traits, formality
  9. Writing Patterns — openings, structure, technical explanations, closings
  10. Language Patterns — phrases used/avoided, humor, emoji
  11. Sample Passages — introduction, technical, closing examples
  12. Do's and Don'ts — specific guidance
  13. Content Fit — best for, not ideal for

See TEMPLATE.md for full structure.


Affiliation Types

Type Description Disclosure
employee Works at Banatie Full disclosure in bio
contractor Paid contributor "Contributing writer"
community Active user who writes "Banatie user"
independent No formal relationship No disclosure needed

Adding New Authors

Via @style-guide-creator:

  1. Start session with @style-guide-creator
  2. /init to see current authors
  3. Describe new author needs
  4. Agent creates complete style guide
  5. Agent updates this registry
  6. Create avatar (separate task)

Manual process:

  1. Copy TEMPLATE.md to {author-handle}.md
  2. Fill all sections
  3. Add entry to this file
  4. Create avatar in assets/avatars/

Author Personas vs Real Identities

Authors are personas, not direct representations:

  • Henry represents Oleg's technical expertise but writes as "Henry Mitchell"
  • Nina represents Ekaterina's creative perspective but writes as "Nina Novak"

Articles are published under persona names. This allows:

  • Consistent voice even if real person's style evolves
  • Clear brand identity per content type
  • Potential for multiple personas per real person

Style Guide Health Check

Author File Avatar Socials Channels Full Guide Status
henry Partial Needs update
nina Needs creation

TODO:

  • Update henry-technical.md with new sections (affiliation, avatar, socials, channels)
  • Create nina-creative.md
  • Generate avatars

Last updated: 2024-12-27 Maintained by: @style-guide-creator