Feature Request: command for getting claude to write robust developer guides specific to your project and preferences

[kennyjpowers]

e.g. frontend developer guide

[doriancollier]

Developer Guide Management System for Claudflow

I created an agent and commands to manage my guides. Right now they're in a specific project of mine. I'll submit a PR to Claudeflow later this week if they prove helpful.

Purpose

The system helps teams:

• Automatically generate and maintain developer guides from codebase analysis
• Keep documentation concise (<1000 lines per guide) and free of redundancy
• Ensure cross-references between guides, CLAUDE.md, and agent files stay valid
• Audit documentation against actual code implementations

The Agent: developer-guide-maintainer

.claude/agents/documentation/developer-guide-maintainer.md

A specialized subagent focused on documentation quality with these responsibilities:

• Conciseness - Target <1000 lines per guide, using tables and consolidated examples
• Redundancy elimination - No duplicate content across guides or CLAUDE.md
• Cross-reference integrity - Validate all internal links work
• Index synchronization - Keep README.md and Cursor .mdc files in sync
• Research capabilities - Uses WebSearch and Context7 MCP to verify code examples against
  current library docs

Commands

/guides:init [optional: focus area]
Analyzes your codebase to create a full set of developer guides. Runs parallel agents to
discover tech stack, architecture patterns, and business features, then generates guides
with proper cross-references.

/guides:create [topic or file pattern]
Creates or updates a specific guide from code analysis. Can target a topic
("SecurityContext patterns") or file pattern ("src/layers/entities/*").

/guides:update [instruction or guide-name]
Runs health assessment (size compliance, broken links, redundancy) and applies fixes.
Supports modes: all, specific guide name, based on recent work, or custom instructions
like fix broken links.

/guides:delete
Deletes a guide and cleans up all references in README.md, CLAUDE.md, other guides,
Cursor .mdc, and agent files. Supports --dry-run for preview.

/guides:audit [guide-name or 'all']
Compares documentation against actual implementations. Reports outdated docs,
undocumented code patterns, and CLAUDE.md alignment issues with an alignment score.

/guides:enrich-agents [agent-name, directory, or 'all']
Reviews agent files and adds "Project-Specific Context" sections with relevant guide
references. Idempotent—can be run multiple times to update existing sections.