/sync-knowledge

Orchestrator for knowledge synchronization with source code changes.

Progress Checklist

- [ ] Step 1: Validate knowledge state
- [ ] Step 2: Detect source changes
- [ ] Step 3: Report changes
- [ ] Step 4: Update knowledge (interactive)
- [ ] Step 5: Rebuild index
- [ ] Step 6: Report

Steps

1. •

   Validate knowledge state:

   • •Check $STATE_DIR exists
   • •If not exists → Error: ".knowledge-state not found. Run /collect-knowledge first.", END
2. •

   Detect source changes:

   • •For each state file in $STATE_DIR:
     • •Read .knowledge-state/{category}/{id}.json
     • •Execute: git diff --name-status {commit}..HEAD
     • •Compare refs with changed files
     • •Classify: high (D:deleted) / medium (M,R:modified/renamed) / low (unchanged)
   • •Build CHANGES list
3. •

   Report changes:

   • •Display summary:
     • •High impact: files requiring immediate knowledge update
     • •Medium impact: files potentially needing review
     • •Low impact: no action needed
4. •

   Update knowledge (interactive):

   • •For each high/medium impact item:
     • •AskUserQuestion: "Update this knowledge? [Y/n]"
     • •If Y:
       • •Read source changes
       • •Generate updated content
       • •Get current commit: git rev-parse HEAD
       • •Invoke knowledge-writer:
         code

         OPERATION=update
         CATEGORY=$CATEGORY
         ID=$ID
         CONTENT=$UPDATED_CONTENT
         COMMIT_HASH=$COMMIT_HASH
         

5. •

   Rebuild index:

   • •Invoke knowledge-writer: OPERATION=rebuild-index
6. •

   Report:

   • •Display summary: knowledge files updated, new commit hash recorded
   • •END