Whole Knowledge Architecture Editor

Critical Rules

🚨 MANDATORY: Read Before Edit

ALWAYS use Read tool on Whole.md BEFORE any Edit operation. Claude Code requires this. If you get "File has not been read yet" error:

1. Immediately run: Read /home/user/Whole/Whole.md offset=X limit=Y
2. Retry the Edit with exact old_string from Read output

Core Principles

1. Only Add, Never Subtract - Never delete without explicit approval
2. Bilingual Format - Always use #### **[num]. English - Tiếng Việt**
3. 4-Point Structure - Definition, Context, Application, Integration (minimum 4, can have more)
4. Cross-Reference Integrity - Bidirectional links required

Integration with Agents

When to Invoke Agents

Use Task tool to invoke specialized agents for complex editing tasks:

// For complex translation requiring cultural adaptation
Task(subagent_type: 'whole-translator',
     prompt: 'Translate and culturally adapt concept [name] in CF[N]')

// For structure validation during editing
Task(subagent_type: 'whole-content-validator',
     prompt: 'Validate structure and compliance for new content in CF[N]')

// For cross-reference management and updates
Task(subagent_type: 'whole-cross-reference',
     prompt: 'Update cross-references after adding concepts to CF[N]')

// For terminology consistency audit
Task(subagent_type: 'whole-translator',
     prompt: 'Review terminology consistency across CF[range]')

When NOT to Use Agents

• Simple word translations → Use references/bilingual-rules.md
• Format validation → Use scripts in scripts/ directory
• Basic structural changes → Use whole-editor directly
• Single cross-reference update → Update manually

Quick Reference

Format Requirements

• Headings: ## Concept Name | Tên Khái Niệm
• 4 sections per concept (all required)
• Cross-refs: Domain > Function > Concept

Editing Protocol

Load: references/editing-protocol.md

Duplicate Resolution

Load: references/duplicate-resolution.md

Bilingual Guidelines

Load: references/bilingual-rules.md

Structure Validation

Load: references/structure-validation.md

Agent Integration Guide

whole-translator

When to use: Complex translations requiring cultural adaptation Command: Task(subagent_type='whole-translator', prompt='Translate concept [name] in CF[N] with cultural context') Expected output: Culturally adapted translation with terminology glossary

whole-content-validator

When to use: Validate structure and format compliance during editing Command: Task(subagent_type='whole-content-validator', prompt='Validate new content in CF[N]') Expected output: Validation report with structure compliance check

whole-cross-reference

When to use: Manage bidirectional cross-references after edits Command: Task(subagent_type='whole-cross-reference', prompt='Update cross-references for CF[N]') Expected output: Cross-reference update report with bidirectional links verified

Workflow

1. Read: Load target section completely
2. Analyze: Check for gaps, duplicates, incomplete descriptions
3. Propose: Present changes with rationale
4. Apply: After approval, implement with cross-ref updates
5. Verify: Confirm all changes maintain structure integrity

Critical Rules

✅ MUST

• Read file before any Edit operation (Claude Code requirement)
• Use agents for complex tasks (translation, validation, cross-refs)
• Maintain 4-point structure minimum (can have more)
• Preserve bilingual format (#### **[num]. English - Tiếng Việt**)
• Update cross-references bidirectionally
• Use shared utilities from .claude/skills/shared
• Get approval before deleting content

❌ NEVER

• Edit without Reading first
• Delete content without explicit approval
• Break cross-references or skip bidirectional updates
• Skip 4-point structure
• Translate literally without cultural context
• Change structure without impact analysis
• Use agents for simple tasks (prefer scripts and references)