Fixes#1550
This PR addresses the documentation chaos reported in issue #1550 by:
1. Creating a comprehensive Claude Code setup guide at apps/docs/integrations/claude-code.mdx that:
- Clearly explains all 3 integration options (MCP Server, Plugin, Provider)
- Includes a comparison table to help users choose the right option
- Clarifies the naming confusion between task-master-ai (MCP package) and task-master (CLI)
- Provides comprehensive troubleshooting for common issues
2. Simplifying README.md:
- Consolidated duplicate Claude Code installation sections
- Added prominent links to the comprehensive guide
- Reduced confusion by pointing to single source of truth
3. Updating documentation navigation:
- Added new 'Integrations' section to docs.json
- Made Claude Code guide easily discoverable
4. Deprecating redundant documentation:
- Added deprecation notices to docs/claude-code-integration.md
- Added deprecation notices to docs/examples/claude-code-usage.md
- Both files now point to the new consolidated guide
5. Adding context to existing files:
- Explained CLAUDE.md auto-load purpose
- Clarified CLAUDE_CODE_PLUGIN.md is for plugin users
- Added setup guide link to TM_COMMANDS_GUIDE.md
This creates a single landing page (docs.task-master.dev/integrations/claude-code)
that new users can reference, eliminating the confusion from multiple
installation methods scattered across 5+ different files.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Ralph Khreish <Crunchyman-ralph@users.noreply.github.com>
* docs: Clarify Claude Code .claude configuration behavior and recommend .md for PRDs
This addresses two documentation improvements:
1. **Claude Code Configuration Behavior (#1180)**
- Added comprehensive section explaining how Task Master interacts with Claude Code's .claude configuration
- Clarified that Task Master only passes MCP config when claudeCode.mcpServers is configured
- Documented precedence: explicit Task Master config vs Claude CLI defaults
- Provided practical examples for different configuration scenarios
- Added recommendations for deterministic vs. existing-setup workflows
2. **PRD File Extension Recommendation**
- Updated all examples to use .md extension instead of .txt for PRD files
- Added prominent note explaining benefits of .md: syntax highlighting, proper rendering, better collaboration
- Updated directory structure diagrams and workflow examples
- Clarified that both extensions work, but .md is recommended for editor support
Files modified:
- docs/examples/claude-code-usage.md: Added "Claude Code Configuration Behavior" section
- assets/AGENTS.md: Updated all PRD references to use .md, added PRD format note
Resolves: eyaltoledano/claude-task-master#1180
* chore: Add changeset and require changesets for PRs
- Added changeset for documentation updates (patch)
- Updated CLAUDE.md to require changesets for all PRs
* docs: Simplify PR to only recommend .md extension for PRDs
Based on feedback from @ben-vargas:
**Removed:**
- Changeset file (not needed for docs-only PR)
- Claude Code `.claude` configuration behavior documentation (will become stale when upgrading to ai-sdk-provider-claude-code v2.0.0+ which uses @anthropic-ai/claude-agent-sdk)
**Updated:**
- CLAUDE.md changeset guidelines: clarified changesets are only needed for code changes, not docs-only PRs
**Kept:**
- PRD file format recommendation: Updated all examples to use `.md` extension instead of `.txt` for better editor support, syntax highlighting, and rendering
- Added note explaining benefits of `.md` format
This keeps the PR focused on the non-controversial PRD format improvement and avoids documenting behavior that will soon change.
Addresses feedback in: #1180
* docs: Update apps/docs to recommend .md extension for PRD files
Applied the same PRD format recommendations to the user-facing documentation site:
- apps/docs/getting-started/quick-start/prd-quick.mdx:
- Updated template references from .txt to .md
- Added explanation of .md benefits in note box
- Updated all command examples to use .md extension
- Updated file naming examples
- apps/docs/capabilities/rpg-method.mdx:
- Updated RPG template reference to .md
- Updated standard template reference to .md
- Updated parse-prd command examples
- Updated workflow examples
Addresses @Crunchyman-ralph's request to update apps/docs
* refactor: Rename PRD template files from .txt to .md extension
Renamed actual template files to match documentation updates:
- .taskmaster/templates/example_prd.txt → example_prd.md
- .taskmaster/templates/example_prd_rpg.txt → example_prd_rpg.md
This ensures the actual files match what we're recommending in the documentation.
---------
Co-authored-by: Ben Coombs <bjcoombs@users.noreply.github.com>
* feat: Add Kiro hooks and configuration for Taskmaster integration
- Introduced multiple Kiro hooks to automate task management workflows, including:
- Code Change Task Tracker
- Complexity Analyzer
- Daily Standup Assistant
- Git Commit Task Linker
- Import Cleanup on Delete
- New File Boilerplate
- PR Readiness Checker
- Task Dependency Auto-Progression
- Test Success Task Completer
- Added .mcp.json configuration for Taskmaster AI integration.
- Updated development workflow documentation to reflect new hook-driven processes and best practices.
This commit enhances the automation capabilities of Taskmaster, streamlining task management and improving developer efficiency.
* chore: run format
* chore: improve unit tests on kiro rules
* chore: run format
* chore: run format
* feat: improve PR and add changeset
