moai-cc-claude-md

CLAUDE.md is a living documentation standard that captures project workflows, code standards, architecture, and AI collaboration patterns. Start by creating a new markdown file at your project root with sections for Project Overview, Core Workflow, Code Standards (TRUST), Architecture, AI Collaboration Patterns, TAG traceability, and SPEC integration to guide team members and AI tools.

CLAUDE.md enforces a structured template covering Project Overview, Core Workflow, Code Standards (TRUST framework), Architecture, AI Collaboration Patterns, TAG traceability, and SPEC integration. This structure ensures consistent documentation of team standards, workflows, and collaboration patterns while maintaining traceability and living-document practices.

The AI Collaboration Patterns section in CLAUDE.md captures how your team works with AI tools—decision-making workflows, prompt patterns, code review standards, and integration points. This transforms tacit knowledge into explicit guidance that improves consistency and accelerates onboarding for both team members and AI assistants.

Yes, CLAUDE.md is designed as a living document that grows with your project. It integrates TAG traceability and SPEC linkage to keep documentation synchronized with code changes, enabling teams to update workflows, standards, and collaboration patterns as practices evolve without losing historical context.

CLAUDE.md includes a SPEC integration section that links your project guidance to formal specification documents. This bidirectional traceability ensures living documentation reflects actual requirements and design decisions, making it easier to validate that workflows and standards align with project specifications.

CLAUDE.md documents code standards using the TRUST framework within a dedicated section, making quality expectations explicit and discoverable. This shared reference reduces review friction, accelerates contributor onboarding, and provides AI tools with concrete context for code generation and analysis.