Create agent structure template and creation guide

[alirezarezvani]

Summary

Standardize agent creation process with template and comprehensive documentation.

Context

This is Phase 2.4 of the Skill-Agent Integration implementation plan. This template and guide ensure consistency across all future agent development.

Reference: documentation/implementation/implementation-plan-november-2025.md (Phase 2.4)

Tasks

Agent Template

• Create templates/agent-template.md with complete structure
• Include YAML frontmatter structure with all required fields:
  • name (cs-* prefix)
  • description (clear, concise)
  • skills (reference to skill folder)
  • domain (marketing, c-level, product, etc.)
  • model (sonnet, opus, haiku)
  • tools (Read, Write, Bash, Grep, Glob)
• Document required sections:
  • Purpose (what the agent does)
  • Skill Integration (relative paths, tool examples)
  • Workflows (step-by-step processes)
  • Integration Examples (concrete code examples)
  • Success Metrics (how to measure effectiveness)
  • Related Agents (cross-references)
  • References (documentation links)
• Add placeholder content for each section
• Include comments explaining each section's purpose

Agent Creation Guide

• Create documentation/AGENT_CREATION_GUIDE.md
• Document step-by-step agent creation process:
  1. Choose domain and define agent purpose
  2. Copy agent-template.md to appropriate directory
  3. Fill YAML frontmatter
  4. Identify skill integration points
  5. Document Python tool invocations
  6. Map workflows to existing skills
  7. Add integration examples
  8. Test relative path resolution
  9. Validate YAML and markdown
  10. Submit for review
• Document naming conventions (cs-* prefix, kebab-case)
• Explain relative path resolution (../../ patterns)
• Provide testing checklist
• Add integration validation steps
• Include examples from cs-content-creator
• Document common pitfalls and solutions

Success Criteria

• Template covers all required agent sections
• Creation guide is actionable (developers can create new agents independently)
• Examples from cs-content-creator are referenced
• Template passes validation (YAML, markdown linting)
• Guide includes troubleshooting section
• Template is ready for future agent expansion

Dependencies

• Depends on: Issues Create marketing agents (cs-content-creator, cs-demand-gen-specialist) #11, Create C-level advisory agents (cs-ceo-advisor, cs-cto-advisor) #12, Create product management agent (cs-product-manager) #13 (reference existing agents as examples)

Related

• Milestone: Skill-Agent Integration v1.0
• Phase: 2.4 (Day 4)
• Estimated time: 2 hours
• Next: Issue Update project documentation (README, INSTALL, USAGE, CLAUDE) #15 - Documentation updates

[alirezarezvani]

✅ Agent template and creation guide complete!

Template Delivered:

• templates/agent-template.md (318 lines) - Comprehensive template for creating new cs-* agents

Features:

• Complete YAML frontmatter structure with instructions
• All required markdown sections documented
• Workflow documentation patterns
• Integration examples pattern
• Success metrics framework
• Explanatory comments throughout
• References to all 5 completed agents as examples

Quality Standards Met:
✅ Complete structure matching existing agents
✅ Detailed instructions for each section
✅ Code examples and bash script patterns
✅ Cross-references to agents/CLAUDE.md guide
✅ Ready for immediate use by future developers

Commit: 005e64c
Sprint: sprint-11-05-2025 (Day 4 complete)
Next: Days 5-6 (Documentation & Testing)