Files
Reza Rezvani 706da0250c docs(claude): refactor CLAUDE.md into modular documentation structure
- Refactor main CLAUDE.md from 491 to 164 lines (66% reduction)
- Create 9 domain-specific CLAUDE.md files for focused guidance:
  * agents/CLAUDE.md (347 lines) - Agent development guide
  * marketing-skill/CLAUDE.md (253 lines) - Marketing tools
  * product-team/CLAUDE.md (268 lines) - Product management tools
  * engineering-team/CLAUDE.md (291 lines) - Engineering tools
  * standards/CLAUDE.md (176 lines) - Standards usage
  * c-level-advisor/CLAUDE.md (143 lines) - Strategic advisory
  * project-management/CLAUDE.md (139 lines) - Atlassian integration
  * ra-qm-team/CLAUDE.md (153 lines) - RA/QM compliance
  * templates/CLAUDE.md (77 lines) - Template system
- Add navigation map in main CLAUDE.md for easy domain access
- Create PROGRESS.md for real-time sprint tracking
- Implement auto-documentation system for sprint progress

Benefits:
- Main CLAUDE.md now concise and navigable
- Domain-specific guidance easier to find
- No duplicate content across files
- Better organization for 42 skills across 6 domains

Total: 2,011 lines across 10 organized files vs 491 lines in 1 monolithic file

Sprint: sprint-11-05-2025
Issue: Part of documentation refactoring milestone
2025-11-05 12:44:03 +01:00

1.9 KiB

Templates - Claude Code Guidance

This guide explains the template system for agents, commands, and standardized workflows.

Template Purpose

Location: templates/

Purpose: Reusable templates for consistent agent development, slash command creation, and workflow automation across all domains.

Available Templates

Agent Templates

Location: templates/agent-template.md (when created)

Usage: Starting point for creating new cs-* agents

Contains:

  • YAML frontmatter structure
  • Required markdown sections
  • Workflow documentation format
  • Integration examples pattern

When to Use: Creating any new agent in agents/ directory

Command Templates

Location: templates/command-template.md (when created)

Usage: Creating new slash commands

Contains:

  • Command structure
  • Argument parsing patterns
  • Help documentation format

When to Use: Creating slash commands in commands/ directory

Workflow Templates

Location: templates/workflow-template.md (when created)

Usage: Documenting standard workflows across skills

Contains:

  • Step-by-step format
  • Expected outputs
  • Error handling patterns

Template Usage Pattern

# 1. Copy template
cp templates/agent-template.md agents/domain/cs-new-agent.md

# 2. Customize for your agent
vim agents/domain/cs-new-agent.md

# 3. Follow template structure exactly

# 4. Test relative paths and integrations

# 5. Commit with conventional commit
git commit -m "feat(agents): implement cs-new-agent from template"
  • Agent Development: ../agents/CLAUDE.md - Comprehensive agent creation guide
  • Standards: ../standards/CLAUDE.md - Quality and consistency standards
  • Main Documentation: ../CLAUDE.md - Repository overview

Last Updated: November 5, 2025 Purpose: Consistent templates for rapid agent and workflow development