cdd-doc-update Command Template

You are updating project documentation based on completed CDD decisions.

Your Task

Synchronize documentation with decisions that have implementationStatus: DONE but docSyncStatus: NOT_SYNCED.

Process

1. Find Decisions Needing Documentation Sync

Use Bash tool to find all cdd.md files with:

• implementationStatus: DONE
• docSyncStatus: NOT_SYNCED

cdd status --detailed --implementation DONE

Then use Read tool to check each file's docSyncStatus field.

Important: Only process files that have the docSyncStatus field. Old files without this field should be ignored.

2. Read Each Decision and Extract Context

For each decision requiring sync:

1. Read the full cdd.md file
2. Understand what was implemented:

- Goal: What problem was solved - Selection: What approach was taken - Context: Important constraints and background

1. Extract the decision ID and title
2. Extract gathered_context from Context section

3. Identify Documents to Update

Primary source: gathered_context in Context section

If the cdd.md has gathered_context:

gathered_context:
  - path: docs/architecture/overview.md
    summary: ...
    relevance_to_task: |
      CLIコマンド追加時は「ソースコード構造」セクションを参照。
      実装完了後にdocs/architecture/overview.mdの更新が必要。

Use these paths as the guide for what to update. The relevancetotask often indicates:

• Which sections need updating
• Why the document was referenced
• What changes might be needed

If gathered_context is missing: Fall back to common documentation targets:

• README.md: User-facing features and usage
• docs/architecture/overview.md: System architecture and design decisions
• docs/guidelines/development.md: Developer workflows and practices
• CHANGELOG.md: Version history and notable changes

4. Update Referenced Documents

For each document in gathered_context (or fallback list):

1. Read the document to understand current content
2. Identify the relevant section based on relevancetotask hints
3. Add or update content to reflect the implementation
4. Preserve existing content - never remove unrelated documentation

Guidelines:

1. Find the right section: Use relevancetotask hints or Grep to locate where this information belongs
2. Add new information: Write about what was implemented and why
3. Preserve existing content: Never remove unrelated documentation
4. Use clear formatting: Headers, lists, code blocks as appropriate
5. Link to cdd.md: Reference the decision file for details

Example Update:

## New Export Command (#EXPORT-001)

Added `cdd export` command for exporting decision data.

- Formats: JSON, CSV, Markdown
- Filters: by status, by date range
- Output: stdout or file

See [CDD/tasks/15-export-command.cdd.md](CDD/tasks/15-export-command.cdd.md) for decision rationale.

5. Update docSyncStatus

After successfully updating documentation:

1. Use Edit tool to change docSyncStatus: NOT_SYNCED to docSyncStatus: SYNCED
2. Only update this field - preserve all other frontmatter

6. Summary Report

After processing all decisions, report:

1. Decisions processed: List of IDs and titles
2. Documentation updated: Which files were modified (from gathered_context)
3. Sync status: Confirmation that docSyncStatus was updated

Important Rules

• Use gathered_context as guide: These are the documents that were explicitly referenced
• Never invent documentation: Only document what was actually implemented
• Verify implementation: Check that code/features exist before documenting
• Maintain accuracy: Documentation must match current reality
• Keep it concise: Focus on high-level understanding, not implementation details
• Link to cdd.md: Let decision files serve as detailed source of truth

File Editing Principles

When updating documentation:

1. Read the entire documentation file first

- Understand existing structure and sections - Identify where new information belongs

1. Preserve existing content

- Add new sections or paragraphs - Do not remove unrelated content - Example: Architecture doc has sections A, B, C - Adding section D → Result: A, B, C, D (NOT A, B, D)

1. Use appropriate formatting

- Match existing style and conventions - Use headers to organize information - Use lists for multiple items - Use code blocks for examples

1. Verify changes before finalizing

- Ensure no content was accidentally removed - Check that formatting is correct - Confirm links and references work

Integration with cdd-gather-context

The gathered_context in the Context section serves as your document update guide:

• path: The document to potentially update
• summary: What the document contains
• relevancetotask: Why it was referenced and what might need updating

This creates a traceable flow:

1. /cdd-gather-context identifies relevant documents
2. Main agent adds them to cdd.md Context
3. /cdd-review-decision verifies the references
4. /cdd-implement does the implementation
5. /cdd-review-implementation reviews the code
6. /cdd-doc-update updates the referenced documents ← You are here

Error Handling

If no decisions need sync:

• Report: "No decisions require documentation sync (all are SYNCED or lack docSyncStatus field)"
• Do not modify any files

If gathered_context is missing:

• Warn: "Decision lacks gathered_context in Context section. Using fallback document list."
• Proceed with common documentation targets

If documentation file doesn't exist:

• Ask user: "Documentation file X doesn't exist. Should I create it?"
• Wait for confirmation before creating

If uncertain where to document:

• Suggest options to user based on gathered_context hints
• Wait for guidance before proceeding

After Completion

Present summary:

1. Number of decisions synced
2. Documentation files updated (mapped to gathered_context paths)
3. List of decision IDs marked as SYNCED